annotate retropath2_wrapper.xml @ 6:8d76e8616839 draft

planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
author tduigou
date Thu, 20 Apr 2023 12:30:18 +0000
parents
children 0a25e8aaad7c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
1 <tool id="retropath2_wrapper" name="RetroPath2.0" version="@TOOL_VERSION@+galaxy@VERSION_SUFFIX@" profile="21.09" license="MIT">
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
2 <description>Build a reaction network from a set of source compounds to a set of sink compounds</description>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
3 <macros>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
4 <token name="@VERSION_SUFFIX@">0</token>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
5 <token name="@TOOL_VERSION@">3.0.1</token>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
6 </macros>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
7 <requirements>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
8 <requirement type="package" version="@TOOL_VERSION@">retropath2_wrapper</requirement>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
9 </requirements>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
10 <stdio>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
11 <exit_code range="1" level="fatal" description="Cannot find source-in-sink file" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
12 <exit_code range="2" level="fatal" description="Running the RetroPath2.0 Knime program produced an OSError" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
13 <exit_code range="3" level="fatal" description="The InChI string is malformed" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
14 <exit_code range="-1" level="warning" description="Source has been found in the sink" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
15 <exit_code range="-2" level="warning" description="RetroPath2.0 has found no solution" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
16 <exit_code range="-3" level="warning" description="Time limit reached" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
17 </stdio>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
18 <command detect_errors="exit_code"><![CDATA[
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
19 python -m retropath2_wrapper
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
20 '$sinkfile'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
21 '$rulesfile'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
22 out
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
23 --source_inchi '$source_inchi'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
24 --source_name '$source_name'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
25 --rp2_version '$adv.version'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
26 --max_steps '$max_steps'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
27 --topx '$adv.topx'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
28 --dmin '$adv.dmin'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
29 --dmax '$adv.dmax'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
30 --mwmax_source '$adv.mwmax_source'
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
31 --kinstall "\${TMPDIR:-.}"
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
32 --msc_timeout '$adv.timeout' &&
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
33 if compgen -G 'out/*_scope.csv' > /dev/null; then
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
34 cp out/*_scope.csv '$Reaction_Network';
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
35 else
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
36 cp out/results.csv '$Reaction_Network';
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
37 fi
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
38 ]]></command>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
39 <inputs>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
40 <param name="rulesfile" type="data" format="csv,tar" label="Rules File" help="File containing reaction rules which reflect the enzymatic potential of the chassis organism."/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
41 <param name="sinkfile" type="data" format="csv" label="Sink File" help=" Sink file which comprises all compounds that are considered as granted in your system."/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
42 <param name="source_inchi" type="text" label="Source InChI" optional="false" help="InChI of compound to produce.">
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
43 <validator type="empty_field" message="You must provide the InChI string"/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
44 </param>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
45 <param name="max_steps" type="integer" value="3" min="1" max="10" label="Maximal Pathway length" help="The maximal number of metabolic steps (i.e. reactions) for exploring around the target."/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
46 <param name="source_name" type="text" value="target" optional="true" label="Source name" help="Name of compound to produce.">
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
47 <validator type="empty_field" message="Source name is required."/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
48 </param>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
49 <section name="adv" title="Advanced Options" expanded="false">
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
50 <param name="version" type="select" label="Workflow version" help="Retropath2.0 Workflow versions, formatted as 'r{year}{month}{day}' (the latest version 'r20220104' is used by default).">
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
51 <option value="v9">v9</option>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
52 <option value="r20210127">r20210127</option>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
53 <option value="r20220104" selected="true">r20220104</option>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
54 </param>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
55 <param name="topx" type="integer" value="100" min="1" max="1000" label="TopX" help="The maximal number of intermediate compounds to use as new starting points for a next iteration of the retrosynthesis algorithm." />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
56 <param name="dmin" type="integer" value="0" min="0" max="1000" label="Minimum rule diameter" help="Minimum rule diameter of the sphere including the atoms around the reacting center. The higher is the diameter, the more specific are the rules." />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
57 <param name="dmax" type="integer" value="1000" min="0" max="1000" label="Maximum rule diameter" help="Maximum rule diameter of the sphere including the atoms around the reacting center. The higher is the diameter, the more specific are the rules."/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
58 <param name="mwmax_source" type="integer" value="1000" min="0" max="2000" label="Molecular weight of source (Da)" help="The molecular weight cutoff (in Da), above which initial source (ie target) and intermediate compounds will be filtered out." />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
59 <param name="timeout" type="integer" value="60" min="30" max="600" label="Timeout (min)" help="Maximal time of RetroPath2.0 execution (60 minutes by default)." />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
60 </section>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
61 </inputs>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
62 <outputs>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
63 <data name="Reaction_Network" format="csv" label="${tool.name}" >
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
64 <actions>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
65 <action name="column_names" type="metadata" default="Initial source,Transformation ID,Reaction SMILES,Substrate SMILES,Substrate InChI,Product SMILES,Product InChI,In Sink,Sink name,Diameter,Rule ID,EC number,Score,Starting Source SMILES,Iteration" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
66 </actions>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
67 </data>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
68 </outputs>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
69 <tests>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
70 <test>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
71 <!-- test 1: check if identical outputs are produced with default parameters -->
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
72 <param name="rulesfile" value="rules.csv" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
73 <param name="sinkfile" value="sink.csv" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
74 <param name="source_inchi" value="InChI=1S/C40H56/c1-33(2)19-13-23-37(7)27-17-31-39(9)29-15-25-35(5)21-11-12-22-36(6)26-16-30-40(10)32-18-28-38(8)24-14-20-34(3)4/h11-12,15-22,25-32H,13-14,23-24H2,1-10H3/b12-11+,25-15+,26-16+,31-17+,32-18+,35-21+,36-22+,37-27+,38-28+,39-29+,40-30+" />
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
75 <output name="Reaction_Network" file="results_retropath2.csv" ftype="csv" compare="diff"/>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
76 </test>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
77 </tests>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
78 <help><![CDATA[
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
79 Retropath2.0 wrapper
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
80 ====================
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
81
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
82
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
83 Perform retrosynthesis search of possible metabolic routes between a source molecule and a collection of sink molecules. This tool is an implementation of the `KNIME retropath2.0 workflow <https://www.myexperiment.org/workflows/4987.html>`_. It takes for input the minimal (dmin) and maximal (dmax) diameter for the reaction rules and the maximal path length (maxSteps). The tool expects the following files: rules.csv, sink.csv and source.csv and produce a retrosynthesis network as a CSV file providing reactions in the reaction SMILES format and chemicals in both SMILES and InChI formats along with other information like the score for each reaction. Only a single source molecule is processed at this time.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
84
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
85 Input
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
86 -----
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
87
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
88 Required:
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
89
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
90 * **Sink File**\ : (string) Sink file which comprises all compounds that are considered as granted in your system.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
91 * **Source InChI**\ : (string) InChI of compound to produce.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
92 * **Source name**\ : (string) Name of compound to produce.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
93 * **Maximal Pathway length**\ : (integer) The maximal number of metabolic steps (i.e. reactions) for exploring around the target.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
94 * **Rules File**\ : (string) File containing reaction rules which reflect the enzymatic potential of the chassis organism.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
95
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
96
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
97 Advanced options:
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
98
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
99 * **TopX**\ : (integer, default: 100) The maximal number of intermediate compounds to use as new starting points for a next iteration of the retrosynthesis algorithm.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
100 * **Minimum rule diameter**\ : (integer, default: 0) Minimum rule diameter of the sphere including the atoms around the reacting center. The higher is the diameter, the more specific are the rules.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
101 * **Maximum rule diameter**\ : (integer, default: 1000) Maximum rule diameter of the sphere including the atoms around the reacting center. The higher is the diameter, the more specific are the rules.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
102 * **Molecular weight of source (Da)**\ : (integer, default: 1000) The molecular weight cutoff (in Da), above which initial source (ie target) and intermediate compounds will be filtered out.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
103 * **Timeout (min)**\ : (integer, default: 60) Maximal time of RetroPath2.0 execution (60 minutes by default)
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
104 * **Workflow version**\ : Retropath2.0 Workflow versions, formatted as r{year}{month}{day} (the latest version r20220104 is used by default)
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
105
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
106 Output
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
107 ------
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
108
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
109 * **Reaction Network**\ : CSV file containing retrosynthesis network which provides reactions in the reaction SMILES format and chemicals in both SMILES and InChI formats along with other information like the score for each reaction.
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
110 ]]></help>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
111 <citations>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
112 <citation type="doi">10.1016/j.ymben.2017.12.002 </citation>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
113 </citations>
8d76e8616839 planemo upload commit 28852b9b524b2b3ec85d6e85bc30f82593cb026c
tduigou
parents:
diff changeset
114 </tool>