|
1
|
1 <tool id="exdep" name="ExDep" version="1.0.0">
|
|
|
2 <description>cnv caller</description>
|
|
|
3 <requirements>
|
|
|
4 <requirement type="package" version="1.1.10">r-exomedepth</requirement>
|
|
|
5 </requirements>
|
|
|
6 <command>
|
|
|
7 R CMD BATCH --no-save --no-restore '--args mypars=\"$args_file\"' exomedepth.R /dev/null
|
|
|
8 </command>
|
|
|
9 <inputs>
|
|
|
10 <param format="bed" name="targetFile" type="data" label="Target regions (BED)">
|
|
|
11 <validator type="unspecified_build" />
|
|
|
12 </param>
|
|
|
13 <param name="test_vs_ref" type="boolean" truevalue="TRUE" falsevalue="FALSE" checked="false" label="Call CNVs using 1st sample as test" help="If checked, the tool will call CNVs in the first sample vs all the others. If unchecked, an all vs all CNV call will be performed" />
|
|
|
14 <repeat name="inputs" title="BAM" min="2" help="Need to add more files? Use controls below.">
|
|
|
15 <param format="bam" name="input" type="data" label="BAM file">
|
|
|
16 <options>
|
|
|
17 <filter type="data_meta" ref="targetFile" key="dbkey"/>
|
|
|
18 </options>
|
|
|
19 </param>
|
|
|
20 <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">
|
|
|
21 <validator type="regex" message="Spaces are not allowed">^\S*$</validator>
|
|
|
22 </param>
|
|
|
23 </repeat>
|
|
|
24 <param name="transition_probability" size="10" type="float" value="0.0001" label="Transition probability" help="Transition probability of the hidden Markov Chain from the normal copy number state to either a deletion or a duplication. The default value (0.0001) expects approximately 20 CNVs genome-wide" />
|
|
|
25 </inputs>
|
|
|
26
|
|
|
27 <configfiles>
|
|
|
28 <configfile name="args_file">target=$targetFile
|
|
|
29 test_vs_ref=$test_vs_ref
|
|
|
30 #for $i in $inputs
|
|
|
31 bam=${i.input}
|
|
|
32 bam_bai=${i.input.metadata.bam_index}
|
|
|
33 #if str($i.label.value) != "":
|
|
|
34 bam_label=${$i.label.value}
|
|
|
35 #else
|
|
|
36 bam_label=${i.input.dataset.name}
|
|
|
37 #end if
|
|
|
38 #end for
|
|
|
39 trans_prob=$transition_probability
|
|
|
40 output=$output
|
|
|
41 </configfile>
|
|
|
42 </configfiles>
|
|
|
43 <outputs>
|
|
|
44 <data format="bed" name="output" label="${tool.name} on ${on_string}" />
|
|
|
45 </outputs>
|
|
|
46 <help>
|
|
|
47
|
|
|
48 .. class:: warningmark
|
|
|
49
|
|
|
50 **Warning about counts for chromosome X**
|
|
|
51
|
|
|
52 Calling CNVs on the X chromosome can create issues if the exome sample of interest and the reference exome
|
|
|
53 samples it is being compared to are not gender matched.
|
|
|
54 Make sure that the genders are matched properly (i.e. do not use male as a reference for female
|
|
|
55 samples and vice versa).
|
|
|
56
|
|
|
57 **What it does**
|
|
|
58
|
|
|
59 This tool uses ExomeDepth to call copy number variants (CNVs) from targeted sequence data.
|
|
|
60
|
|
|
61 **Output format**
|
|
|
62
|
|
|
63 =========== ========================
|
|
|
64 Column Description
|
|
|
65 ----------- ------------------------
|
|
|
66 chr Chromosome
|
|
|
67 start Start of CNV region
|
|
|
68 end End of CNV region
|
|
|
69 type CNV type (deletion, duplication)
|
|
|
70 sample Name of the sample with CNV
|
|
|
71 corr Correlation between reference and test counts. To get meaningful result, this correlation should really be above 0.97. If this is not the case, consider the output of ExomeDepth as less reliable (i.e. most likely a high false positive rate)
|
|
|
72 nexons Number of target regions covered by the CNV
|
|
|
73 BF Bayes factor. It quantifies the statistical support for each CNV. It is in fact the log10 of the likelihood ratio of data for the CNV call divided by the null (normal copy number). The higher that number, the more confident one can be about the presence of a CNV. While it is difficult to give an ideal threshold, and for short exons the Bayes Factor are bound to be unconvincing, the most obvious large calls should be easily flagged by ranking them according to this quantity
|
|
|
74 reads.ratio Observed/expected reads ratio
|
|
|
75 =========== ========================
|
|
|
76
|
|
|
77
|
|
|
78 **What ExomeDepth does and does not do**
|
|
|
79
|
|
|
80 ExomeDepth uses read depth data to call CNVs from exome sequencing experiments. A key idea is that the test
|
|
|
81 exome should be compared to a matched aggregate reference set. This aggregate reference set should combine
|
|
|
82 exomes from the same batch and it should also be optimized for each exome. It will certainly differ from one exome
|
|
|
83 to the next.
|
|
|
84
|
|
|
85 Importantly, ExomeDepth assumes that the CNV of interest is absent from the aggregate reference set. Hence
|
|
|
86 related individuals should be excluded from the aggregate reference. It also means that ExomeDepth can miss
|
|
|
87 common CNVs, if the call is also present in the aggregate reference. ExomeDepth is really suited to detect rare
|
|
|
88 CNV calls (typically for rare Mendelian disorder analysis).
|
|
|
89
|
|
|
90 The ideas used in this package are of course not specific to exome sequencing and could be applied to other
|
|
|
91 targeted sequencing datasets, as long as they contain a sufficiently large number of exons to estimate the parameters
|
|
|
92 (at least 20 genes, say, but probably more would be useful). Also note that PCR based enrichment studies are often
|
|
|
93 not well suited for this type of read depth analysis. The reason is that as the number of cycles is often set to a high
|
|
|
94 number in order to equalize the representation of each amplicon, which can discard the CNV information.
|
|
|
95
|
|
|
96 **License and citation**
|
|
|
97
|
|
|
98 This Galaxy tool is Copyright © 2014 `CRS4 Srl.`_ and is released under the `MIT license`_.
|
|
|
99
|
|
|
100 .. _CRS4 Srl.: http://www.crs4.it/
|
|
|
101 .. _MIT license: http://opensource.org/licenses/MIT
|
|
|
102
|
|
|
103 You can use this tool only if you agree to the license terms of: `ExomeDepth`_.
|
|
|
104
|
|
|
105 .. _ExomeDepth: http://cran.r-project.org/web/packages/ExomeDepth/
|
|
|
106
|
|
|
107 If you use this tool, please cite:
|
|
|
108
|
|
|
109 - |Cuccuru2014|_
|
|
|
110 - |Plagnol2012|_.
|
|
|
111
|
|
|
112 .. |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
|
|
|
113 .. _Cuccuru2014: http://bioinformatics.oxfordjournals.org/content/30/13/1928
|
|
|
114 .. |Plagnol2012| replace:: Plagnol, V., *et al.* (2012) A robust model for read count data in exome sequencing experiments and implications for copy number variant calling. *Bioinformatics* 28(21), 2747-2754
|
|
|
115 .. _Plagnol2012: http://bioinformatics.oxfordjournals.org/content/28/21/2747
|
|
|
116 </help>
|
|
|
117 <citations>
|
|
|
118 <citation type="doi">10.1093/bioinformatics/btu135</citation>
|
|
|
119 <citation type="doi">10.1093/bioinformatics/bts526</citation>
|
|
|
120 </citations>
|
|
|
121 </tool>
|
