VariantEval Evaluation Modules Glossary

IMPORTANT: This is the legacy GATK documentation. This information is only valid until Dec 31st 2019. For latest documentation and forum click here

created by KateN

on 2015-10-21

Table of Contents

Default modules:

• CompOverlap: gives concordance metrics based on the overlap between the evaluation and comparison file
• CountVariants: counts different types (SNP, insertion, complex, etc.) of variants present within your evaluation file and gives related metrics
• IndelLengthHistogram: gives a table of values for plotting a histogram of indel lengths found in your evaluated variants.
• IndelSummary: gives metrics related to insertions and deletions (count, multiallelic sites, het-hom ratios, etc.)
• MultiallelicSummary: gives metrics relevant to multiallelic variant sites, including amount, ratio, and TiTv
• TiTvVariantEvaluator: gives the number and ratio of transition and transversion variants for your evaluation file, comparison file, and ancestral alleles
• ValidationReport: details the sensitivity and specificity of your callset, given follow-up validation assay data
• VariantSummary: gives a summary of metrics related to SNPs and indels
  • Other available modules:
• MendelianViolationEvaluator: detects and counts Mendelian violations, given data from parent samples.
• PrintMissingComp: returns the number of variant sites present in your callset that were not found in the truth set.
• ThetaVariantEvaluator: computes different estimates of theta based on variant sites and genotypes
• MetricsCollection: includes all minimum metrics discussed in this article (link to follow; document in progress). Runs by default if CompOverlap, IndelSummary, TiTvVariantEvaluator, CountVariants, & MultiallelicSummary are run as well. (included in the nightly build for immediate use or in the next release of GATK) _{* At the time of writing, the listed modules were present. To check modules present in your specific GATK version, use the -list command.}

General

Each table has a few columns of data that will be the same across multiple evaluation modules. To avoid listing them multiple times, they will be specified here

Example Output *

• CompOverlap- In the above example, we see the first column is the CompOverlap. This first column will always be the name of the evaluation module you are currently viewing. IndelSummary will say "IndelSummary", CountVariants will say "CountVariants" and so on.
• CompRod- shows which file is being compared to the eval for that row. By default, this is dbsnp, but you can specify additional comparison files using -comp, and name them using :. E.g. -comp:name \path\to\file.vcf where name is the name you wish to specify for the CompRod column and \path\to\file.vcf is your comparison file. If left unnamed, these additional comparison files will default to "comp" in the CompRod column.
• EvalRod- shows which file is being evaluated. This is useful when specifying multiple eval files. They can be named using the : notation as above. When unnamed, they will default to "eval" in the EvalRod column.
• JexlExpression- a Jexl query that was applied to the file. For details on Jexl expressions, please read about them here
• Novelty- has three possible values; all, known, and novel. "Novel" includes anything seen exclusively in the eval that is not seen in the comp. "Known" includes anything seen in both the eval and the comp. "All" is the sum of "Novel" and "Known". By default, the comp used to determine novelty is dbsnp. To change this, you must specify -knownName with the new comparison file you have passed in.

*Output from a rare variant association study with >1500 whole genome sequenced samples

CompOverlap

Example Output *

• nEvalVariants- the number of variants in the eval file
• novelSites- the number of variants in the eval considered to be novel in comparison to dbsnp (same as novel row of nEvalVariants column)
• nVariantsAtComp- the number of variants present in eval that match the location of a variant in the comparison file (same as known row of nEvalVariants)
• compRate- nVariantsAtComp divided by nEvalVariants
• nConcordant- the number of variants present in eval that exactly match the genotype present in the comparison file
• concordantRate- nConcordant divided by nVariantsAtComp

*Output from a rare variant association study with >1500 whole genome sequenced samples

CountVariants

Example Output *

• nProcessedLoci- the number of loci iterated over in the reference file (also found in MultiallelicSummary)
• nCalledLoci- the number of loci called in the eval file
• nRefLoci- the number of loci in eval that matched the reference file
• nVariantLoci- the number of loci in eval that did not match the reference file
• variantRate- nVariantLoci divided by nProcessedLoci
• variantRatePerBp- nProcessedLoci divided by nVariantLoci (a truncated integer)
• nSNPs- the number of variants determined to be single-nucleotide polymorphisms
• nMNPs- the number of variants determined to be multi-nucleotide polymorphisms
• nInsertions- the number of variants determined to be insertions
• nDeletions- the number of variants determined to be deletions
• nComplex- the number of variants determined to be complex (both insertions and deletions)
• nSymbolic- the number of variants determined to be symbolic
• nMixed- the number of variants determined to be mixed (cannot be determined to be SNPs, MNPs, or indels)
• nNoCalls- the number of sites at which there was no variant call made
• nHets- the number of heterozygous loci
• nHomRef- the number of homozygous reference loci
• nHomVar- the number of homozygous variant loci
• nSingletons- the number of variants determined to be singletons (occur only once)
• nHomDerived- the number of homozygous derived variants; an ancestor had a variant at that site, but the descendant in question no longer has a variant at that site and is now homozygous reference.
• heterozygosity- nHets divided by nProcessedLoci
• heterozygosityPerBp- nProcessedLoci divided by nHets (a truncated integer)
• hetHomRatio- nHets divided by nHomVar
• indelRate- nInsertions plus nDeletions plus nComplex all divided by nProcessedLoci
• indelRatePerBp- nProcessedLoci divided by the sum of nInsertions, nDeletions, and nComplex (a truncated integer)
• insertionDeletionRatio- nInsertions divided by nDeletions

*Output from a rare variant association study with >1500 whole genome sequenced samples

IndelSummary

Example Output *

• n_SNPs- the number of SNPs (multiallelic SNPs are counted once for each allele)
• n_singleton_SNPs- the number of SNP singleton loci (SNPs seen only once)
• n_indels- the number of indels (multiallelic indels are counted once for each allele)
• n_singleton_indels- the number of indel singleton loci (indels seen only once)
• n_indels_matching_gold_standard- the number of indel loci that match indels in the gold standard (must pass in a -gold parameter)
• gold_standard_matching_rate- nindelsmatchinggoldstandard divided by n_indels
• n_multiallelic_indel_sites- the number of indel sites that are multiallelic
• percent_of_sites_with_more_than_2_alleles- nmultiallelicindel_sites divided by the total number of indel sites
• SNP_to_indel_ratio- nSNPs divided by nindels
• SNP_to_indel_ratio_for_singletons- nsingletonSNPs divided by nsingletonindels
• n_novel_indels- number of indels considered to be novel in comparison to dbsnp (the novel row of the n_indels column gives the same information)
• indel_novelty_rate- nnovelindels divided by n_indels
• n_insertions- the number of insertion variants
• n_deletions- the number of deletion variants
• insertion_to_deletion_ratio- ninsertions divided by ndeletions
• n_large_deletions- number of deletions with a length greater than 10
• n_large_insertions- number of insertions with a length greater than 10
• insertion_to_deletion_ratio_for_large_indels- nlargeinsertions divided by nlargedeletions
• n_coding_indels_frameshifting- the number of indels within the coding regions of the genome which cause a frameshift
• n_coding_indels_in_frame- the number of indels within the coding regions of the genome which do not cause a frameshift
• frameshift_rate_for_coding_indels- ncodingindelsframeshifting divided by the sum of ncodingindelsframeshifting and ncodingindelsinframe
• SNP_het_to_hom_ratio- the number of heterozygous SNPs divided by the number of homozygous variant SNPs
• indel_het_to_hom_ratio- the number of heterozygous indels divided by the number of homozygous variant indels
• ratio_of_1_and_2_to_3_bp_insertions- the sum of one and two base pair insertions divided by three base pair insertions
• ratio_of_1_and_2_to_3_bp_deletions- the sum of one and two base pair deletions divided by three base pair deletions

*Output from a rare variant association study with >1500 whole genome sequenced samples

TiTvVariantEvaluator

Example Output *

• nTi- number of transition variants in eval (A↔G or T↔C)
• nTv- number of transversion variants in eval (A↔T or G↔C or A↔C or G↔T)
• tiTvRatio- nTi divided by nTv
• nTiInComp- number of transition variants present in the comparison file
• nTvInComp- number of transversion variants present in the comparison file
• TiTvRatioStandard- nTiInComp divided by nTvInComp
• nTiDerived- number of transition variants derived from ancestral alleles
• nTvDerived- number of transversion variants derived from ancestral alleles
• tiTvDerivedRatio- nTiDerived divided by nTvDerived

*Output from a rare variant association study with >1500 whole genome sequenced samples

MultiallelicSummary

Example Output *

• nProcessedLoci- number of loci iterated over in the reference file (also found in CountVariants)
• nSNPs- number of SNPs (multiallelic SNPs are only counted once overall)
• nMultiSNPs- number of multiallelic SNPs (again, only counted once per loci)
• processedMultiSnpRatio- nMultiSNPs divided by nProcessedLoci
• variantMultiSnpRatio- nMultiSNPs divided by nSNPs
• nIndels- number of indels (multiallelic indels are only counted once overall)
• nMultiIndels- number of multiallelic indels (again, only counted once per loci)
• processedMultiIndelRatio- nMultiIndels divided by nProcessedLoci
• variantMultiIndelRatio- nMultiIndels divided by nIndels
• nTi- number of transition variants at multiallelic sites
• nTv- number of transversion variants at multiallelic sites
• TiTvRatio- nTi divided by nTv
• knownSNPsPartial- the number of loci at which at least one allele in eval was found in the known comparison file (applies only to multiallelic sites)
• knownSNPsComplete- the number of loci at which all alleles in eval were also found in the known comparison file (applies only to multiallelic sites)
• SNPNoveltyRate- the sum of knownSNPsPartial and knownSNPsComplete divided by nMultiSNPs

*Output from a rare variant association study with >1500 whole genome sequenced samples

Updated on 2017-09-30

From auraf on 2017-09-25

Hi, does the nTv metric calculated by the TiTvVariantEvaluator consider also N of transversions A/C and G/T?

From Sheila on 2017-09-28

@auraf

HI,

I don’t think it does, but let me check with the team and get back to you.

-Sheila

From Geraldine_VdAuwera on 2017-09-30

It certainly should — looks like an error in the doc, sorry about that. (fixed it)