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.