annotate cnmops.xml @ 4:3d54ff764ad9 draft default tip

Uploaded
author bzonnedda
date Tue, 14 Feb 2017 05:56:44 -0500
parents d9464694f39d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
326477161840 Uploaded
bzonnedda
parents:
diff changeset
1 <tool id="cnmops" name="cn.mops" version="1.0.0">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
2 <description>cnv caller</description>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
3 <requirements>
2
d9464694f39d Uploaded
bzonnedda
parents: 1
diff changeset
4 <requirement type="package" version="1.18.0">bioconductor-cn.mops</requirement>
4
3d54ff764ad9 Uploaded
bzonnedda
parents: 2
diff changeset
5 </requirements>
1
326477161840 Uploaded
bzonnedda
parents:
diff changeset
6 <command interpreter="Rscript">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
7 cnmops.R $args_file
326477161840 Uploaded
bzonnedda
parents:
diff changeset
8 </command>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
9 <configfiles>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
10 <configfile name="args_file">target=$targetFile
326477161840 Uploaded
bzonnedda
parents:
diff changeset
11 padding=$padding
326477161840 Uploaded
bzonnedda
parents:
diff changeset
12 mapping_mode=$mapping_mode
326477161840 Uploaded
bzonnedda
parents:
diff changeset
13 #for $i in $inputs
326477161840 Uploaded
bzonnedda
parents:
diff changeset
14 bam=${i.input}
326477161840 Uploaded
bzonnedda
parents:
diff changeset
15 bam_bai=${i.input.metadata.bam_index}
326477161840 Uploaded
bzonnedda
parents:
diff changeset
16 #if str($i.label.value) != "":
326477161840 Uploaded
bzonnedda
parents:
diff changeset
17 bam_label=${$i.label.value}
326477161840 Uploaded
bzonnedda
parents:
diff changeset
18 #else
326477161840 Uploaded
bzonnedda
parents:
diff changeset
19 bam_label=${i.input.dataset.name}
326477161840 Uploaded
bzonnedda
parents:
diff changeset
20 #end if
326477161840 Uploaded
bzonnedda
parents:
diff changeset
21 #end for
326477161840 Uploaded
bzonnedda
parents:
diff changeset
22 output=$output
326477161840 Uploaded
bzonnedda
parents:
diff changeset
23 #if str($advanced_options.advanced_options_select) == "yes"
326477161840 Uploaded
bzonnedda
parents:
diff changeset
24 advanced_mode=TRUE
326477161840 Uploaded
bzonnedda
parents:
diff changeset
25 $advanced_options.prior_impact=$prior_impact
326477161840 Uploaded
bzonnedda
parents:
diff changeset
26 $advanced_options.cyc=$cyc
326477161840 Uploaded
bzonnedda
parents:
diff changeset
27 $advanced_options.norm=$norm
326477161840 Uploaded
bzonnedda
parents:
diff changeset
28 $advanced_options.norm_type=$norm_type
326477161840 Uploaded
bzonnedda
parents:
diff changeset
29 $advanced_options.upper_threshold=$upper_threshold
326477161840 Uploaded
bzonnedda
parents:
diff changeset
30 $advanced_options.lower_threshold=$lower_threshold
326477161840 Uploaded
bzonnedda
parents:
diff changeset
31 $advanced_options.min_width=$min_width
326477161840 Uploaded
bzonnedda
parents:
diff changeset
32 $advanced_options.seq_alg=$seq_alg
326477161840 Uploaded
bzonnedda
parents:
diff changeset
33 $advanced_options.min_read_count=$min_read_count
326477161840 Uploaded
bzonnedda
parents:
diff changeset
34 $advanced_options.use_median=$use_median
326477161840 Uploaded
bzonnedda
parents:
diff changeset
35 #end if
326477161840 Uploaded
bzonnedda
parents:
diff changeset
36 </configfile>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
37 </configfiles>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
38 <inputs>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
39 <param format="bed" name="targetFile" type="data" label="Target regions (BED)">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
40 <validator type="unspecified_build" />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
41 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
42 <param name="padding" type="integer" value="100" label="Padding" help="Amount of padding (in bp) to add around each target region" />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
43 <param name="mapping_mode" type="select" label="Mapping mode" help="Select whether the mapping algorithm was run using paired or unpaired reads">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
44 <option value="paired" selected="true">paired</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
45 <option value="unpaired">unpaired</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
46 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
47 <repeat name="inputs" title="BAM" min="2" help="Need to add more files? Use controls below.">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
48 <param format="bam" name="input" type="data" label="BAM file">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
49 <options>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
50 <filter type="data_meta" ref="targetFile" key="dbkey"/>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
51 </options>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
52 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
53 <param name="label" type="text" size="30" value="" label="Label" help="Label to use in the output. If not given, the dataset name will be used instead">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
54 <validator type="regex" message="Spaces are not allowed">^\S*$</validator>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
55 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
56 </repeat>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
57
326477161840 Uploaded
bzonnedda
parents:
diff changeset
58 <!-- Advanced options -->
326477161840 Uploaded
bzonnedda
parents:
diff changeset
59 <conditional name="advanced_options">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
60 <param name="advanced_options_select" type="select" label="Show advanced options">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
61 <option value="yes">Yes</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
62 <option value="no" selected="true">No</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
63 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
64 <when value="yes">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
65 <param name="prior_impact" type="integer" value="10" label="Prior impact" help="Positive real value that reflects how strong the prior assumption affects the result. The higher the value the more samples will be assumed to have copy number 2." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
66 <param name="cyc" type="integer" value="20" label="Cycles" help="Positive integer that sets the number of cycles for the algorithm. Usually after less than 15 cycles convergence is reached." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
67 <param name="norm" type="boolean" truevalue="TRUE" falsevalue="FALSE" checked="true" label="Apply normalization" help="" />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
68 <param name="norm_type" type="select" label="Normalization type" help="Mode of the normalization technique. Read counts will be scaled sample-wise.">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
69 <option value="poisson" selected="true">poisson</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
70 <option value="mean">mean</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
71 <option value="min">min</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
72 <option value="median">median</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
73 <option value="quant">quant</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
74 <option value="mode">mode</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
75 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
76 <param name="upper_threshold" type="float" value="0.55" label="Cut-off for copy number gains" help="All CNV calling values above this value will be called as gain. The value should be set close to the log2 of the expected foldchange for copy number 3 or 4." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
77 <param name="lower_threshold" type="float" value="-0.8" label="Cut-off for copy number losses" help="All CNV calling values below this value will be called as loss. The value should be set close to the log2 of the expected foldchange for copy number 1 or 0." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
78 <param name="min_width" type="integer" value="5" label="Minimum width" help="Minimum number of segments a CNV should span." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
79 <param name="seq_alg" type="select" label="Segmentation algorithm" help="">
326477161840 Uploaded
bzonnedda
parents:
diff changeset
80 <option value="fast" selected="false">fast</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
81 <option value="DNAcopy">DNAcopy</option>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
82 </param>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
83 <param name="min_read_count" type="integer" value="1" label="Minimum read count" help="If all samples are below this value the algorithm will return the prior knowledge. This prevents the algorithm from being applied to segments with very low coverage." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
84 <param name="use_median" type="boolean" truevalue="TRUE" falsevalue="FALSE" checked="false" label="Use median" help="Whether median instead of mean of a target region should be used for the CNV call." />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
85 </when>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
86 <when value="no" />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
87 </conditional>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
88 </inputs>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
89 <outputs>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
90 <data format="bed" name="output" label="${tool.name} on ${on_string}" />
326477161840 Uploaded
bzonnedda
parents:
diff changeset
91 </outputs>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
92 <help>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
93
326477161840 Uploaded
bzonnedda
parents:
diff changeset
94 **What it does**
326477161840 Uploaded
bzonnedda
parents:
diff changeset
95
326477161840 Uploaded
bzonnedda
parents:
diff changeset
96 This tool uses cn.mops (Copy Number estimation by a Mixture Of PoissonS) to call copy number variations
326477161840 Uploaded
bzonnedda
parents:
diff changeset
97 and aberrations (CNVs and CNAs) from targeted next generation sequencing (NGS) data.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
98
326477161840 Uploaded
bzonnedda
parents:
diff changeset
99 **Output format**
326477161840 Uploaded
bzonnedda
parents:
diff changeset
100
326477161840 Uploaded
bzonnedda
parents:
diff changeset
101 ========== ========================
326477161840 Uploaded
bzonnedda
parents:
diff changeset
102 Column Description
326477161840 Uploaded
bzonnedda
parents:
diff changeset
103 ---------- ------------------------
326477161840 Uploaded
bzonnedda
parents:
diff changeset
104 chr Chromosome
326477161840 Uploaded
bzonnedda
parents:
diff changeset
105 starts Start of CNV region
326477161840 Uploaded
bzonnedda
parents:
diff changeset
106 ends End of CNV region
326477161840 Uploaded
bzonnedda
parents:
diff changeset
107 sampleName Name of the sample with CNV
326477161840 Uploaded
bzonnedda
parents:
diff changeset
108 median Median value of CNV
326477161840 Uploaded
bzonnedda
parents:
diff changeset
109 mean Mean value of CNV
326477161840 Uploaded
bzonnedda
parents:
diff changeset
110 CN Copy number class (see below)
326477161840 Uploaded
bzonnedda
parents:
diff changeset
111 ========== ========================
326477161840 Uploaded
bzonnedda
parents:
diff changeset
112
326477161840 Uploaded
bzonnedda
parents:
diff changeset
113 Copy number classes are identified as follows::
326477161840 Uploaded
bzonnedda
parents:
diff changeset
114
326477161840 Uploaded
bzonnedda
parents:
diff changeset
115 CN2: normal copy number for diploid samples
326477161840 Uploaded
bzonnedda
parents:
diff changeset
116 CN1: heterozygous deletion
326477161840 Uploaded
bzonnedda
parents:
diff changeset
117 CN0: homozygous deletion
326477161840 Uploaded
bzonnedda
parents:
diff changeset
118 CN3 - CN8: amplifications
326477161840 Uploaded
bzonnedda
parents:
diff changeset
119
326477161840 Uploaded
bzonnedda
parents:
diff changeset
120 For non-tumor samples the highest copy number class is 8 - higher copy numbers have not been reported.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
121 CN8 is expected to have 4 times as many reads (for times as high coverage) as CN2.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
122 For tumor samples very high copy numbers have been observed (e.g. CN64),
326477161840 Uploaded
bzonnedda
parents:
diff changeset
123 therefore the parameters of cn.mops have to be adjusted to allow for high copy numbers.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
124 A way to set the parameters is given in https://gist.github.com/gklambauer/8955203
326477161840 Uploaded
bzonnedda
parents:
diff changeset
125
326477161840 Uploaded
bzonnedda
parents:
diff changeset
126 **License and citation**
326477161840 Uploaded
bzonnedda
parents:
diff changeset
127
326477161840 Uploaded
bzonnedda
parents:
diff changeset
128 This Galaxy tool is Copyright © 2015 `CRS4 Srl.`_ and is released under the `MIT license`_.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
129
326477161840 Uploaded
bzonnedda
parents:
diff changeset
130 .. _CRS4 Srl.: http://www.crs4.it/
326477161840 Uploaded
bzonnedda
parents:
diff changeset
131 .. _MIT license: http://opensource.org/licenses/MIT
326477161840 Uploaded
bzonnedda
parents:
diff changeset
132
326477161840 Uploaded
bzonnedda
parents:
diff changeset
133 You can use this tool only if you agree to the license terms of: `cn.mops`_.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
134
326477161840 Uploaded
bzonnedda
parents:
diff changeset
135 .. _cn.mops: http://bioconductor.org/packages/release/bioc/html/cn.mops.html
326477161840 Uploaded
bzonnedda
parents:
diff changeset
136
326477161840 Uploaded
bzonnedda
parents:
diff changeset
137 If you use this tool, please cite:
326477161840 Uploaded
bzonnedda
parents:
diff changeset
138
326477161840 Uploaded
bzonnedda
parents:
diff changeset
139 - |Cuccuru2014|_
326477161840 Uploaded
bzonnedda
parents:
diff changeset
140 - |Klambauer2012|_.
326477161840 Uploaded
bzonnedda
parents:
diff changeset
141
326477161840 Uploaded
bzonnedda
parents:
diff changeset
142 .. |Cuccuru2014| replace:: Cuccuru, G., Orsini, M., Pinna, A., Sbardellati, A., Soranzo, N., Travaglione, A., Uva, P., Zanetti, G., Fotia, G. (2014) Orione, a web-based framework for NGS analysis in microbiology. *Bioinformatics* 30(13), 1928-1929
326477161840 Uploaded
bzonnedda
parents:
diff changeset
143 .. _Cuccuru2014: http://bioinformatics.oxfordjournals.org/content/30/13/1928
326477161840 Uploaded
bzonnedda
parents:
diff changeset
144 .. |Klambauer2012| replace:: Klambauer, G., *et al.* (2012) cn.MOPS: Mixture of Poissons for Discovering Copy Number Variations in Next Generation Sequencing Data with a Low False Discovery Rate. *Nucleic Acids Research* 40, e69
326477161840 Uploaded
bzonnedda
parents:
diff changeset
145 .. _Klambauer2012: http://http://nar.oxfordjournals.org/content/40/9/e69
326477161840 Uploaded
bzonnedda
parents:
diff changeset
146 </help>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
147 <citations>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
148 <citation type="doi">10.1093/bioinformatics/btu135</citation>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
149 <citation type="doi">10.1093/nar/gks003</citation>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
150 </citations>
326477161840 Uploaded
bzonnedda
parents:
diff changeset
151 </tool>