What it does
This program will run each of the Stacks components: first, running ustacks on each of the samples specified, building loci and calling SNPs in each. Second, cstacks will be run to create a catalog of all loci that were marked as 'parents' or 'samples' on the command line, and finally, sstacks will be executed to match each sample against the catalog. A bit more detail on this process can be found in the FAQ. The denovo_map.pl program will also load the results of each stage of the analysis: individual loci, the catalog, and matches against the catalog into the database (although this can be disabled). After matching, the program will build a database index to speed up access (index_radtags.pl) and enable web-based filtering.
Created by:
Stacks was developed by Julian Catchen with contributions from Angel Amores, Paul Hohenlohe, and Bill Cresko
Example:
Input files:
FASTQ, FASTA, zip, tar.gz
Population map:
indv_01 1 indv_02 1 indv_03 1 indv_04 2 indv_05 2 indv_06 2
Output files:
XXX.tags.tsv file:
Column Name Description 1 Sql ID This field will always be "0", however the MySQL database will assign an ID when it is loaded. 2 Sample ID Each sample passed through Stacks gets a unique id for that sample. 3 Stack ID Each stack formed gets an ID. 4 Chromosome If aligned to a reference genome using pstacks, otherwise it is blank. 5 Basepair If aligned to ref genome using pstacks. 6 Strand If aligned to ref genome using pstacks. 7 Sequence Type Either 'consensus', 'primary' or 'secondary', see the Stacks paper for definitions of these terms. 8 Sequence ID The individual sequence read that was merged into this stack. 9 Sequence The raw sequencing read. 10 Deleveraged Flag If "1", this stack was processed by the deleveraging algorithm and was broken down from a larger stack. 11 Blacklisted Flag If "1", this stack was still confounded depsite processing by the deleveraging algorithm. 12 Lumberja ckstack Flag If "1", this stack was set aside due to having an extreme depth of coverage.
Notes: For the tags file, each stack will start in the file with a consensus sequence for the entire stack followed by the flags for that stack. Then, each individual read that was merged into that stack will follow. The next stack will start with another consensus sequence.
XXX.snps.tsv file:
Column Name Description 1 Sql ID This field will always be "0", however the MySQL database will assign an ID when it is loaded. 2 Sample ID 3 Stack ID 4 SNP Column 5 Likelihood ratio From the SNP-calling model. 6 Rank_1 Majority nucleotide. 7 Rank_2 Alternative nucleotide.
Notes: If a stack has two SNPs called within it, then there will be two lines in this file listing each one.
XXX.alleles.tsv file:
Column Name Description 1 Sql ID This field will always be "0", however the MySQL database will assign an ID when it is loaded. 2 Sample ID 3 Stack ID 4 Haplotype The haplotype, as constructed from the called SNPs at each locus. 5 Percent Percentage of reads that have this haplotype 6 Count Raw number of reads that have this haplotype
XXX.matches.tsv file:
Column Name Description 1 Sql ID This field will always be "0", however the MySQL database will assign an ID when it is loaded. 2 Batch ID 3 Catalog ID 4 Sample ID 5 Stack ID 6 Haplotype 7 Stack Depth
Notes: Each line in this file records a match between a catalog locus and a locus in an individual, for a particular haplotype. The Batch ID plus the Catalog ID together represent a unique locus in the entire population, while the Sample ID and the Stack ID together represent a unique locus in an individual sample.
batch_X.sumstats.tsv Summary Statistics Output:
Batch ID The batch identifier for this data set. Locus ID Catalog locus identifier. Chromosome If aligned to a reference genome. Basepair If aligned to a reference genome. This is the alignment of the whole catalog locus. The exact basepair reported is aligned to the location of the RAD site (depending on whether alignment is to the positive or negative strand). Column The nucleotide site within the catalog locus. Population ID The ID supplied to the populations program, as written in the population map file. P Nucleotide The most frequent allele at this position in this population. Q Nucleotide The alternative allele. Number of Individuals Number of individuals sampled in this population at this site. P Frequency of most frequent allele. Observed Heterozygosity The proportion of individuals that are heterozygotes in this population. Observed Homozygosity The proportion of individuals that are homozygotes in this population. Expected Heterozygosity Heterozygosity expected under Hardy-Weinberg equilibrium. Expected Homozygosity Homozygosity expected under Hardy-Weinberg equilibrium. pi An estimate of nucleotide diversity. Smoothed pi A weighted average of p depending on the surrounding 3s of sequence in both directions. Smoothed pi P-value If bootstrap resampling is enabled, a p-value ranking the significance of p within this population. FIS The inbreeding coefficient of an individual (I) relative to the subpopulation (S). Smoothed FIS A weighted average of FIS depending on the surrounding 3s of sequence in both directions. Smoothed FIS P-value If bootstrap resampling is enabled, a p-value ranking the significance of FIS within this population. Private allele True (1) or false (0), depending on if this allele is only occurs in this population.
batch_X.fst_Y-Z.tsv Pairwise FST Output:
Batch ID The batch identifier for this data set. Locus ID Catalog locus identifier. Population ID 1 The ID supplied to the populations program, as written in the population map file. Population ID 2 The ID supplied to the populations program, as written in the population map file. Chromosome If aligned to a reference genome. Basepair If aligned to a reference genome. This is the alignment of the whole catalog locus. The exact basepair reported is aligned to the location of the RAD site (depending on whether alignment is to the positive or negative strand). Column The nucleotide site within the catalog locus. Overall pi An estimate of nucleotide diversity across the two populations. FST A measure of population differentiation. FET p-value P-value describing if the FST measure is statistically significant according to Fisher's Exact Test. Odds Ratio Fisher's Exact Test odds ratio CI High Fisher's Exact Test confidence interval. CI Low Fisher's Exact Test confidence interval. LOD Score Logarithm of odds score. Expected Heterozygosity Heterozygosity expected under Hardy-Weinberg equilibrium. Expected Homozygosity Homozygosity expected under Hardy-Weinberg equilibrium. Corrected FST FST with either the FET p-value, or a window-size or genome size Bonferroni correction. Smoothed FST A weighted average of FST depending on the surrounding 3s of sequence in both directions. Smoothed FST P-value If bootstrap resampling is enabled, a p-value ranking the significance of FST within this pair of populations.
Instructions to add the functionality of archives management in Galaxy on the eBiogenouest HUB wiki .
Output type:
Output type details:
No compression All files will be added in the current history. Compressed by categories Files will be compressed by categories (snps, allele, matches and tags) into 4 zip archives. These archives and batch files will be added in the current history. Compressed all outputs All files will be compressed in an unique zip archive. Batch files will be added in the current history with the archive.
Project links:
References:
-J. Catchen, P. Hohenlohe, S. Bassham, A. Amores, and W. Cresko. Stacks: an analysis tool set for population genomics. Molecular Ecology. 2013.
-J. Catchen, S. Bassham, T. Wilson, M. Currey, C. O'Brien, Q. Yeates, and W. Cresko. The population structure and recent colonization history of Oregon threespine stickleback determined using restriction-site associated DNA-sequencing. Molecular Ecology. 2013.
-J. Catchen, A. Amores, P. Hohenlohe, W. Cresko, and J. Postlethwait. Stacks: building and genotyping loci de novo from short-read sequences. G3: Genes, Genomes, Genetics, 1:171-182, 2011.
-A. Amores, J. Catchen, A. Ferrara, Q. Fontenot and J. Postlethwait. Genome evolution and meiotic maps by massively parallel DNA sequencing: Spotted gar, an outgroup for the teleost genome duplication. Genetics, 188:799'808, 2011.
-P. Hohenlohe, S. Amish, J. Catchen, F. Allendorf, G. Luikart. RAD sequencing identifies thousands of SNPs for assessing hybridization between rainbow trout and westslope cutthroat trout. Molecular Ecology Resources, 11(s1):117-122, 2011.
-K. Emerson, C. Merz, J. Catchen, P. Hohenlohe, W. Cresko, W. Bradshaw, C. Holzapfel. Resolving postglacial phylogeography using high-throughput sequencing. Proceedings of the National Academy of Science, 107(37):16196-200, 2010.
Integrated by:
Yvan Le Bras and Cyril Monjeaud
GenOuest Bio-informatics Core Facility
UMR 6074 IRISA INRIA-CNRS-UR1 Rennes (France)