annotate VDM_Mapping.xml @ 1:2ce68f42fd3a draft

Uploaded
author gregory-minevich
date Mon, 08 Oct 2012 13:53:22 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
1 <tool id="cloudmap_variant_discovery_mapping" name="CloudMap: Variant Discovery Mapping with WGS data">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
2 <description>Map a mutation using in silico bulk segregant linkage analysis using variants that are already present in the mutant strain of interest (rather than those introduced by a cross to a polymorphic strain).</description>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
3 <command interpreter="python">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
4 #if $source.source_select=="elegans" #VDM_Mapping.py --sample_vcf $sample_vcf --loess_span $loess_span --d_yaxis $d_yaxis --h_yaxis $h_yaxis --points_color "$points_color" --loess_color "$loess_color" --output $output --location_plot_output $location_plot_output --standardize $standardize --normalize_bins $normalize_bins --break_file $source.Celegans
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
5 #else if $source.source_select=="arabadopsis" #VDM_Mapping.py --sample_vcf $sample_vcf --loess_span $loess_span --d_yaxis $d_yaxis --h_yaxis $h_yaxis --points_color "$points_color" --loess_color "$loess_color" --output $output --location_plot_output $location_plot_output --standardize $standardize --normalize_bins $normalize_bins --break_file $source.Arabadop
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
6 #else if $source.source_select=="other" #VDM_Mapping.py --sample_vcf $sample_vcf --loess_span $loess_span --d_yaxis $d_yaxis --h_yaxis $h_yaxis --points_color "$points_color" --loess_color "$loess_color" --output $output --location_plot_output $location_plot_output --standardize $standardize --normalize_bins $normalize_bins --break_file $source.Other
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
7 #end if
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
8 </command>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
9
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
10 <inputs>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
11 <conditional name="source">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
12 <param name="source_select" type="select" label="Please select the species">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
13 <option value="elegans">C. elegans</option>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
14 <option value="arabidopsis">Arabidopsis</option>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
15 <option value="other">Other</option>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
16 </param>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
17 <when value="elegans">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
18 <param name="Celegans" type="hidden" value="C.elegans" label="The C.elegans configuration file by default" help="C.elegans help" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
19 </when>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
20 <when value="arabidopsis">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
21 <param name="Arabidop" type="hidden" value="Arabidopsis" label="The Arabidopsis configuration file by default" help="Arabidopsis help" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
22 </when>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
23 <when value="other">
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
24 <param name="Other" type="data" format="tabular" label="Please select your 'Other species' configuration file from your history" help="Tabular configuration file for Other species support" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
25 </when>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
26 </conditional>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
27 <param name="sample_vcf" size = "125" type="data" format="vcf" label="WGS Mutant VCF File" help="WGS Mutant VCF file from pooled F2 mutants that have been outcrossed to any strain. The VCF should contain data from only heterozygous or homozygous base position as determined by the GATK Unified Genotyper filtered for quality score > Q200" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
28 <param name="loess_span" size = "15" type="float" value=".4" label="Loess span" help="Parameter that controls the degree of data smoothing."/>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
29 <param name="d_yaxis" size = "15" type="float" value="1" label="Y-axis upper limit for scatter plot" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
30 <param name="h_yaxis" size = "15" type="integer" value="20" label="Y-axis upper limit for frequency plot" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
31 <param name="points_color" size = "15" type="text" value="gray27" label="Color for data points" help="See below for list of supported colors"/>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
32 <param name="loess_color" size = "15" type="text" value="red" label="Color for loess regression line" help="See below for list of supported colors"/>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
33 <param name="standardize" type="boolean" truevalue="true" falsevalue="false" checked="true" label="Standardize X-axis" help="Scatter plots and frequency plots from separate chromosomes will have uniform X-axis spacing for comparison"/>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
34 <param name="normalize_bins" type="boolean" truevalue="true" falsevalue="false" checked="true" label="Normalize frequency plots" help="Frequency plots of pure parental allele counts will be normalized according to the equation in Supp Fig.4 of the CloudMap paper"/>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
35 </inputs>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
36 <outputs>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
37 <data name="output" type="text" format="tabular" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
38 <data name="location_plot_output" format="pdf" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
39 </outputs>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
40 <requirements>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
41 <requirement type="python-module">sys</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
42 <requirement type="python-module">optparse</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
43 <requirement type="python-module">csv</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
44 <requirement type="python-module">re</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
45 <requirement type="python-module">decimal</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
46 <requirement type="python-module">rpy</requirement>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
47 </requirements>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
48 <tests>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
49 <param name="sample_vcf" value="" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
50 <output name="output" file="" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
51 <output name="plot_output" file="" />
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
52 </tests>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
53 <help>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
54 **What it does:**
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
55
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
56 This tool is part of the CloudMap pipeline for analysis of mutant genome sequences. For further details, please see `Gregory Minevich, Danny S. Park, Daniel Blankenberg, Richard J. Poole and Oliver Hobert. CloudMap: A Cloud-based Pipeline for Analysis of Mutant Genome Sequences. (Genetics 2012 In Press)`__
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
57
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
58 .. __: http://biochemistry.hs.columbia.edu/labs/hobert/literature.html
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
59
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
60 CloudMap workflows, shared histories and reference datasets are available at the `CloudMap Galaxy page`__
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
61
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
62 .. __: http://usegalaxy.org/cloudmap
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
63
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
64
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
65 Although Hawaiian Variant Mapping is the preferred method for mapping causal mutations in whole genome sequenced strains (see CloudMap Hawaiian Variant Mapping with WGS tool), there remain certain scenarios where alternate mapping approaches are useful. For instance, introducing tens of thousands of Hawaiian variants into a mutant strain may not be desirable for individuals concerned with the possibility that some of these Hawaiian variants may act as modifiers of a given phenotype. Behavioral mutants may be especially vulnerable in this regard. Furthermore, in the case of suppressor screens or other screens that have been performed in a mutant background, it is tedious to recover both the suppressor variant and the starting mutation when picking the F2 progeny required for the Hawaiian Variant Mapping technique. In these scenarios, it is useful to not have to rely on a polymorphic mapping strain like the Hawaiian strain.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
66
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
67 A recent study in plants (ABE et al. 2012), uses EMS-induced variants and bulk segregant analysis to map a phenotype-causing mutation. We have developed a similar method, which we call “Variant Discovery Mapping”. Our method makes use of background variants in addition to EMS-induced variants (including indels as well as SNPs), and also uses the bulk segregant approach.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
68
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
69 **The conceptual strategy of variant discovery mapping is to perform in silico bulk segregant linkage analysis using variants that are already present in the mutant strain of interest, rather than examining those introduced by a cross to a polymorphic strain.** Any individual mutant strain will contain a certain number of homozygous variants compared to the reference genome. These homozygous variants are of two types: 1) those directly induced during mutagenesis (one or more of which are responsible for the mutant phenotype) (Fig.11A red diamonds) and 2) those already present in the background of the parental strain, either because of genetic drift or because of the parental strain containing, for example, a transgene that was integrated into the genome by irradiation (Fig.11A pale blue diamonds).
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
70
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
71
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
72 .. image:: http://biochemistry.hs.columbia.edu/labs/hobert/CloudMap/Fig.11A_VDM.png
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
73
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
74
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
75 Following an outcross to a non-parental strain and selection of a pool of F2-mutant recombinants, these homozygous variants will segregate according to their degree of linkage to the phenotype-inducing locus. The degree of linkage will be directly reflected in the allele frequency among the pool of recombinants and this can be represented as scatter plots of the ratio of variant reads/total reads present in the pool of sequenced recombinants (Fig.11A). We then plot a loess regression line through all the points on a given chromosome to give greater accuracy to the mapping region (Fig.11B). The loess lines on scatter plots for linked chromosomes approach 1, indicating retention of the original homozygous variants in the linked region. We also draw corresponding frequency plots that display regions of linked chromosomes where pure parental allele variant positions are concentrated (positions where the ratio of variant reads/total reads are equal to 1) (Fig.11B). 1Mb bins for the 0 ratio SNP positions are colored gray by default and .5Mb bins are colored in red.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
76
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
77
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
78 .. image:: http://biochemistry.hs.columbia.edu/labs/hobert/CloudMap/Fig.11B-C_VDM_2.png
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
79
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
80
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
81 ------
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
82
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
83 **Input:**
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
84
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
85 This tool accepts as input a single VCF file containing reference (e.g. Bristol) and alternate (e.g. EMS, background, or crossing strain variant) alleles calls in the pooled mutant sample. This input VCF is generated at an earlier analysis step by running the GATK Unified Genotyper on a BAM alignment file of the pooled mutant sample and selecting only heterozygous or homozygous base positions as determined by the GATK Unified Genotyper (filtered for quality score > Q200). The reader is referred to the user guide and online video for direction on this procedure.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
86
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
87 The CloudMap Variant Discovery Mapping with WGS Data tool supports data from any organism. C. elegans and Arabidopsis are natively supported. For all other organisms, users must provide a simple tab-delimited configuration file containing chromosome numbers and respective lengths (example configuration files for most major organisms provided at http://usegalaxy.org/cloudmap).
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
88
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
89
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
90 **Output:**
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
91
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
92 The tool also provides a tabular output file that contains a count of the number of reference and alternate variants in the pooled mutant sample as well as the ratio of alternate alleles/total reads at each variant position.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
93
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
94
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
95 ------
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
96
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
97 **Settings:**
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
98
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
99 .. class:: infomark
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
100
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
101 Information on loess regression and the loess span parameter:
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
102 http://en.wikipedia.org/wiki/Local_regression
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
103
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
104 .. class:: infomark
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
105
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
106 Based on our testing, we've settled on .4 as a loess span default. Larger values result in smoothing of the line to reflect trends at a more macro level. Smaller values result in loess lines that more closely reflect local data fluctuations.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
107
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
108 .. class:: infomark
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
109
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
110 Supported colors for data points and loess regression line:
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
111
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
112 http://www.stat.columbia.edu/~tzheng/files/Rcolor.pdf
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
113
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
114 http://research.stowers-institute.org/efg/R/Color/Chart/ColorChart.pdf
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
115
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
116
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
117
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
118 .. class:: warningmark
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
119
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
120 This tool requires that the statistical programming environment R has been installed on the system hosting Galaxy (http://www.r-project.org/). If you are running this tool on Galaxy via the Cloud, this does not apply to you.
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
121
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
122
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
123 ------
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
124
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
125 **Citation:**
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
126
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
127 This tool is part of the CloudMap package from the Hobert Lab. If you use this tool, please cite `Gregory Minevich, Danny S Park, Daniel Blankenberg, Richard J. Poole, and Oliver Hobert. CloudMap: A Cloud-based Pipeline for Analysis of Mutant Genome Sequences. (Genetics 2012 In Press)`__
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
128
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
129 .. __: http://biochemistry.hs.columbia.edu/labs/hobert/literature.html
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
130
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
131 Correspondence to gm2123@columbia.edu (G.M.) or or38@columbia.edu (O.H.)
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
132
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
133 </help>
2ce68f42fd3a Uploaded
gregory-minevich
parents:
diff changeset
134 </tool>