annotate abims_xcms_fillPeaks.xml @ 2:25786044e8b8 draft

Uploaded
author lecorguille
date Fri, 15 Jan 2016 05:05:08 -0500
parents 107a3de94c05
children 0df708800853
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
1 <tool id="abims_xcms_fillPeaks" name="xcms.fillPeaks" version="2.0.4">
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
2
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
3 <description>Integrate the signal in the region of that peak group not represented and create a new peak</description>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
4
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
5 <requirements>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
6 <requirement type="package" version="3.1.2">R</requirement>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
7 <requirement type="binary">Rscript</requirement>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
8 <requirement type="package" version="1.44.0">xcms</requirement>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
9 <requirement type="package" version="2.1">xcms_w4m_script</requirement>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
10 </requirements>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
11
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
12 <stdio>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
13 <exit_code range="1:" level="fatal" />
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
14 </stdio>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
15
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
16 <command><![CDATA[
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
17 xcms.r
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
18 xfunction fillPeaks
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
19 image $image
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
20
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
21 xsetRdataOutput $xsetRData
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
22
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
23 method $method
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
24
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
25 #if $zip_file:
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
26 zipfile $zip_file
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
27 #end if
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
28 ;
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
29 return=\$?;
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
30 mv log.txt $log;
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
31 cat $log;
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
32 sh -c "exit \$return"
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
33
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
34 ]]></command>
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
35
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
36 <inputs>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
37 <param name="image" type="data" format="rdata.xcms.group,rdata" label="xset RData file" help="output file from another function xcms (group)" />
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
38 <param name="method" type="select" label="Filling method" help="[method] See the help section below">
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
39 <option value="chrom" selected="true">chrom</option>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
40 <option value="MSW" >MSW</option>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
41 </param>
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
42 <!-- To pass planemo test -->
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
43 <param name="zip_file" type="hidden_data" format="no_unzip.zip" label="Zip file" />
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
44 </inputs>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
45
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
46 <outputs>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
47 <data name="xsetRData" format="rdata.xcms.fillpeaks" label="${image.name[:-6]}.fillPeaks.RData" />
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
48 <data name="log" format="txt" label="xset.log.txt" hidden="true" />
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
49 </outputs>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
50
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
51 <tests>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
52 <test>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
53 <param name="image" value="xset.group.retcor.group.RData"/>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
54 <param name="method" value="chrom"/>
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
55 <param name="zip_file" value="sacuri.zip"/>
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
56 <!--<output name="xsetRData" file="xset.group.retcor.group.fillPeaks.RData" />-->
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
57 <output name="log">
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
58 <assert_contents>
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
59 <has_text text="object with 9 samples" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
60 <has_text text="Time range: 0.7-1139.9 seconds (0-19 minutes)" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
61 <has_text text="Mass range: 50.0019-999.9863 m/z" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
62 <has_text text="Peaks: 157780 (about 17531 per sample)" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
63 <has_text text="Peak Groups: 6761" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
64 <has_text text="Sample classes: bio, blank" />
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
65 </assert_contents>
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
66 </output>
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
67 </test>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
68 </tests>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
69
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
70 <help><![CDATA[
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
71
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
72
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
73 .. class:: infomark
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
74
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
75 **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
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
76
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
77 .. class:: infomark
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
78
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
79 **Galaxy integration** ABiMS TEAM - UPMC/CNRS - Station biologique de Roscoff and Yann Guitton yann.guitton@univ-nantes.fr - part of Workflow4Metabolomics.org [W4M]
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
80
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
81 | Contact support@workflow4metabolomics.org for any questions or concerns about the Galaxy implementation of this tool.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
82
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
83
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
84 ---------------------------------------------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
85
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
86 ==============
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
87 Xcms.fillPeaks
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
88 ==============
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
89
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
90 -----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
91 Description
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
92 -----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
93
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
94 For each sample, identify peak groups where that sample is not
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
95 represented. For each of those peak groups, integrate the signal
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
96 in the region of that peak group and create a new peak.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
97
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
98 According to the type of raw-data there are 2
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
99 different methods available. for filling gcms/lcms data the method
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
100 "chrom" integrates raw-data in the chromatographic domain, whereas
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
101 "MSW" is used for peaklists without retention-time information
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
102 like those from direct-infusion spectra.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
103
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
104
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
105
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
106 -----------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
107 Workflow position
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
108 -----------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
109
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
110
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
111 **Upstream tools**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
112
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
113 ========================= ================= ================== ==========
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
114 Name output file format parameter
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
115 ========================= ================= ================== ==========
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
116 xcms.group xset.group.RData rdata.xcms.group RData file
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
117 ========================= ================= ================== ==========
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
118
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
119
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
120 **Downstream tools**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
121
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
122 +---------------------------+------------------+-----------------------+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
123 | Name | Output file | Format |
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
124 +===========================+==================+=======================+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
125 |xcms.diffreport | xset.retcor.RData| rdata.xcms.fillpeaks |
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
126 +---------------------------+------------------+-----------------------+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
127 |xcms.annotateDiffreport | xset.retcor.RData| rdata.xcms.fillpeaks |
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
128 +---------------------------+------------------+-----------------------+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
129
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
130 The output file **xset.fillpeaks** is an RData file. You can continue your analysis using it in **xcms.diffreport** or **xcms.annotateDiffreport** tool as an next step of the workflow.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
131
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
132
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
133 **General schema of the metabolomic workflow**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
134
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
135 .. image:: xcms_fillpeaks_workflow.png
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
136
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
137
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
138
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
139 -----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
140 Input files
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
141 -----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
142
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
143 +---------------------------+-----------------------+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
144 | Parameter : num + label | Format |
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
145 +===========================+=======================+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
146 | 1 : RData file | rdata.xcms.group |
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
147 +---------------------------+-----------------------+
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
148
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
149
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
150 ----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
151 Parameters
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
152 ----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
153
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
154
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
155 Method
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
156 ------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
157
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
158 **chrom**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
159
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
160 | This method produces intensity values for those missing samples by integrating raw data in peak group region. In a given group, the start and ending retention time points for integration are defined by the median start and end points of the other detected peaks. The start and end m/z values are similarly determined. Intensities can be still be zero, which is a rather unusual intensity for a peak. This is the case if e.g. the raw data was threshholded, and the integration area contains no actual raw intensities, or if one sample is miscalibrated, such the raw data points are (just) outside the integration area.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
161 | Importantly, if retention time correction data is available, the alignment information is used to more precisely integrate the propper region of the raw data. If the corrected retention time is beyond the end of the raw data, the value will be not-a-number (NaN).
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
162
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
163 **MSW**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
164
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
165 | "MSW" is used for peaklists without retention-time information like those from direct-infusion spectra.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
166
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
167 ------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
168 Output files
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
169 ------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
170
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
171 xset.fillPeaks.RData : rdata.xcms.fillpeaks format
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
172
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
173 | Rdata file that will be used in the **xcms.diffreport** or **xcms.annotateDiffreport** step of the workflow.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
174
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
175 ------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
176
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
177 .. class:: infomark
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
178
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
179 The output file is an group.RData file. You can continue your analysis using it in **xcms.diffreport** or **xcms.annotateDiffreport** tool.
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
180
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
181
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
182 ---------------------------------------------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
183
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
184 ---------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
185 Working example
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
186 ---------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
187
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
188 Input files
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
189 -----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
190
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
191 | RData file -> **xset.retcor.RData**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
192
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
193 Parameters
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
194 ----------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
195
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
196 | method -> **chrom**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
197
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
198
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
199 Output files
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
200 ------------
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
201
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
202 | **xset.fillPeaks.RData: RData file**
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
203
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
204
1
107a3de94c05 Uploaded
lecorguille
parents: 0
diff changeset
205 ]]></help>
0
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
206
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
207 <citations>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
208 <citation type="doi">10.1021/ac051437y</citation>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
209 <citation type="doi">10.1093/bioinformatics/btu813</citation>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
210 </citations>
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
211
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
212
30b01bcefda4 planemo upload
lecorguille
parents:
diff changeset
213 </tool>