QTLsurge

Software for iterative genotyping design in a QTL-seq experiment

Installation and Implementation:

QTLsurge is designed to be run under RStudio as a Shiny app.

1. Install dependancies: RStudio then, using Rstudio package manager, install zoo, ggplot2, and shiny libraries.
2. Download the R code using "Clone or download" button; "Download ZIP"
3. Unzip the file in the location of your choice
4. Open QTLsurge.R in RStudio
5. Press "Run App" button

Required input

QTLsurge requires a tab delimited file containing chromosome ID in the first column, SNP location in the second column, high-bulk allele frequency in the third column, low-bulk allele freqency in the fourth column, deltaSNP (difference between high and low frequency) value in the fifth column, and cycle number in sixth column (see test/test.freq). Regardless of sign, all deltaSNP values are converted to absolute values for plotting and window calculation. Users may run the following pipeline or any tool/pipeline to generate the VCF file from their sequencing data. However, the AD tag should be present. It is not a default tag for most tools. If you are not comfortable with command line tools, you will want to collaborate with someone in order to generate the input format.

#map reads to reference.fa using bwa or bowtie to generate highBulk.bam and lowBulk.bam
samtools faidx reference.fa #creates index
bcftools mpileup -Ou -a AD -f reference.fa highBulk.bam lowBulk.bam > output.bcf #calls variants and adds fequency information
bcftools call -vc -V indels -O v output.bcf > output_snps.vcf #extract snps

#The inclusion of repeats in your experiment can dramatically reduce your signal strength; therefore, poor mapping quality and excess depth of coverage are two key features to filter on.  So the next step is optional but something like it is highly recommended
#!!!If running additional cycles of amplicon sequenceing, this step should be skipped or modified to reflect higher expected coverage!!!
#Run ./qtl.filter.vcf.pl -help for a full list of program options, additional filtering options are available. If your vcf file includes the bulk parents, qtl.filter.vcf.pl can use them to filter SNPs where parents are heterozygous or not polymorphic.
/path/to/QTLsurge/qtl.filter.vcf.pl -v output_snps.vcf -o output_qtl_snps --pop1_name highBulk --pop2_name lowBulk --min_depth 5 --max_depth 60 --qual 50 --mq 50 --pop_ratio

#vcf2freq.pl is supplied as a helper program, converts to QTLsurge format.  The last argument is the cycle you are on.  Use 0 if this is your initial, standard QTL-seq experiment.  This script is not robust to variation in genotype format and only accepts "GT:PL:AD" format that results from this pipeline.
perl /path/to/QTLsurge/vcf2freq.pl output_qtl_snps.vcf 0 > output_frequency_file.txt

A testing file (test/test.freq) is located on the github page.

Running an experiment

You will start with low-depth (10-30x) sequencing data across the genome converted to QTLsurge format as described above. Browse to this file and open it. A graph, similiar to the one below will appear momentarily. You can step through each chromosome using the interface and look for peaks that are above the genome-wide threshold (95th percentile based on raw deltaSNP values). Because raw data of this kind is very noisy, a sliding window average is supplied. The appropriate window size is a function of population size, recombination rate, marker density, and read depth. Generally, if read depth is >40x, your window size should decrease as your population size increases. A good rule-of-thumb is that few windows should have an average that extends beyond 3 standard error units of a directly adjacent window, assuming your overlap-to-window-size is ~20%. The red line indicates the average of window and the gray shading iindicates 3 standard error units. Note: Setting the overlap size very low will cause QTLSurge to respond slowly and should only be used when zoomed in to a <1MB range.

Once a peak is identified and selected, by zooming in, all SNPs in the zoomed area can be exported using the "generate . . . " button. SNPs will also contain the sliding window average for the window size selected but with an overlap of 1 (every SNP is different). This file, in conjunction with the VCF file and a genome browsing tool, can be used to design amplicons for border and peak SNPs as well as any number (2-30) intermediate SNPs depending on your ability to multiplex and sequencing platform.

Once these amplicons have been sequenced and QTLsurge files created, they can be loaded using the indicated field. The raw results will fade and larger, blue points indicate the frequencies attained in amplicon cycles. These results should allow you to zoom in further on the true peak and, by useing the zoom above, you can capture intervening SNPs. The exported file will be sorted by position and tagged with the cycle (so some positions will have multiple entries). Find your peak and borders for most recent cycle and design primers as above.

After a second cycle, you will combine first and second cycle information together by copy and pasting in a text editor. Use Notepad or Text Wrangler but not Word, and make sure to avoid pasting the header when adding to your previous cycle file. This file can now be loaded in the "amplicon ..." file field. In theory, you can combine all files and load in the "initial QTL-seq" field, but this file is generally much larger and harder to work with, so we combine everything for you under-the-hood.

Loading the combined 1st and 2nd cycle files will result in a new set of points. The largest, darkest points are always the most recent.

Continue cycling until you're confident you've found the true peak and its boundaries. Depending on the experiment, this doesn't mean your gene is exactly there, but, with a little detective work or help from other tools (see Gene Sieve), you should be able to find a very strong candidate in the neighborhood.

Citation:

coming soon