annotate Marea/marea.xml @ 1:9e63d5f02d62 draft

Uploaded
author bimib
date Wed, 07 Nov 2018 07:07:46 -0500
parents 23ac9cf12788
children 3b3d0e5d0802
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
1 <tool id="MaREA" name="Metabolic Enrichment Analysis">
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>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
6 <expand macro="requirements" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
7 <requirements>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
8 <requirement type="package">lxml</requirement>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
9 <requirement type="package">svglib</requirement>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
10 <requirement type="package">reportlab</requirement>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
11 </requirements>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
12 <command detect_errors="exit_code">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
13 <![CDATA[
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
14 python $__tool_directory__/marea.py
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
15 --rules_selector $cond_rule.rules_selector
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
16 #if $cond_rule.rules_selector == 'Custom':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
17 --custom ${cond_rule.Custom_rules}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
18 --yes_no ${cond_rule.cond_map.yes_no}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
19 #if $cond_rule.cond_map.yes_no == 'yes':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
20 --custom_map $cond_rule.cond_map.Custom_map
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
21 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
22 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
23 --none $None
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
24 --pValue $pValue
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
25 --fChange $fChange
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
26 --tool_dir $__tool_directory__
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
27 --option $cond.type_selector
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
28 --out_log $log
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
29 #if $cond.type_selector == 'datasets':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
30 --input_datas
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
31 #for $data in $cond.input_Datasets:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
32 ${data.input}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
33 #end for
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
34 --names
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
35 #for $data in $cond.input_Datasets:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
36 ${data.input_name}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
37 #end for
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
38 #elif $cond.type_selector == 'dataset_class':
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
39 --input_data ${input_data}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
40 --input_class ${input_class}
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
41 #end if
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
42 ]]>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
43 </command>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
44
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
45 <inputs>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
46 <conditional name="cond_rule">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
47 <expand macro="options" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
48 <when value="HMRcore">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
49 </when>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
50 <when value="Recon">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
51 </when>
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
52 <when value="Custom">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
53 <param name="Custom_rules" type="data" format="tabular, csv, tsv, xml" label="Custom rules" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
54 <conditional name="cond_map">
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
55 <param name="yes_no" type="select" label="Custom map? (optional)">
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
56 <option value="no" selected="true">no</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
57 <option value="yes">yes</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
58 </param>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
59 <when value="yes">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
60 <param name="Custom_map" argument="--custom_map" type="data" format="xml, svg" label="custom-map.svg"/>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
61 </when>
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
62 <when value="no">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
63 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
64 </conditional>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
65 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
66 </conditional>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
67 <conditional name="cond">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
68 <param name="type_selector" argument="--option" type="select" label="Input format:">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
69 <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
70 <option value="dataset_class">RNAseq of all samples + sample group specification</option>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
71 </param>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
72 <when value="datasets">
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
73 <repeat name="input_Datasets" title="RNAseq" type="data" min="2">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
74 <param name="input" argument="--input_datas" type="data" format="tabular, csv, tsv" label="add dataset" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
75 <param name="input_name" argument="--names" type="text" label="Dataset's name:" value="Dataset" help="Defalut: Dataset" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
76 </repeat>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
77 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
78 <when value="dataset_class">
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
79 <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
80 <param name="input_class" argument="--input_class" type="data" format="tabular, csv, tsv" label="Sample group specification" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
81 </when>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
82 </conditional>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
83 <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
84 <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
85 <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
86 </inputs>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
87
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
88 <outputs>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
89 <data format="txt" name="log" label="Log" />
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
90 <collection name="map_svg" type="list" label="Graphical results (.svg)">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
91 <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
92 <discover_datasets pattern="__name_and_ext__" directory="map_svg" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
93 </collection>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
94 <collection name="map_pdf" type="list" label="Graphical results (.pdf)">
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
95 <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
96 <discover_datasets pattern="__name_and_ext__" directory="map_pdf" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
97 </collection>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
98 <collection name="table_out" type="list" label="Tabular results">
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
99 <discover_datasets pattern="__name_and_ext__" directory="table_out" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
100 </collection>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
101 </outputs>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
102
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
103
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
104
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
105 <help>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
106 <![CDATA[
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
107
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
108 What it does
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
109 -------------
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
110
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
111 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
112
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
113 Accepted files are:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
114 - 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
115 - option 2) one RNA dataset and one class-file specifying the class/condition each sample belongs to.
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
116
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
117 Optional files:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
118 - custom GPR (Gene-Protein-Reaction) rules. Two accepted formats:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
119
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
120 * (Cobra Toolbox and CobraPy compliant) xml of metabolic model;
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
121 * .csv file specifyig for each reaction ID (column 1) the corresponding GPR rule (column 2).
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
122 - 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
123
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
124 The tool generates:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
125 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
126 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
127 3) a log file (.txt).
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
128
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
129 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
130
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
131 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
132
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
133 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
134
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
135 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
136
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
137
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
138 Example input
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
139 -------------
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
140
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
141 **"Custom Rules"** option:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
142
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
143 Custom Rules Dastaset:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
144
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
145 @CUSTOM_RULES_EXEMPLE@
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
146
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
147 **"RNAseq of group 1 + RNAseq of group 2 + ... + RNAseq of group N"** option:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
148
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
149 RNA-seq Dataset 1:
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
150
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
151 @DATASET_EXEMPLE1@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
152
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
153 RNA-seq Dataset 2:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
154
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
155 @DATASET_EXEMPLE2@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
156
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
157 **"RNAseq of all samples + sample group specification"** option:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
158
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
159 RNA-seq Dataset:
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
160
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
161 @DATASET_EXEMPLE1@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
162
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
163 Class-file:
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
164
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
165 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
166 | Patient_ID | class |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
167 +============+============+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
168 | TCGAAA3529 | MSI |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
169 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
170 | TCGAA62671 | MSS |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
171 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
172 | TCGAA62672 | MSI |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
173 +------------+------------+
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
174
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
175 |
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
176
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
177 .. class:: infomark
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
178
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
179 **TIP**: If your data is not TAB delimited, use `Convert delimiters to TAB`_.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
180
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
181 .. class:: infomark
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
182
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
183 **TIP**: If your dataset is not split into classes, use `MaREA cluster analysis`_.
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
184
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
185 @REFERENCE@
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
186
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
187 .. _MaREA: https://www.biorxiv.org/content/early/2018/01/16/248724
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
188 .. _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
189 .. _MaREA cluster analysis: http://link del tool di cluster.org
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
190
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
191 ]]>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
192 </help>
1
9e63d5f02d62 Uploaded
bimib
parents: 0
diff changeset
193 <expand macro="citations" />
0
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
194 </tool>
23ac9cf12788 Uploaded
bimib
parents:
diff changeset
195