annotate QDNAseq-plot.xml @ 24:ab1ab10c68af draft

Uploaded
author stef
date Wed, 04 Mar 2015 08:40:49 -0500
parents 4943308e95fc
children f89205f51e27
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
23
4943308e95fc Uploaded
stef
parents:
diff changeset
1 <tool id="QDNAseq-plot" name="QDNAseq-plot" version="0.0.1" force_history_refresh="True">
4943308e95fc Uploaded
stef
parents:
diff changeset
2
4943308e95fc Uploaded
stef
parents:
diff changeset
3 <requirements>
4943308e95fc Uploaded
stef
parents:
diff changeset
4
4943308e95fc Uploaded
stef
parents:
diff changeset
5 <!-- R 3.1.0 dependency will be used instead when available, now default R is used, see command -->
4943308e95fc Uploaded
stef
parents:
diff changeset
6 <!-- <requirement type="package" version="3.1.0">R</requirement> -->
4943308e95fc Uploaded
stef
parents:
diff changeset
7 <!-- <requirement type="package" version="1.2.2">qdnaseq</requirement> -->
4943308e95fc Uploaded
stef
parents:
diff changeset
8
4943308e95fc Uploaded
stef
parents:
diff changeset
9 </requirements>
4943308e95fc Uploaded
stef
parents:
diff changeset
10
4943308e95fc Uploaded
stef
parents:
diff changeset
11 <description>Plot QDNAseq copy-number/segments/calls profile</description>
4943308e95fc Uploaded
stef
parents:
diff changeset
12
4943308e95fc Uploaded
stef
parents:
diff changeset
13 <!-- change to /full/path/to/Rscript if required (eg /ccagc/lib/R/R-3.1.0/bin/Rscript) -->
4943308e95fc Uploaded
stef
parents:
diff changeset
14 <command interpreter="Rscript">
4943308e95fc Uploaded
stef
parents:
diff changeset
15 QDNAseq-plot.R
4943308e95fc Uploaded
stef
parents:
diff changeset
16 $cfg
4943308e95fc Uploaded
stef
parents:
diff changeset
17 </command>
4943308e95fc Uploaded
stef
parents:
diff changeset
18
4943308e95fc Uploaded
stef
parents:
diff changeset
19 <stdio>
4943308e95fc Uploaded
stef
parents:
diff changeset
20 <!-- Anything higher than 0 means the R script didnt finish (correctly) -->
4943308e95fc Uploaded
stef
parents:
diff changeset
21 <!-- Because different R packages deal with err/warn differently unable to waterproof this -->
4943308e95fc Uploaded
stef
parents:
diff changeset
22 <exit_code range="1:" level="fatal" description="R script finished too early, check log" />
4943308e95fc Uploaded
stef
parents:
diff changeset
23 </stdio>
4943308e95fc Uploaded
stef
parents:
diff changeset
24
4943308e95fc Uploaded
stef
parents:
diff changeset
25 <inputs>
4943308e95fc Uploaded
stef
parents:
diff changeset
26
4943308e95fc Uploaded
stef
parents:
diff changeset
27 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
28 <!-- General inputs -->
4943308e95fc Uploaded
stef
parents:
diff changeset
29 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
30
4943308e95fc Uploaded
stef
parents:
diff changeset
31 <!-- Job name: must contain non-whitespace chars -->
4943308e95fc Uploaded
stef
parents:
diff changeset
32 <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">
4943308e95fc Uploaded
stef
parents:
diff changeset
33 <!-- <validator type="empty_field" /> -->
4943308e95fc Uploaded
stef
parents:
diff changeset
34 <validator type="regex" message="No whitespace characters allowed">^[^\s\\]*$</validator>
4943308e95fc Uploaded
stef
parents:
diff changeset
35 </param>
4943308e95fc Uploaded
stef
parents:
diff changeset
36
4943308e95fc Uploaded
stef
parents:
diff changeset
37 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
38 <!-- Input RDS -->
4943308e95fc Uploaded
stef
parents:
diff changeset
39 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
40 <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." />
4943308e95fc Uploaded
stef
parents:
diff changeset
41
4943308e95fc Uploaded
stef
parents:
diff changeset
42 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
43 <!-- One pdf with all samples or a png of one chosen sample -->
4943308e95fc Uploaded
stef
parents:
diff changeset
44 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
45 <!--
4943308e95fc Uploaded
stef
parents:
diff changeset
46 <conditional name="all_or_one">
4943308e95fc Uploaded
stef
parents:
diff changeset
47 <param name="show" type="select" label="Plot all samples in RDS object or choose one" help="">
4943308e95fc Uploaded
stef
parents:
diff changeset
48 <option value="all">Plot all samples</option>
4943308e95fc Uploaded
stef
parents:
diff changeset
49 <option value="one">Choose which one</option>
4943308e95fc Uploaded
stef
parents:
diff changeset
50 </param>
4943308e95fc Uploaded
stef
parents:
diff changeset
51 <when value="one">
4943308e95fc Uploaded
stef
parents:
diff changeset
52 <param name="sample_nr" type="integer" required="True" value="1" label="sample-nr (integer)" help="" />
4943308e95fc Uploaded
stef
parents:
diff changeset
53 </when>
4943308e95fc Uploaded
stef
parents:
diff changeset
54 <when value="all">
4943308e95fc Uploaded
stef
parents:
diff changeset
55 <param name="plotAll" type="hidden" value="" />
4943308e95fc Uploaded
stef
parents:
diff changeset
56 </when>
4943308e95fc Uploaded
stef
parents:
diff changeset
57
4943308e95fc Uploaded
stef
parents:
diff changeset
58 </conditional>
4943308e95fc Uploaded
stef
parents:
diff changeset
59 -->
4943308e95fc Uploaded
stef
parents:
diff changeset
60 <param name="sample_index" type="integer" required="True" value="1" label="Sample-index (integer)" help="The RDS input object can contain data from multiple individuals, this number tells the script which one to plot. Plotting multiple at the same time is not supported." />
4943308e95fc Uploaded
stef
parents:
diff changeset
61
4943308e95fc Uploaded
stef
parents:
diff changeset
62 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
63 <!-- Optional advanced options -->
4943308e95fc Uploaded
stef
parents:
diff changeset
64 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
65 <conditional name="advanced">
4943308e95fc Uploaded
stef
parents:
diff changeset
66 <param name="show" type="select" label="Extra options" help="Select yes to show extra options">
4943308e95fc Uploaded
stef
parents:
diff changeset
67 <option value="no">no</option>
4943308e95fc Uploaded
stef
parents:
diff changeset
68 <option value="yes">yes</option>
4943308e95fc Uploaded
stef
parents:
diff changeset
69 </param>
4943308e95fc Uploaded
stef
parents:
diff changeset
70 <when value="yes">
4943308e95fc Uploaded
stef
parents:
diff changeset
71 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
72 <!-- Optional graphical/plotting options -->
4943308e95fc Uploaded
stef
parents:
diff changeset
73 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
74 <param name="plot_width" size="3" type="integer" value="1440" label="Width of the png image produced" />
4943308e95fc Uploaded
stef
parents:
diff changeset
75 <param name="plot_height" size="3" type="integer" value="720" label="Height of the png image produced" />
4943308e95fc Uploaded
stef
parents:
diff changeset
76 </when>
4943308e95fc Uploaded
stef
parents:
diff changeset
77
4943308e95fc Uploaded
stef
parents:
diff changeset
78 <!-- need to set defaults because params are passed to R regardless of conditional opened/closed -->
4943308e95fc Uploaded
stef
parents:
diff changeset
79 <when value="no">
4943308e95fc Uploaded
stef
parents:
diff changeset
80 <param name="plot_width" type="hidden" value="1440" />
4943308e95fc Uploaded
stef
parents:
diff changeset
81 <param name="plot_height" type="hidden" value="720" />
4943308e95fc Uploaded
stef
parents:
diff changeset
82 </when>
4943308e95fc Uploaded
stef
parents:
diff changeset
83 </conditional>
4943308e95fc Uploaded
stef
parents:
diff changeset
84
4943308e95fc Uploaded
stef
parents:
diff changeset
85 </inputs>
4943308e95fc Uploaded
stef
parents:
diff changeset
86 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
87 <!-- Config file to pass params to R script -->
4943308e95fc Uploaded
stef
parents:
diff changeset
88 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
89 <configfiles>
4943308e95fc Uploaded
stef
parents:
diff changeset
90 <configfile name="cfg">
4943308e95fc Uploaded
stef
parents:
diff changeset
91 ## Desc: this file is sourced in QDNAseq-plot.R wrapper script
4943308e95fc Uploaded
stef
parents:
diff changeset
92 ## as means to pass all galaxy params to R
4943308e95fc Uploaded
stef
parents:
diff changeset
93
4943308e95fc Uploaded
stef
parents:
diff changeset
94 ## -----
4943308e95fc Uploaded
stef
parents:
diff changeset
95 ## required params
4943308e95fc Uploaded
stef
parents:
diff changeset
96 ## -----
4943308e95fc Uploaded
stef
parents:
diff changeset
97 "${jobName}" -> outputName
4943308e95fc Uploaded
stef
parents:
diff changeset
98 "${outputPng}" -> outputPngPath
4943308e95fc Uploaded
stef
parents:
diff changeset
99 "${rdsFile}" -> rdsFilePath
4943308e95fc Uploaded
stef
parents:
diff changeset
100 as.integer( "${sample_index}" ) -> SAMPLE_INDEX
4943308e95fc Uploaded
stef
parents:
diff changeset
101
4943308e95fc Uploaded
stef
parents:
diff changeset
102 ## -----
4943308e95fc Uploaded
stef
parents:
diff changeset
103 ## extra options
4943308e95fc Uploaded
stef
parents:
diff changeset
104 ## -----
4943308e95fc Uploaded
stef
parents:
diff changeset
105 as.integer( "${advanced.plot_width}" ) -> PLOT_WIDTH
4943308e95fc Uploaded
stef
parents:
diff changeset
106 as.integer( "${advanced.plot_height}" ) -> PLOT_HEIGHT
4943308e95fc Uploaded
stef
parents:
diff changeset
107
4943308e95fc Uploaded
stef
parents:
diff changeset
108 </configfile>
4943308e95fc Uploaded
stef
parents:
diff changeset
109 </configfiles>
4943308e95fc Uploaded
stef
parents:
diff changeset
110
4943308e95fc Uploaded
stef
parents:
diff changeset
111 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
112 <!-- One image as output -->
4943308e95fc Uploaded
stef
parents:
diff changeset
113 <!-- ==================== -->
4943308e95fc Uploaded
stef
parents:
diff changeset
114 <outputs>
4943308e95fc Uploaded
stef
parents:
diff changeset
115 <data format="png" name="outputPng" label="QDNAseq: ${jobName} PNG plot" />
4943308e95fc Uploaded
stef
parents:
diff changeset
116 <!--
4943308e95fc Uploaded
stef
parents:
diff changeset
117 <data format="png" name="outputPng" label="QDNAseq: ${jobName} PNG plot">
4943308e95fc Uploaded
stef
parents:
diff changeset
118 <filter>(all_or_one['show'] == 'one')</filter>
4943308e95fc Uploaded
stef
parents:
diff changeset
119 </data>
4943308e95fc Uploaded
stef
parents:
diff changeset
120 -->
4943308e95fc Uploaded
stef
parents:
diff changeset
121 </outputs>
4943308e95fc Uploaded
stef
parents:
diff changeset
122
4943308e95fc Uploaded
stef
parents:
diff changeset
123 <help>
4943308e95fc Uploaded
stef
parents:
diff changeset
124 .. class:: infomark
4943308e95fc Uploaded
stef
parents:
diff changeset
125
4943308e95fc Uploaded
stef
parents:
diff changeset
126 **Introduction**
4943308e95fc Uploaded
stef
parents:
diff changeset
127
4943308e95fc Uploaded
stef
parents:
diff changeset
128 This tool is a wrapper for the plot function of the R Bioconductor package QDNAseq_
4943308e95fc Uploaded
stef
parents:
diff changeset
129
4943308e95fc Uploaded
stef
parents:
diff changeset
130 .. _QDNAseq: http://www.bioconductor.org/packages/release/bioc/html/QDNAseq.html
4943308e95fc Uploaded
stef
parents:
diff changeset
131
4943308e95fc Uploaded
stef
parents:
diff changeset
132 -----
4943308e95fc Uploaded
stef
parents:
diff changeset
133
4943308e95fc Uploaded
stef
parents:
diff changeset
134 .. class:: warningmark
4943308e95fc Uploaded
stef
parents:
diff changeset
135
4943308e95fc Uploaded
stef
parents:
diff changeset
136 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.
4943308e95fc Uploaded
stef
parents:
diff changeset
137
4943308e95fc Uploaded
stef
parents:
diff changeset
138 -----
4943308e95fc Uploaded
stef
parents:
diff changeset
139
4943308e95fc Uploaded
stef
parents:
diff changeset
140 **Citation**
4943308e95fc Uploaded
stef
parents:
diff changeset
141
4943308e95fc Uploaded
stef
parents:
diff changeset
142 For the underlying QDNAseq R package please cite:
4943308e95fc Uploaded
stef
parents:
diff changeset
143 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.
4943308e95fc Uploaded
stef
parents:
diff changeset
144
4943308e95fc Uploaded
stef
parents:
diff changeset
145 See also the bioconductor package_ documentation.
4943308e95fc Uploaded
stef
parents:
diff changeset
146
4943308e95fc Uploaded
stef
parents:
diff changeset
147 .. _package: http://www.bioconductor.org/packages/release/bioc/html/QDNAseq.html
4943308e95fc Uploaded
stef
parents:
diff changeset
148
4943308e95fc Uploaded
stef
parents:
diff changeset
149 .. image:: LGG150_copynumber.png
4943308e95fc Uploaded
stef
parents:
diff changeset
150 .. image:: LGG150_copynumberSegmented.png
4943308e95fc Uploaded
stef
parents:
diff changeset
151
4943308e95fc Uploaded
stef
parents:
diff changeset
152 </help>
4943308e95fc Uploaded
stef
parents:
diff changeset
153
4943308e95fc Uploaded
stef
parents:
diff changeset
154 </tool>