annotate QDNAseq-plot.xml @ 84:9af5f22a1fbc draft

Uploaded
author stef
date Thu, 28 May 2015 13:55:00 -0400
parents af698d14e6b5
children 51c657e622c7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
82
60a73de54206 Uploaded
stef
parents: 81
diff changeset
1 <tool id="QDNAseq-plot" name="QDNAseq-plot" version="0.0.1" force_history_refresh="True">
78
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
2
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
3 <requirements>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
4
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
5 <!-- R 3.1.0 dependency will be used instead when available, now default R is used, see command -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
6 <!-- <requirement type="package" version="3.1.0">R</requirement> -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
7 <!-- <requirement type="package" version="1.2.2">qdnaseq</requirement> -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
8
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
9 </requirements>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
10
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
11 <description>Plot QDNAseq copy-number/segments/calls profile</description>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
12
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
13 <!-- change to /full/path/to/Rscript if required (eg /ccagc/lib/R/R-3.1.0/bin/Rscript) -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
14 <command interpreter="Rscript">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
15 QDNAseq-plot.R
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
16 $cfg
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
17 </command>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
18
81
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
19 <version_command interpreter="Rscript">QDNAseq-version.R</version_command>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
20
78
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
21 <stdio>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
22 <!-- Anything higher than 0 means the R script didnt finish (correctly) -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
23 <!-- Because different R packages deal with err/warn differently unable to waterproof this -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
24 <exit_code range="1:" level="fatal" description="R script finished too early, check log" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
25 </stdio>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
26
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
27 <inputs>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
28
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
29 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
30 <!-- General inputs -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
31 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
32
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
33 <!-- Job name: must contain non-whitespace chars -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
34 <param name="jobName" type="text" optional="false" label="Analysis/ouput name" help="Supply a name for the outputs to remind you what they contain" value="TEST">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
35 <!-- <validator type="empty_field" /> -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
36 <validator type="regex" message="No whitespace characters allowed">^[^\s\\]*$</validator>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
37 </param>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
38
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
39 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
40 <!-- Input RDS -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
41 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
42 <param name="rdsFile" type="data" optional="False" format="rds" label="Input RDS file (QDNAseq R object)" help="RDS file should contain a QDNAseq/CGHcall object. If segment and/or call values are present these are added to the plot." />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
43
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
44 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
45 <!-- One pdf with all samples or a png of one chosen sample -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
46 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
47 <!--
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
48 <conditional name="all_or_one">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
49 <param name="show" type="select" label="Plot all samples in RDS object or choose one" help="">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
50 <option value="all">Plot all samples</option>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
51 <option value="one">Choose which one</option>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
52 </param>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
53 <when value="one">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
54 <param name="sample_nr" type="integer" required="True" value="1" label="sample-nr (integer)" help="" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
55 </when>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
56 <when value="all">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
57 <param name="plotAll" type="hidden" value="" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
58 </when>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
59
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
60 </conditional>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
61 -->
81
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
62 <param name="sample_index" type="integer" required="True" value="1" label="Sample-index (integer)" help="The RDS input object can contain data from multiple samples, this index tells the script which one to plot. Plotting multiple samples at the same time is not supported." />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
63
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
64 <conditional name="subset_selection">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
65 <param name="what_to_plot" type="select" label="What to plot" help="Instead of plotting everything in the object you can also select certain chromosomes or set a genomic region">
84
9af5f22a1fbc Uploaded
stef
parents: 83
diff changeset
66 <option value="everything">Everything</option>
81
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
67 <option value="chromosomes">Selected chromosomes</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
68 <option value="region">Genomic region</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
69 </param>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
70 <when value="all">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
71 <!-- ==================== -->
83
af698d14e6b5 Uploaded
stef
parents: 82
diff changeset
72 <param name="chr_name" type="hidden" value="NA" />
af698d14e6b5 Uploaded
stef
parents: 82
diff changeset
73 <param name="chr_start" type="hidden" value="NA" />
af698d14e6b5 Uploaded
stef
parents: 82
diff changeset
74 <param name="chr_end" type="hidden" value="NA" />
af698d14e6b5 Uploaded
stef
parents: 82
diff changeset
75 <param name="chromosomes" type="hidden" value="NA" />
81
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
76 </when>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
77 <when value="chromosomes">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
78 <!-- ==================== -->
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
79 <param name="chromosomes" type="select" multiple="true" optional="false" label="Select chromosomes to plot" help="To zoom in on a particular chromosome you can select one or more here">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
80 <option value="1">1</option><option value="2">2</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
81 <option value="3">3</option><option value="4">4</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
82 <option value="5">5</option><option value="6">6</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
83 <option value="7">7</option><option value="8">8</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
84 <option value="9">9</option><option value="10">10</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
85 <option value="11">11</option><option value="12">12</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
86 <option value="13">13</option><option value="14">14</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
87 <option value="15">15</option><option value="16">16</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
88 <option value="17">17</option><option value="18">18</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
89 <option value="19">19</option><option value="20">20</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
90 <option value="21">21</option><option value="22">22</option>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
91 <!--<option value="X" selected="true">X</option>-->
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
92 <!--<option value="Y" selected="true">Y</option>-->
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
93 </param>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
94 <param name="chr_name" type="hidden" value="NA" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
95 <param name="chr_start" type="hidden" value="NA" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
96 <param name="chr_end" type="hidden" value="NA" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
97 </when>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
98 <when value="region">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
99 <!-- ==================== -->
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
100 <!--
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
101 <param name="genomic_region" type="text" optional="false" label="Genomic region" help="Supply a genomic region in format chr1:12345-23456" value="chr1:12345-23456" size="30">
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
102 <validator type="regex" message="No whitespace characters allowed">^[^\s\\]*$</validator>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
103 <validator type="regex" message="String is not of correct format">^chr\d+\:\d+\-\d+$</validator>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
104 </param>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
105 -->
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
106 <param name="chr_name" size="2" type="integer" optional="false" value="" label="Chromosome" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
107 <param name="chr_start" size="15" type="integer" optional="false" value="" label="Start position on chromosome" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
108 <param name="chr_end" size="15" type="integer" optional="false" value="" label="End position on chromosome" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
109 <param name="chromosomes" type="hidden" value="NA" />
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
110 </when>
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
111
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
112 </conditional>
78
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
113
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
114 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
115 <!-- Optional advanced options -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
116 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
117 <conditional name="advanced">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
118 <param name="show" type="select" label="Extra options" help="Select yes to show extra options">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
119 <option value="no">no</option>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
120 <option value="yes">yes</option>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
121 </param>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
122 <when value="yes">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
123 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
124 <!-- Optional graphical/plotting options -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
125 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
126 <param name="plot_width" size="3" type="integer" value="1440" label="Width of the png image produced" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
127 <param name="plot_height" size="3" type="integer" value="720" label="Height of the png image produced" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
128 </when>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
129
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
130 <!-- need to set defaults because params are passed to R regardless of conditional opened/closed -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
131 <when value="no">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
132 <param name="plot_width" type="hidden" value="1440" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
133 <param name="plot_height" type="hidden" value="720" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
134 </when>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
135 </conditional>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
136
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
137 </inputs>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
138 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
139 <!-- Config file to pass params to R script -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
140 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
141 <configfiles>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
142 <configfile name="cfg">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
143 ## Desc: this file is sourced in QDNAseq-plot.R wrapper script
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
144 ## as means to pass all galaxy params to R
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
145
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
146 ## -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
147 ## required params
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
148 ## -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
149 "${jobName}" -> outputName
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
150 "${outputPng}" -> outputPngPath
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
151 "${rdsFile}" -> rdsFilePath
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
152 as.integer( "${sample_index}" ) -> SAMPLE_INDEX
81
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
153 "${subset_selection.what_to_plot}" -> whatToPlot
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
154 "${subset_selection.chromosomes}" -> chromosomesToPlotString
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
155 "${subset_selection.chr_name}" -> chrName
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
156 "${subset_selection.chr_start}" -> chrStart
5eec30e0fcce Uploaded
stef
parents: 78
diff changeset
157 "${subset_selection.chr_end}" -> chrEnd
78
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
158
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
159 ## -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
160 ## extra options
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
161 ## -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
162 as.integer( "${advanced.plot_width}" ) -> PLOT_WIDTH
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
163 as.integer( "${advanced.plot_height}" ) -> PLOT_HEIGHT
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
164
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
165 </configfile>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
166 </configfiles>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
167
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
168 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
169 <!-- One image as output -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
170 <!-- ==================== -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
171 <outputs>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
172 <data format="png" name="outputPng" label="QDNAseq: ${jobName} PNG plot" />
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
173 <!--
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
174 <data format="png" name="outputPng" label="QDNAseq: ${jobName} PNG plot">
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
175 <filter>(all_or_one['show'] == 'one')</filter>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
176 </data>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
177 -->
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
178 </outputs>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
179
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
180 <help>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
181 .. class:: infomark
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
182
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
183 **Introduction**
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
184
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
185 This tool is a wrapper for the plot function of the R Bioconductor package QDNAseq_
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
186
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
187 .. _QDNAseq: http://www.bioconductor.org/packages/release/bioc/html/QDNAseq.html
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
188
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
189 -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
190
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
191 .. class:: warningmark
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
192
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
193 As there is no R 3.1.0 galaxy-package yet (a requirement for QDNAseq), the **dependencies** need to be installed by hand and available to the user under which galaxy runs: R (3.1.0) and bioconductor package QDNAseq (>= 1.2.2). In case the default R is not 3.1.0, also the wrapper xml must be updated to include the correct path during installation of this tool.
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
194
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
195 -----
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
196
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
197 **Citation**
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
198
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
199 For the underlying QDNAseq R package please cite:
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
200 Scheinin I, Sie D, Bengtsson H, van de Wiel MA, Olshen AB, van Thuijl HF, van Essen HF, Eijk PP, Rustenburg F, Meijer GA, Reijneveld JC, Wesseling P, Pinkel D, Albertson DG and Ylstra B (2014). “DNA copy number analysis of fresh and formalin-fixed specimens by shallow whole-genome sequencing with identification and exclusion of problematic regions in the genome assembly.” Genome Research. doi:10.1101/gr.175141.114.
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
201
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
202 See also the bioconductor package_ documentation.
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
203
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
204 .. _package: http://www.bioconductor.org/packages/release/bioc/html/QDNAseq.html
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
205
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
206 .. image:: LGG150_copynumber.png
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
207 .. image:: LGG150_copynumberSegmented.png
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
208
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
209 </help>
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
210
81ba2f857fe2 Uploaded
stef
parents:
diff changeset
211 </tool>