annotate Marea/marea.xml @ 5:146cb8e171b8 draft

revision: xml requirement version
author bimib
date Thu, 15 Nov 2018 04:52:09 -0500
parents cf3d3d8f4ef5
children 5721182715a7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
1 <tool id="MaREA" name="Metabolic Enrichment Analysis" version="1.0.0">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
2 <description>for Galaxy</description>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
3 <macros>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
4 <import>marea_macros.xml</import>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
5 </macros>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
6 <requirements>
5
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
7 <requirement type="package" version="0.23.0">pandas</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
8 <requirement type="package" version="1.1.0">scipy</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
9 <requirement type="package" version="0.11.3">cobra</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
10 <requirement type="package" version="5.17.0">python-libsbml</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
11 <requirement type="package" version="4.2.1">lxml</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
12 <requirement type="package" version="0.8.1">svglib</requirement>
146cb8e171b8 revision: xml requirement version
bimib
parents: 4
diff changeset
13 <requirement type="package" version="3.4.0">reportlab</requirement>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
14 </requirements>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
15 <command detect_errors="exit_code">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
16 <![CDATA[
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
17 python $__tool_directory__/marea.py
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
18 --rules_selector $cond_rule.rules_selector
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
19 #if $cond_rule.rules_selector == 'Custom':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
20 --custom ${cond_rule.Custom_rules}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
21 --yes_no ${cond_rule.cond_map.yes_no}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
22 #if $cond_rule.cond_map.yes_no == 'yes':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
23 --custom_map $cond_rule.cond_map.Custom_map
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
24 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
25 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
26 --none $None
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
27 --pValue $pValue
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
28 --fChange $fChange
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
29 --tool_dir $__tool_directory__
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
30 --option $cond.type_selector
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
31 --out_log $log
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
32 #if $cond.type_selector == 'datasets':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
33 --input_datas
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
34 #for $data in $cond.input_Datasets:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
35 ${data.input}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
36 #end for
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
37 --names
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
38 #for $data in $cond.input_Datasets:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
39 ${data.input_name}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
40 #end for
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
41 #elif $cond.type_selector == 'dataset_class':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
42 --input_data ${input_data}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
43 --input_class ${input_class}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
44 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
45 ]]>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
46 </command>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
47
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
48 <inputs>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
49 <conditional name="cond_rule">
2
3b3d0e5d0802 Uploaded
bimib
parents: 1
diff changeset
50 <expand macro="options"/>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
51 <when value="HMRcore">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
52 </when>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
53 <when value="Recon">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
54 </when>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
55 <when value="Custom">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
56 <param name="Custom_rules" type="data" format="tabular, csv, tsv, xml" label="Custom rules" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
57 <conditional name="cond_map">
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
58 <param name="yes_no" type="select" label="Custom map? (optional)">
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
59 <option value="no" selected="true">no</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
60 <option value="yes">yes</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
61 </param>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
62 <when value="yes">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
63 <param name="Custom_map" argument="--custom_map" type="data" format="xml, svg" label="custom-map.svg"/>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
64 </when>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
65 <when value="no">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
66 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
67 </conditional>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
68 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
69 </conditional>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
70 <conditional name="cond">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
71 <param name="type_selector" argument="--option" type="select" label="Input format:">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
72 <option value="datasets" selected="true">RNAseq of group 1 + RNAseq of group 2 + ... + RNAseq of group N</option>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
73 <option value="dataset_class">RNAseq of all samples + sample group specification</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
74 </param>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
75 <when value="datasets">
4
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
76 <repeat name="input_Datasets" title="RNAseq" min="2">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
77 <param name="input" argument="--input_datas" type="data" format="tabular, csv, tsv" label="add dataset" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
78 <param name="input_name" argument="--names" type="text" label="Dataset's name:" value="Dataset" help="Defalut: Dataset" />
4
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
79 </repeat>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
80 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
81 <when value="dataset_class">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
82 <param name="input_data" argument="--input_data" type="data" format="tabular, csv, tsv" label="RNAseq of all samples" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
83 <param name="input_class" argument="--input_class" type="data" format="tabular, csv, tsv" label="Sample group specification" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
84 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
85 </conditional>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
86 <param name="None" argument="--none" type="boolean" truevalue="true" falsevalue="false" checked="true" label="(A and NaN) solved as (A)?" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
87 <param name="pValue" argument="--pValue" type="float" size="20" value="0.05" max="1" min="0" label="P-value threshold" help="min value 0" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
88 <param name="fChange" argument="--fChange" type="float" size="20" value="1.5" min="1" label="Fold-Change threshold" help="min value 1" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
89 </inputs>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
90
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
91 <outputs>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
92 <data format="txt" name="log" label="Log" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
93 <collection name="map_svg" type="list" label="Graphical results (.svg)">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
94 <filter>(cond_rule['rules_selector'] == 'HMRcore') or ((cond_rule['rules_selector'] == 'Custom') and (cond_rule['cond_map']['yes_no'] == 'yes'))</filter>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
95 <discover_datasets pattern="__name_and_ext__" directory="map_svg" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
96 </collection>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
97 <collection name="map_pdf" type="list" label="Graphical results (.pdf)">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
98 <filter>(cond_rule['rules_selector'] == 'HMRcore') or ((cond_rule['rules_selector'] == 'Custom') and (cond_rule['cond_map']['yes_no'] == 'yes'))</filter>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
99 <discover_datasets pattern="__name_and_ext__" directory="map_pdf" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
100 </collection>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
101 <collection name="table_out" type="list" label="Tabular results">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
102 <discover_datasets pattern="__name_and_ext__" directory="table_out" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
103 </collection>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
104 </outputs>
4
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
105 <tests>
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
106 <test>
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
107 <param name="pValue" value="0.56"/>
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
108 <output name="log" file="log.txt"/>
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
109 </test>
cf3d3d8f4ef5 Modifica a xml
bimib
parents: 3
diff changeset
110 </tests>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
111 <help>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
112 <![CDATA[
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
113
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
114 What it does
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
115 -------------
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
116
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
117 This tool analyzes RNA-seq dataset(s) as described in Graudenzi et al."`MaREA`_: Metabolic feature extraction, enrichment and visualization of RNAseq data" bioRxiv (2018): 248724.
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
118
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
119 Accepted files are:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
120 - option 1) two or more RNA-seq datasets, each referring to samples in a given condition/class. The user can specify a label for each class (as e.g. "*classA*" and "*classB*");
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
121 - option 2) one RNA dataset and one class-file specifying the class/condition each sample belongs to.
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
122
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
123 Optional files:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
124 - custom GPR (Gene-Protein-Reaction) rules. Two accepted formats:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
125
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
126 * (Cobra Toolbox and CobraPy compliant) xml of metabolic model;
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
127 * .csv file specifyig for each reaction ID (column 1) the corresponding GPR rule (column 2).
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
128 - custom svg map. Graphical elements must have the same IDs of reactions. See HmrCore svg map for an example.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
129
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
130 The tool generates:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
131 1) a tab-separated file: reporting fold-change and p-values of reaction activity scores (RASs) between a pair of conditions/classes;
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
132 2) a metabolic map file (downlodable as .svg): visualizing up- and down-regulated reactions between a pair of conditions/classes;
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
133 3) a log file (.txt).
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
134
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
135 RNA-seq datasets format: tab-separated text files, reporting the expression level (e.g., TPM, RPKM, ...) of each gene (row) for a given sample (column). Header: sample ID.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
136
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
137 Class-file format: each row of the class-file reports the sample ID (column1) and the label of the class/condition the sample belongs to (column 2).
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
138
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
139 To calculate P-Values and Fold-Changes and to generate maps, comparisons are performed for each possible pair of classes.
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
140
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
141 Output files will be named as classA_vs_classB. Reactions will conventionally be reported as up-regulated (down-regulated) if they are significantly more (less) active in class having label "classA".
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
142
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
143
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
144 Example input
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
145 -------------
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
146
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
147 **"Custom Rules"** option:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
148
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
149 Custom Rules Dastaset:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
150
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
151 @CUSTOM_RULES_EXEMPLE@
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
152
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
153 **"RNAseq of group 1 + RNAseq of group 2 + ... + RNAseq of group N"** option:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
154
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
155 RNA-seq Dataset 1:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
156
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
157 @DATASET_EXEMPLE1@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
158
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
159 RNA-seq Dataset 2:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
160
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
161 @DATASET_EXEMPLE2@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
162
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
163 **"RNAseq of all samples + sample group specification"** option:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
164
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
165 RNA-seq Dataset:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
166
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
167 @DATASET_EXEMPLE1@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
168
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
169 Class-file:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
170
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
171 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
172 | Patient_ID | class |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
173 +============+============+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
174 | TCGAAA3529 | MSI |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
175 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
176 | TCGAA62671 | MSS |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
177 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
178 | TCGAA62672 | MSI |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
179 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
180
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
181 |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
182
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
183 .. class:: infomark
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
184
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
185 **TIP**: If your data is not TAB delimited, use `Convert delimiters to TAB`_.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
186
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
187 .. class:: infomark
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
188
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
189 **TIP**: If your dataset is not split into classes, use `MaREA cluster analysis`_.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
190
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
191 @REFERENCE@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
192
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
193 .. _MaREA: https://www.biorxiv.org/content/early/2018/01/16/248724
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
194 .. _Convert delimiters to TAB: https://usegalaxy.org/?tool_id=Convert+characters1&version=1.0.0&__identifer=6t22teyofhj
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
195 .. _MaREA cluster analysis: http://link del tool di cluster.org
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
196
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
197 ]]>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
198 </help>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
199 <expand macro="citations" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
200 </tool>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
201