Page tree
Skip to end of metadata
Go to start of metadata

1. FILTER, INFO, and FORMAT fields in aggV2

A substantial amount of queries to aggV2 can be made using the FILTER, INFO, and FORMAT tags within the VCFs (both the genotype VCFs and the functional annotation VCFs). 

  • The FILTER field shows the per variant flag indicating which of a given set of filters the variant has passed or failed (such as median coverage). 
  • The INFO filed shows the per variant list of key-value pairs describing the variation (such as variant allele frequency and variant median depth).
  • The FORMAT field shows and extensible list of fields for describing the samples per variant (such as sample genotype, sample depth).

One can extract all tags per field using the code below which uses bcftools to view the header of a single chunk then extracts the specific field:


module load bio/BCFtools/1.10.2-foss-2018b

cd /gel_data_resources/main_programme/aggregation/aggregate_gVCF_strelka/aggV2/genomic_data

# This command will print out all of the FILTER tags in the VCF
bcftools view -h gel_mainProgramme_aggV2_chr7_48864936_51531027.vcf.gz | grep '#FILTER'

# This command will print out all of the INFO tags in the VCF
bcftools view -h gel_mainProgramme_aggV2_chr7_48864936_51531027.vcf.gz | grep '#INFO'

# This command will print out all of the FORMAT tags in the VCF
bcftools view -h gel_mainProgramme_aggV2_chr7_48864936_51531027.vcf.gz | grep '#FORMAT'

2. Identifying which chunk to use

aggV2 is split into 1,371 'chunks' across the genome. This is true for both the genotype VCFs and the functional annotation VCFs; where the chromosome, start, and stop chunk names are identical across data types. 

It is often necessary to know which chunk(s) your gene(s), variant(s), region(s) of interest are located in. The script below helps you to this. 

Chunk Names

Chunks are named in the following format: 

Genotype VCFs:


- for example - 


Functional Annotation VCFs: 


- for example - 


2.1. List of chunk names and aggV2 VCF files

The list of chunk names and full file paths to both the genotype and functional annotation VCFs can be found here. 


Each of the 1,371 chunks is on a separate line and each line contains 7 fields:

Column numberDescriptionExample
2Chunk start1
3Chunk stop506426
4Chromosome, start, stop (format 1)chr1_1_506426
5Chromosome, start, stop (format 2)chr1:1-506426
6Full path to genotype annotation VCF/gel_data_resources/main_programme/aggregation/aggregate_gVCF_strelka/aggV2/genomic_data/gel_mainProgramme_aggV2_chr1_1_506426.vcf.gz
7Full path to functional annotation VCF/gel_data_resources/main_programme/aggregation/aggregate_gVCF_strelka/aggV2/functional_annotation/VEP/gel_mainProgramme_aggV2_chr1_1_506426_VEPannot.vcf.gz

2.2. Create your own regions file 

You firstly must create a regions file of your gene(s), variant(s), region(s) of interest. This must be a three or column tab-delimited file of chromosome, start, and stop (with an option fourth column of an identifier - i.e. a gene name). The file should have the .bed extension. There is no limit to how many lines you can have in this file. 


Please pre-sort your data by chromosome and then by start position (sort -k1,1 -k2,2n in.bed > in.sorted.bed)


chr2	213005363	213151603	IKZF2
chr7	50304716	50405101	IKZF1

2.3. Intersect the two files

Now you can intersect the bed file of chunk names with your regions file using bedtools as shown below: 


module load bio/BEDTools/2.27.1-foss-2018b

bedtools intersect -wo -a my_regions.bed -b aggV2_chunk_names.bed | cut -f 1-4,10-11

This will print out a six column tab-delimited file with the number of lines equalling the number of inputs in the regions file. It will have the following format:

Column numberDescriptionExample


2Region start


3Region stop


4Region identifier


5Full path to genotype annotation VCF


6Full path to functional annotation VCF


The full array of columns can also be printed by omitting the cut command.