annotate QDNAseq-plot.xml @ 78:81ba2f857fe2 draft

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