Mercurial > repos > recetox > waveica

comparison macros.xml @ 5:fba892edb9d9 draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"planemo upload for repository https://github.com/RECETOX/galaxytools/tree/master/tools/waveica commit 98e541a75678eee749261630610b946c258fd5f3"
author recetox
date Wed, 23 Mar 2022 11:35:00 +0000
parents
children cf3f2f964d80
comparison
equal deleted inserted replaced
4:8b55efc7d117 5:fba892edb9d9
1 <macros>
2 <token name="@TOOL_VERSION@">0.2.0</token>
3
4 <xml name="creator">
5 <creator>
6 <person
7 givenName="Maksym"
8 familyName="Skoryk"
9 url="https://github.com/maximskorik"
10 identifier="0000-0003-2056-8018" />
11 <organization
12 url="https://www.recetox.muni.cz/"
13 email="GalaxyToolsDevelopmentandDeployment@space.muni.cz"
14 name="RECETOX MUNI" />
15 </creator>
16 </xml>
17
18 <xml name="general_parameters">
19 <param type="data" name="data" label="Feature table" format="csv" help=""/>
20 <param type="integer" value="20" name="k" label="Number of components to decompose" help="maximal component that ICA decomposes"/>
21 <param type="float" value="0" name="alpha" label="Alpha" help="trade-off value between the independence of samples (temporal ICA) and variables (spatial ICA), should be between 0 and 1"/>
22 </xml>
23 <xml name="batchwise_parameters">
24 <param type="float" value="0.05" name="t" label="Batch-association threshold" help="threshold to consider a component associate with the batch,
25 should be between 0 and 1"/>
26 <param type="float" value="0.05" name="t2" label="Group-association threshold" help="threshold to consider a component associate with the group,
27 should be between 0 and 1"/>
28 </xml>
29 <xml name="singlebatch_parameters">
30 <param type="float" value="0" name="cutoff" label="Cutoff" help="threshold of the variation explained by the injection order for independent components, should be between 0 and 1"/>
31 </xml>
32 <xml name="exclude_blanks">
33 <param name="exclude_blanks" type="boolean" checked="false" truevalue="TRUE" falsevalue="FALSE" label="Remove blanks" help="Excludes blank samples from the output" />
34 </xml>
35 <xml name="wf">
36 <conditional name="wf">
37 <param type="select" name="wavelet_filter" label="Wavelet transform filter" help="wavelet function and filter length [1] (see footnotes for more details)">
38 <option value="d" selected="True">Daubechies</option>
39 <option value="la" >Least Asymetric</option>
40 <option value="bl" >Best Localized</option>
41 <option value="c" >Coiflet</option>
42 </param>
43 <when value="d">
44 <param name="wavelet_length" type="select" label="filter length">
45 <option value="2" selected="True">2</option>
46 <option value="4">4</option>
47 <option value="6">6</option>
48 <option value="8">8</option>
49 <option value="10">10</option>
50 <option value="12">12</option>
51 <option value="14">14</option>
52 <option value="16">16</option>
53 <option value="18">18</option>
54 <option value="20">20</option>
55 </param>
56 </when>
57 <when value="la">
58 <param name="wavelet_length" type="select" label="filter length">
59 <option value="8">8</option>
60 <option value="10">10</option>
61 <option value="12">12</option>
62 <option value="14">14</option>
63 <option value="16">16</option>
64 <option value="18">18</option>
65 <option value="20">20</option>
66 </param>
67 </when>
68 <when value="bl">
69 <param name="wavelet_length" type="select" label="filter length">
70 <option value="14">14</option>
71 <option value="18">18</option>
72 <option value="20">20</option>
73 </param>
74 </when>
75 <when value="c">
76 <param name="wavelet_length" type="select" label="filter length">
77 <option value="6">6</option>
78 <option value="12">12</option>
79 <option value="18">18</option>
80 <option value="24">24</option>
81 <option value="30">30</option>
82 </param>
83 </when>
84 </conditional>
85 </xml>
86
87 <xml name="outputs">
88 <outputs>
89 <data name="normalized_data" format="tsv" />
90 </outputs>
91 </xml>
92
93 <token name="@HELP@"><![CDATA[
94 **Description**
95
96 Removal of batch effects for large-scale untargeted metabolomics data based on wavelet analysis and independent
97 component analysis. The WaveICA method uses the time trend of samples over the injection order, decomposes the
98 original data into new multi-scale features, extracts and removes the batch effect resulting in normalized
99 intensities across samples.
100
101 The input is an intensity-by-feature table with metadata in the following format:
102
103 +---------------+--------+------------+----------------+-------+------------+--------------+-------------+-------------+-----+
104 | sampleName | class | sampleType | injectionOrder | batch | M85T34 | M86T41 | M86T518 | M86T539 | ... |
105 +===============+========+============+================+=======+============+==============+=============+=============+=====+
106 | VT_160120_002 | sample | sample | 1 | 1 | 228520.064 | 35646729.215 | 2386896.979 | 1026645.836 | ... |
107 +---------------+--------+------------+----------------+-------+------------+--------------+-------------+-------------+-----+
108 | QC1 | sample | QC | 2 | 1 | 90217.384 | 35735702.457 | 2456290.696 | 1089246.460 | ... |
109 +---------------+--------+------------+----------------+-------+------------+--------------+-------------+-------------+-----+
110 | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
111 +---------------+--------+------------+----------------+-------+------------+--------------+-------------+-------------+-----+
112
113
114 + The required columns are **sampleName**, **class**, **sampleType**, **injectionOrder**, and the **features** that you want to normalize.
115 + The **batch** column is required if batch correction mode is **Multiple batches** and optional otherwise.
116 + The presence of any additional columns (except features) will result in incorrect batch correction or job failure.
117 + the input table must not contain missing values. Missing intensities must be filled with 0.
118 + **sampleType** column accepts three possible values: [QC, sample, blank] (case insensitive).
119 + **class** column is used to denote a biological group of a sample (e.g., positive/negative species). The column accepts any values.
120 + the **output** is the same table with corrected feature intensities.
121
122 .. rubric:: **Footnotes**
123 .. [1] for details on wavelet-filter parameters refer to R `wavelets::wt.filter <https://www.rdocumentation.org/packages/wavelets/versions/0.3-0.2/topics/wt.filter>`_;
124 .. [2] when using 'Multiple batches', please cite the WaveICA (2019) paper; else, cite WaveICA 2.0 (2021) paper;
125 ]]>
126 </token>
127 </macros>