Skip to main content

FixItFelix and Variant Calling

Pipeline VersionDate UpdatedDocumentation AuthorQuestions or Feedback
aou_9.0.1January, 2026WARP PipelinesFile an issue

Introduction to the FixItFelix and Variant Calling workflow​

FixItFelixAndVariantCall performs CMRG-focused read extraction/remapping and variant calling on corrected alignments. It subsets the input alignment to true/false-duplication intervals, remaps reads against a masked GRCh38 reference with FixItFelix, and calls variants in true-location intervals.

The workflow supports either standard VCF output or optional gVCF output (via generate_gvcf=true).

Quickstart table​

Pipeline FeatureDescriptionSource
Analysis typeCMRG remapping + variant calling
Workflow languageWDL 1.0openWDL
Genomic reference sequenceMasked GRCh38 (default inputs provided)
Data input file formatCRAM/BAM + reference + interval BEDs
Data output file formatVCF or gVCF (.vcf.gz / .g.vcf.gz) + index
Primary softwareGATK + FixItFelix + samtools + bwaGATK

Set-up​

FixItFelix and Variant Calling installation and requirements​

The workflow code can be downloaded by cloning the WARP GitHub repository. For the latest release, please see the FixItFelixAndVariantCall changelog.

The pipeline can be deployed using Cromwell, a GA4GH-compliant workflow management system.

Inputs​

Input descriptions​

Input variable nameDescriptionType
cram_fileInput alignment file (CRAM/BAM).File
cram_file_indexIndex for cram_file (.crai/.bai).File
original_ref_fastaReference fasta used for the original alignment.File
original_ref_fasta_indexFASTA index for original reference.File
original_ref_dictSequence dictionary for original reference.File
masked_ref_fastaMasked GRCh38 reference for FixItFelix remapping.File
masked_ref_fasta_indexFASTA index for masked reference.File
masked_ref_dictDictionary for masked reference.File
masked_ref_ambBWA index .amb for masked reference.File
masked_ref_annBWA index .ann for masked reference.File
masked_ref_bwtBWA index .bwt for masked reference.File
masked_ref_pacBWA index .pac for masked reference.File
masked_ref_saBWA index .sa for masked reference.File
true_locations_intervalsBED of true genomic locations used for final variant calling.File
false_duplications_intervalsBED of false-duplication locations.File
combined_true_false_intervalsBED combining true + false regions for read extraction/remapping.File
generate_gvcfEmit gVCF instead of VCF. Default: false.Boolean

FixItFelix and Variant Calling tasks and tools​

The workflow runs three tasks in sequence.

  1. Subset alignment to CMRG-relevant intervals
  2. Remap extracted reads with FixItFelix
  3. Call variants on corrected BAM
Task name and WDL linkToolSoftwareDescription
subset_cramGATK PrintReadsus.gcr.io/broad-gatk/gatk:4.4.0.0Subsets input alignment to combined true/false intervals and outputs BAM.
FixItFelixFixItFelixgcr.io/broad-dsde-methods/fixitfelix:1Extracts and remaps read pairs to masked GRCh38 reference.
call_variantsGATK HaplotypeCaller + SelectVariantsus.gcr.io/broad-gatk/gatk:4.4.0.0Calls variants in true-location intervals and optionally filters non-variant records for VCF mode.

1. Subset alignment to CMRG-relevant intervals​

subset_cram extracts reads overlapping combined_true_false_intervals to produce a smaller BAM for downstream remapping.

2. Remap extracted reads with FixItFelix​

FixItFelix remaps extracted read pairs against the masked reference and outputs coordinate-sorted/indexed BAM.

3. Call variants on corrected BAM​

call_variants runs HaplotypeCaller in DRAGEN mode over true-location intervals and emits either gVCF or filtered VCF.

Outputs​

Output variable nameFilename, if applicableOutput format and description
output_vcffiltered_<sample>.vcf.gz or <sample>.g.vcf.gzFinal called variants (VCF or gVCF depending on generate_gvcf).
output_vcf_indexfiltered_<sample>.vcf.gz.tbi or <sample>.g.vcf.gz.tbiTabix index for output_vcf.
output_pipeline_versionaou_9.0.1Workflow version string output.

Versioning​

All FixItFelixAndVariantCall releases are documented in the changelog.

Feedback​

Please help us make our tools better by filing an issue in WARP; we welcome pipeline-related suggestions or questions.