RegenotypeVariants

Regenotypes the variants from a VCF.

Category Variant Evaluation and Manipulation Tools

Traversal LocusWalker

PartitionBy LOCUS

Overview

VCF records must contain PLs or GLs.

This tool triggers re-genotyping of the samples through the Exact Allele Frequency calculation model. Note that this is truly the mathematically correct way to select samples from a larger set (especially when calls were generated from low coverage sequencing data); using the hard genotypes to select (i.e. the default mode of SelectVariants) can lead to false positives when errors are confused for variants in the original genotyping. This functionality used to comprise the --regenotype option in SelectVariants but we pulled it out into its own tool for technical purposes.

Input

A variant set to regenotype.

Output

A re-genotyped VCF.

Examples

 java -Xmx2g -jar GenomeAnalysisTK.jar \
   -R ref.fasta \
   -T RegenotypeVariants \
   --variant input.vcf \
   -o output.vcf

Additional Information

Read filters

These Read Filters are automatically applied to the data by the Engine before processing by RegenotypeVariants.

Parallelism options

This tool can be run in multi-threaded mode using this option.

TreeReducible (-nt)

Command-line Arguments

Inherited arguments

The arguments described in the entries below can be supplied to this tool to modify its behavior. For example, the -L argument directs the GATK engine restricts processing to specific genomic intervals (this is an Engine capability and is therefore available to all GATK walkers).

CommandLineGATK

RegenotypeVariants specific arguments

This table summarizes the command-line arguments that are specific to this tool. For details, see the list further down below the table.

Name	Type	Default value	Summary
Required
--variant	RodBinding[VariantContext]	NA	Input VCF file
Optional
--out	VariantContextWriter	stdout	File to which variants should be written

Argument details

Arguments in this list are specific to this tool. Keep in mind that other arguments are available that are shared with other tools (e.g. command-line GATK arguments); see Inherited arguments above.

--out / -o ( VariantContextWriter with default value stdout )

File to which variants should be written.

--variant / -V ( required RodBinding[VariantContext] )

Input VCF file. Variants from this VCF file are used by this tool as input. The file must at least contain the standard VCF header lines, but can be empty (i.e., no variants are contained in the file). --variant binds reference ordered data. This argument supports ROD files of the following types: BCF2, VCF, VCF3

GATK version 2.5-2-gdb4546e built at 2013/05/01 09:32:36.