comparison macros_xcms.xml @ 13:91c71f3808f3 draft

planemo upload for repository https://github.com/workflow4metabolomics/xcms commit 9f72e947d9c241d11221cad561f3525d27231857
author lecorguille
date Tue, 18 Sep 2018 16:13:36 -0400
parents
children 34fe699200ce
comparison
equal deleted inserted replaced
12:dcb9041cb9ea 13:91c71f3808f3
1 <?xml version="1.0"?>
2 <macros>
3
4 <token name="@WRAPPER_VERSION@">3.0.0</token>
5 <xml name="requirements">
6 <requirements>
7 <requirement type="package" version="@WRAPPER_VERSION@">bioconductor-xcms</requirement>
8 <requirement type="package" version="1.1_4">r-batch</requirement>
9 <requirement type="package" version="1.1_2">r-rcolorbrewer</requirement>
10 <requirement type="package" version="6.0">unzip</requirement>
11 <yield />
12 </requirements>
13 </xml>
14
15 <!-- FILE_LOAD for planemo test -->
16 <token name="@COMMAND_FILE_LOAD@">
17 #if $file_load_section.file_load_conditional.file_load_select == "yes":
18 #if $file_load_section.file_load_conditional.input[0].is_of_type("mzxml") or $file_load_section.file_load_conditional.input[0].is_of_type("mzml") or $file_load_section.file_load_conditional.input[0].is_of_type("mzdata") or $file_load_section.file_load_conditional.input[0].is_of_type("netcdf"):
19 #set singlefile_galaxyPath = '|'.join( [ str( $single_file ) for $single_file in $file_load_section.file_load_conditional.input ] )
20 #set singlefile_sampleName = '|'.join( [ str( $single_file.name ) for $single_file in $file_load_section.file_load_conditional.input ] )
21
22 singlefile_galaxyPath '$singlefile_galaxyPath' singlefile_sampleName '$singlefile_sampleName'
23 #else
24 zipfile '$file_load_section.file_load_conditional.input'
25 #end if
26 #end if
27 </token>
28
29 <xml name="input_file_load">
30 <section name="file_load_section" title="Resubmit your raw dataset or your zip file">
31 <conditional name="file_load_conditional">
32 <param name="file_load_select" type="select" label="Resubmit your dataset or your zip file" help="Use only if you get a message saying that your original dataset or zip file have been deleted on the server." >
33 <option value="no" >no need</option>
34 <option value="yes" >yes</option>
35 </param>
36 <when value="no">
37 </when>
38 <when value="yes">
39 <param name="input" type="data" format="mzxml,mzml,mzdata,netcdf,no_unzip.zip,zip" multiple="true" label="File(s) from your history containing your chromatograms" help="Single file mode for the format: mzxml, mzml, mzdata and netcdf. Zip file mode for the format: no_unzip.zip, zip. See the help section below." />
40 </when>
41 </conditional>
42 </section>
43 </xml>
44
45 <xml name="test_file_load_zip">
46 <section name="file_load_section">
47 <conditional name="file_load_conditional">
48 <param name="file_load_select" value="yes" />
49 <param name="input" value="faahKO_reduce.zip" ftype="zip" />
50 </conditional>
51 </section>
52 </xml>
53
54 <xml name="test_file_load_zip_sacuri">
55 <section name="file_load_section">
56 <conditional name="file_load_conditional">
57 <param name="file_load_select" value="yes" />
58 <param name="input" value="sacuri_dir_root.zip" ftype="zip" />
59 </conditional>
60 </section>
61 </xml>
62
63 <xml name="test_file_load_single">
64 <section name="file_load_section">
65 <conditional name="file_load_conditional">
66 <param name="file_load_select" value="yes" />
67 <param name="input" value="wt15.CDF,ko16.CDF,ko15.CDF,wt16.CDF" ftype="netcdf" />
68 </conditional>
69 </section>
70 </xml>
71
72 <xml name="test_file_load_single_ko15">
73 <section name="file_load_section">
74 <conditional name="file_load_conditional">
75 <param name="file_load_select" value="yes" />
76 <param name="input" value="ko15.CDF" ftype="netcdf" />
77 </conditional>
78 </section>
79 </xml>
80
81 <!-- PEAKLIST -->
82 <token name="@COMMAND_PEAKLIST@">
83 #if $peaklist.peaklistBool
84 convertRTMinute $peaklist.convertRTMinute
85 numDigitsMZ $peaklist.numDigitsMZ
86 numDigitsRT $peaklist.numDigitsRT
87 intval $peaklist.intval
88 naTOzero $peaklist.naTOzero
89 #end if
90 </token>
91
92 <xml name="input_peaklist">
93 <conditional name="peaklist">
94 <param name="peaklistBool" type="boolean" label="Get a Peak List" />
95 <when value="true">
96 <param name="convertRTMinute" type="boolean" checked="false" truevalue="TRUE" falsevalue="FALSE" label="Convert retention time (seconds) into minutes" help="Convert the columns rtmed, rtmin and rtmax into minutes"/>
97 <param name="numDigitsMZ" type="integer" value="4" label="Number of decimal places for mass values reported in ions' identifiers." help="A minimum of 4 decimal places is recommended. Useful to avoid duplicates within identifiers" />
98 <param name="numDigitsRT" type="integer" value="0" label="Number of decimal places for retention time values reported in ions' identifiers." help="Useful to avoid duplicates within identifiers" />
99 <param name="intval" type="select" label="Reported intensity values" help="[intval] See the help section below">
100 <option value="into" selected="true">into</option>
101 <option value="maxo">maxo</option>
102 <option value="intb">intb</option>
103 </param>
104 <param name="naTOzero" type="boolean" checked="true" truevalue="TRUE" falsevalue="FALSE" label="Replace the remain NA by 0 in the dataMatrix" help="Rather mandatory for some downstream statistical steps"/>
105 </when>
106 <when value="false" />
107 </conditional>
108 </xml>
109
110 <xml name="output_peaklist" token_function="">
111 <data name="variableMetadata" format="tabular" label="${image.name[:-6]}.@FUNCTION@.variableMetadata.tsv" from_work_dir="variableMetadata.tsv" >
112 <filter>(peaklist['peaklistBool'])</filter>
113 </data>
114 <data name="dataMatrix" format="tabular" label="${image.name[:-6]}.@FUNCTION@.dataMatrix.tsv" from_work_dir="dataMatrix.tsv" >
115 <filter>(peaklist['peaklistBool'])</filter>
116 </data>
117 </xml>
118
119 <token name="@HELP_PEAKLIST@">
120
121 Get a Peak List
122 ---------------
123
124 If 'true', the module generates two additional files corresponding to the peak list:
125 - the variable metadata file (corresponding to information about extracted ions such as mass or retention time)
126 - the data matrix (corresponding to related intensities)
127
128 **decimal places for [mass or retention time] values in identifiers**
129
130 | Ions' identifiers are constructed as MxxxTyyy where 'xxx' is the ion median mass and 'yyy' the ion median retention time.
131 | Two parameters are used to adjust the number of decimal places wanted in identifiers for mass and retention time respectively.
132 | Theses parameters do not affect decimal places in columns other than the identifier one.
133
134 **Reported intensity values**
135
136 | This parameter determines which values should be reported as intensities in the dataMatrix table; it correspond to xcms 'intval' parameter:
137 | - into: integrated area of original (raw) peak
138 | - maxo: maximum intensity of original (raw) peak
139 | - intb: baseline corrected integrated peak area (only available if peak detection was done by ‘findPeaks.centWave’)
140
141 </token>
142
143 <token name="@HELP_PEAKLIST_OUTPUT@">
144 xset.variableMetadata.tsv : tabular format
145
146 | Table containing information about ions; can be used as one input of **Quality_Metrics** or **Generic_filter** modules.
147
148 xset.dataMatrix.tsv : tabular format
149
150 | Table containing ions' intensities; can be used as one input of **Quality_Metrics** or **Generic_filter** modules.
151 </token>
152
153 <!-- CENTWAVE -->
154 <token name="@COMMAND_CENTWAVE@">
155 ppm $methods.ppm
156 peakwidth "c($methods.peakwidth)"
157
158 ## Advanced
159 snthresh $methods.CentWaveAdv.snthresh
160 prefilter "c($methods.CentWaveAdv.prefilter)"
161 mzCenterFun $methods.CentWaveAdv.mzCenterFun
162 integrate $methods.CentWaveAdv.integrate
163 mzdiff $methods.CentWaveAdv.mzdiff
164 fitgauss $methods.CentWaveAdv.fitgauss
165 noise $methods.CentWaveAdv.noise
166 verboseColumns $methods.CentWaveAdv.verboseColumns
167 </token>
168
169 <xml name="input_centwave">
170 <param argument="ppm" type="integer" value="25" label="Max tolerated ppm m/z deviation in consecutive scans in ppm" help="for the initial ROI definition." />
171 <param argument="peakwidth" type="text" value="20,50" label="Min,Max peak width in seconds" help="with the expected approximate peak width in chromatographic space.">
172 <expand macro="input_validator_range_float"/>
173 </param>
174 </xml>
175
176 <xml name="input_centwaveAdv">
177 <param argument="snthresh" type="integer" value="10" label="Signal to Noise ratio cutoff" />
178 <param argument="prefilter" type="text" value="3,100" label="Prefilter step for for the first analysis step (ROI detection)" help="Separate by coma k, I. Mass traces are only retained if they contain at least ‘k‘ peaks with intensity ‘>= I‘.">
179 <expand macro="input_validator_range_integer"/>
180 </param>
181 <param argument="mzCenterFun" type="select" label="Name of the function to calculate the m/z center of the chromatographic peak" >
182 <option value="wMean">intensity weighted mean of the peak's m/z values</option>
183 <option value="mean">mean of the peak's m/z values</option>
184 <option value="apex">use the m/z value at the peak apex</option>
185 <option value="wMeanApex3">ntensity weighted mean of the m/z value at the peak apex and the m/z values left and right of it</option>
186 <option value="meanApex3">mean of the m/z value of the peak apex and the m/z values left and right of it</option>
187 </param>
188 <param argument="integrate" type="select" label="Integration method" >
189 <option value="1">peak limits are found through descent on the mexican hat filtered data (more robust, but less exact)</option>
190 <option value="2">peak limits based on real data (more accurate but prone to noise)</option>
191 </param>
192 <param argument="mzdiff" type="float" value="-0.001" label="Minimum difference in m/z for peaks with overlapping retention times" help="can be negative to allow overlap" />
193 <param argument="fitgauss" type="boolean" checked="false" truevalue="TRUE" falsevalue="FALSE" label="fitgauss" help="whether or not a Gaussian should be fitted to each peak" />
194 <param argument="noise" type="integer" value="0" label="Noise filter" help="allowing to set a minimum intensity required for centroids to be considered in the first analysis step (centroids with intensity lower than ‘noise’ are omitted from ROI detection)." />
195 <param argument="verboseColumns" type="boolean" checked="false" truevalue="TRUE" falsevalue="FALSE" label="verbose Columns" help="whether additional peak meta data columns should be returned" />
196 </xml>
197
198 <token name="@COMMAND_CENTWAVEADVROI@">
199 #if $sectionROI.roiList:
200 roiList '$sectionROI.roiList'
201 firstBaselineCheck $sectionROI.firstBaselineCheck
202 #if $sectionROI.roiScales != "":
203 roiScales "c($sectionROI.roiScales)"
204 #end if
205 #end if
206 </token>
207
208 <xml name="input_centwaveAdvROI" token_optional="true">
209 <param argument="roiList" type="data" format="tabular" optional="@OPTIONAL@" label="List of regions-of-interest (ROI) representing detected mass traces" help="If ROIs are submitted the first analysis step is omitted and chromatographic peak detection is performed on the submitted ROIs. Each ROI is expected to have the following elements specified: ‘scmin’ (start scan index), ‘scmax’ (end scan index), ‘mzmin’ (minimum m/z), ‘mzmax’ (maximum m/z), ‘length’ (number of scans), ‘intensity’ (summed intensity)." />
210 <param argument="firstBaselineCheck" type="boolean" checked="true" truevalue="TRUE" falsevalue="FALSE" label="Is continuous data within regions of interest is checked to be above the first baseline." />
211 <param argument="roiScales" type="text" value="" optional="true" label="Numeric vector defining the scale for each region of interest in ‘roiList’" help="Length equal to ‘roiList’ - Should be used for the centWave-wavelets (format 0.9,1,0.2)">
212 <expand macro="input_validator_range_float"/>
213 </param>
214 </xml>
215
216 <!-- MISC -->
217 <token name="@HELP_AUTHORS@">
218 .. class:: infomark
219
220 **Authors** Colin A. Smith csmith@scripps.edu, Ralf Tautenhahn rtautenh@gmail.com, Steffen Neumann sneumann@ipb-halle.de, Paul Benton hpaul.benton08@imperial.ac.uk and Christopher Conley cjconley@ucdavis.edu
221
222 @HELP_AUTHORS_WRAPPERS@
223
224 ---------------------------------------------------
225
226 </token>
227
228 <token name="@HELP_XCMS_MANUAL@">
229
230 For details and explanations concerning all the parameters and workflow of xcms_ package, see its manual_ and this example_
231
232 .. _xcms: https://bioconductor.org/packages/release/bioc/html/xcms.html
233 .. _manual: http://www.bioconductor.org/packages/release/bioc/manuals/xcms/man/xcms.pdf
234 .. _example: https://bioconductor.org/packages/release/bioc/vignettes/xcms/inst/doc/xcms.html
235
236 </token>
237
238 <xml name="citation">
239 <citations>
240 <citation type="doi">10.1021/ac051437y</citation>
241 <expand macro="citation_w4m"/>
242 </citations>
243 </xml>
244 </macros>