I am unable to use VQSR (recalibration) to filter variants

Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin
edited March 16 in Common Problems

The problem:

Our preferred method for filtering variants after the calling step is to use VQSR, a.k.a. recalibration. However, it requires well-curated training/truth resources, which are typically not available for organisms other than humans, and it also requires a large amount of variant sites to operate properly, so it is not suitable for some small-scale experiments such as targeted gene panels or exome studies with fewer than 30 exomes. For the latter, it is sometimes possible to pad your cohort with exomes from another study (especially for humans -- use 1000 Genomes or ExAC!) but again for non-human organisms it is often not possible to do this.

The solution: hard-filtering

So, if this is your case and you are sure that you cannot use VQSR, then you will need to use the VariantFiltration tool to hard-filter your variants. To do this, you will need to compose filter expressions using JEXL as explained here based on the generic filter recommendations detailed below. There is a tutorial that shows how to achieve this step by step. Be sure to also read the documentation explaining how to understand and improve upon the generic hard filtering recommendations.

But first, some caveats

Let's be painfully clear about this: there is no magic formula that will give you perfect results. Filtering variants manually, using thresholds on annotation values, is subject to all sorts of caveats. The appropriateness of both the annotations and the threshold values is very highly dependent on the specific callset, how it was called, what the data was like, what organism it belongs to, etc.

HOWEVER, because we want to help and people always say that something is better than nothing (not necessarily true, but let's go with that for now), we have formulated some generic recommendations that should at least provide a starting point for people to experiment with their data.

In case you didn't catch that bit in bold there, we're saying that you absolutely SHOULD NOT expect to run these commands and be done with your analysis. You absolutely SHOULD expect to have to evaluate your results critically and TRY AGAIN with some parameter adjustments until you find the settings that are right for your data.

In addition, please note that these recommendations are mainly designed for dealing with very small data sets (in terms of both number of samples or size of targeted regions). If you are not using VQSR because you do not have training/truth resources available for your organism, then you should expect to have to do even more tweaking on the filtering parameters.

Filtering recommendations

Here are some recommended arguments to use with VariantFiltration when ALL other options are unavailable to you. Be sure to read the documentation explaining how to understand and improve upon these recommendations.

Note that these JEXL expressions will tag as filtered any sites where the annotation value matches the expression. So if you use the expression QD < 2.0, any site with a QD lower than 2 will be tagged as failing that filter.

For SNPs:

  • QD < 2.0
  • MQ < 40.0
  • FS > 60.0
  • SOR > 4.0
  • MQRankSum < -12.5
  • ReadPosRankSum < -8.0

If your callset was generated with UnifiedGenotyper for legacy reasons, you can add HaplotypeScore > 13.0.

For indels:

  • QD < 2.0
  • ReadPosRankSum < -20.0
  • InbreedingCoeff < -0.8
  • FS > 200.0
  • SOR > 10.0

And now some more IMPORTANT caveats (don't skip this!)

  • The InbreedingCoeff statistic is a population-level calculation that is only available with 10 or more samples. If you have fewer samples you will need to omit that particular filter statement.

  • For shallow-coverage (<10x), it is virtually impossible to use manual filtering to reliably separate true positives from false positives. You really, really, really should use the protocol involving variant quality score recalibration. If you can't do that, maybe you need to take a long hard look at your experimental design. In any case you're probably in for a world of pain.

  • The maximum DP (depth) filter only applies to whole genome data, where the probability of a site having exactly N reads given an average coverage of M is a well-behaved function. First principles suggest this should be a binomial sampling but in practice it is more a Gaussian distribution. Regardless, the DP threshold should be set a 5 or 6 sigma from the mean coverage across all samples, so that the DP > X threshold eliminates sites with excessive coverage caused by alignment artifacts. Note that for exomes, a straight DP filter shouldn't be used because the relationship between misalignments and depth isn't clear for capture data.

Finally, a note of hope

Some bits of this article may seem harsh, or depressing. Sorry. We believe in giving you the cold hard truth.

HOWEVER, we do understand that this is one of the major points of pain that GATK users encounter -- along with understanding how VQSR works, so really, whichever option you go with, you're going to suffer.

And we do genuinely want to help. So although we can't look at every single person's callset and give an opinion on how it looks (no, seriously, don't ask us to do that), we do want to hear from you about how we can best help you help yourself. What information do you feel would help you make informed decisions about how to set parameters? Are the meanings of the annotations not clear? Would knowing more about how they are computed help you understand how you can use them? Do you want more math? Less math, more concrete examples?

Tell us what you'd like to see here, and we'll do our best to make it happen. (no unicorns though, we're out of stock)

We also welcome testimonials from you. We are one small team; you are a legion of analysts all trying different things. Please feel free to come forward and share your findings on what works particularly well in your hands.

Post edited by Geraldine_VdAuwera on

Geraldine Van der Auwera, PhD


  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Questions and comments up to August 2014 have been moved to an archival thread here:


    Geraldine Van der Auwera, PhD

  • GustavGustav SwedenPosts: 12Member

    I am trying to soft filter my indel calls with the variant recalibrator, but have gotten very confused.
    For my snps everything works fine. And even the model plots for the indels looks pretty good. But there is no "PASS" or "FILTERED or anything else written in the filter column in the vcf file. It does not matter which tranche level I pick. Simply nothing happens?? Nothing gets written in the filter column ever, no matter how I have tweaked the settings.
    My data consists of 35 whole exomes. and there are something around 25,000 indel calls.
    I am using the latest version of GATK.
    My two command lines are:

    -T VariantRecalibrator -R /references/hs.build37.1.fa -input samples_poulsen.indel.vcf \
    -resource:mills,known=true,training=true,truth=true,prior=12.0 /RESOURCES/Mills_and_1000G_gold_standard.indels.b37.vcf \
    -resource:dbsnp,known=true,training=false,truth=false,prior=2.0 /dbsnp138.vcf.gz -mode INDEL \
    -recalFile recalibrate_INDEL.recal -tranchesFile recalibrate_INDEL.tranches -rscriptFile recalibrate_INDEL_plots.R \
    -an QD -an FS -an MQRankSum -an ReadPosRankSum -an InbreedingCoeff --maxGaussians 4


    -T ApplyRecalibration -R /references/hs.build37.1.fa \
    -input samples_poulsen.indel.vcf --ts_filter_level 99.0 \
    -recalFile recalibrate_INDEL.recal \
    -tranchesFile recalibrate_INDEL.tranches \
    -o recal_samples_poulsen.indel.vcf

    I would be very thankful for any kind of help or explanation. Thank you.

  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Hi @Gustav,

    You need to specify -mode INDEL for ApplyRecalibration too, otherwise it only recalibrates SNPs.

    Geraldine Van der Auwera, PhD

  • GustavGustav SwedenPosts: 12Member

    Ah ok. Thank you!

  • vsvintivsvinti Posts: 73Member

    Above, you say:
    "for exomes, a straight DP filter shouldn't be used"
    but the hard filters say
    "QD < 2.0"
    Since they are related, do you mean 'Do not use QD < 2.0' filter for exomes ?

  • pdexheimerpdexheimer Posts: 531Member, Dev ✭✭✭✭

    No. QD != DP

    Depth is a normalizing factor used in the QD calculation, but the two metrics are not related

  • vsvintivsvinti Posts: 73Member

    Ok. Just curious as I notice a 'peak' in variants with QD < 2 that pass the VQSR annotation. So I've been doing VQSR + QD > 2 for retaining variants... this is UG on gatk 2.7 though.

    479 x 470 - 31K
  • spekkiospekkio CanadaPosts: 4Member
    edited August 2015

    I have a question about padding a cohort with public exomes from 1000 Genomes phase one data.

    We have 8 exome samples and want to bring the total up to 30, by using 22 phase one 1k genome exomes, in order to run VQSR to find variants. I've seen it mentioned that this is something the Broad institute does when dealing with small sample sizes and would like to know if you do any kind of pre-processing on the public data before you slide it into your pipeline? I've read ftp://ftp.1000genomes.ebi.ac.uk/vol1/ftp/phase1/README.phase1_alignment_data how the 1k g phase one .bam files were prepared and from what I figure they are already good to go, ie. run HaplotypeCaller on in -ERC GVCF mode. Am I correct in making this assumption or should there be some steps to further prepare the .bam files before running HaplotypeCaller on them?

    quick edit: if there is some more processing to be done, is it different per sequencing platform, ie. some .bams were from SOLID and some were from ILLUMINA.


    Post edited by spekkio on
  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Hi @spekkio,

    That is indeed our recommendation for dealing with small datasets. Ideally you'd want to apply exactly the same pre-processing to all samples (yours and the 1000G samples), including using the same versions of the tools, to avoid any batch effects. The pre-processing applied to the 1000G samples is essentially the one recommended in our Best Practices, but done with a much older version of the tools. So if you can spare the compute, it is better to revert and reprocess them all in the same way. When you use the padding samples for multiple projects it's easy to justify as a one-time investment. Unfortunately we aren't able to offer recently reprocessed versions of the 1000G samples at this time, although something like that is on the roadmap for our future cloud-based offering, which we're working on with Google.

    Geraldine Van der Auwera, PhD

  • rfraserrfraser Guelph, OntarioPosts: 16Member

    Hi GATK Team,

    Just a quick note - in the "The solution: hard-filtering" paragraph above, the "VariantFiltration" link, along with the first two "here" links, seem to be broken.


  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Thanks for pointing this out, @rfraser. Fixed the two VariantFiltration links; that second "here" was a deprecated doc that should no longer be linked to so I've removed it.

    Geraldine Van der Auwera, PhD

  • everestial007everestial007 GreensboroPosts: 50Member

    Hi @Geraldine_VdAuwera
    I am still working on VQSR and have tried several settings but my results are still not that good. But, here are some questions I would like to ask to help myself doing a better job.
    1) How does the use of known=true vs. false effect the output of the ti/tv? In other link you have said that it wouldnot effect the Variant recalibration calculation (which is obvious from the PDF - probability density function plots) but it surely is affecting reported ti/tv ratio, # of tranche specific TP and FP and also the number of novel variants. Could you please provide me little explanation on this?

    2) What information do you feel would help you make informed decisions about how to set parameters? - If its possible I would like an example containing detailed PDF plots for every several pair of annotations. I have tweaked around annotation values and getting different results (different pdf plots), if I have a framework (plots, models) that I can aim for it could be of great help.
    3) Are the meanings of the annotations not clear? - Its quite clear I should say.
    4) Would knowing more about how they are computed help you understand how you can use them? Do you want more math? - Yes I would like to get more information on the maths and computation behind the process. I did some reading on GMM but if there is anything else that could help.
    5) concrete examples? - yes, please.

    Regarding the use of annotation DP for filtering I have question:
    You stated that DP should be set at 5-6 sigma of the mean. But, should the DP be different for different biological samples (as the coverage may vary) or should it be average of across all the samples.

  • everestial007everestial007 GreensboroPosts: 50Member

    After selecting my SNPs I applied stringent filter to the SNP call set:
    java -jar GenomeAnalysisTK.jar -T VariantFiltration -R lyrata_genome.fa -V confHCVariantsSNPsMA605.vcf --filterExpression "QD < 2.0 || FS > 60.0 || MQ < 40.0 || MQRankSum < -12.5 || ReadPosRankSum < -8.0" --filterName "confHCVariantsSNPsMA605" -o filteredHCVariantsSNPsMA605.vcf

    I am able to get the filtered data but not able to quite identify the cultprit that filtered the particular variant:
    See a part of my output


    scaffold_1111 301 . G A 1000.77 confHCVariantsSNPsMA622 AC=1;AF=0.500;AN=2;BaseQRankSum=-6.643;ClippingRankSum=1.212;DP=445;FS=4.863;MLEAC=1;MLEAF=0.500;MQ=27.78;MQRankSum=0.754;QD=2.25;ReadPosRankSum=0.619;SOR=0.362 GT:AD:DP:GQ:PL 0/1:365,76:441:99:1029,0,11104
    scaffold_1111 340 . C T 910.77 confHCVariantsSNPsMA622 AC=1;AF=0.500;AN=2;BaseQRankSum=-6.699;ClippingRankSum=0.892;DP=223;FS=42.552;MLEAC=1;MLEAF=0.500;MQ=24.63;MQRankSum=1.587;QD=4.08;ReadPosRankSum=-0.589;SOR=2.769 GT:AD:DP:GQ:PL 0/1:156,64:220:99:939,0,4906
    scaffold_1106 82 . G C 168.90 PASS AC=2;AF=1.00;AN=2;DP=6;FS=0.000;MLEAC=2;MLEAF=1.00;MQ=55.79;QD=28.15;SOR=3.611 GT:AD:DP:GQ:PL 1/1:0,5:5:15:197,15,0
    scaffold_1106 314 . T C 530.77 PASS AC=2;AF=1.00;AN=2;DP=19;FS=0.000;MLEAC=2;MLEAF=1.00;MQ=56.53;QD=27.94;SOR=0.793 GT:AD:DP:GQ:PL 1/1:0,19:19:57:559,57,0

    The variants that were filtered only has the filter name. Is there a way to identify that specific culprit?

    Also, I can set annotation parameters in a different way when filtering (using JEXL). Could you please let me know based on your experience if you had better results using the "OR" combination or rather && comination. for eg. "A" || "B" vs. "A" && "B" annotations.

    Thank you !!!

  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Hi @everestial007, we are working on developing some documentation that will address much of this, but it will take a few more weeks before it is ready to share.

    If you are struggling to find out why variants were filtered out, I would recommend splitting up your filter query into multiple queries with separate filter names. This will be more informative. Combination filters are great if you know how you want to filter and you're not worried about diagnosing individual calls, but they are not so great if you do care about individual calls or if you are fairly new to this.

    Also, to help you choose filtering cutoffs, try plotting the distribution of annotation values in your data.

    Geraldine Van der Auwera, PhD

  • everestial007everestial007 GreensboroPosts: 50Member

    Hi @Geraldine_VdAuwera
    Thanks for the info.

    I have came across SnpSift to extract the annotation values out of *.vcf files. While the extraction of QUAL values has been straight forward the extraction of other annotation values like BaseQRankSum, ClippingRankSum, etc has been little not so successful as they are multiple annotation values with in the INFO field. I cannot find which tools in GATK is appropriate for extracting annotation values and plotting them.

    Also, could you please direct me to some other good example you know of VQSR that could be of help.

  • Geraldine_VdAuweraGeraldine_VdAuwera Posts: 9,858Administrator, Dev admin

    Have a look at VariantsToTable.

    See also the tutorial materials from the last BroadE workshop that were posted on the GATK blog in November.

    Geraldine Van der Auwera, PhD

Sign In or Register to comment.