annotate Intchecks/xml_intensity_check.xml @ 0:51c39ea1fd54 draft

Uploaded
author melpetera
date Mon, 14 Jan 2019 08:37:27 -0500
parents
children d1133a7c26f9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
1 <tool id="intens_check" name="Intensity Check" version="1.0.1">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
2 <description>Adding information about intensities (mean fold change and missing values) in the variable metadata table</description>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
3 <requirements>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
4 <requirement type="package" version="1.1_4">r-batch</requirement>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
5 </requirements>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
6 <command interpreter="Rscript">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
7
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
8 wrapper_intensity_check.R
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
9
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
10 dataMatrix_in "$dataMatrix_in"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
11 sampleMetadata_in "$sampleMetadata_in"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
12 variableMetadata_in "$variableMetadata_in"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
13
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
14 class_col "$class_col"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
15
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
16 type "${type_cond.type}"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
17 #if $type_cond.type == "One_class" :
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
18 class1 "${type_cond.class1}"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
19 fold_frac "${type_cond.fold_frac}"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
20 #end if
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
21
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
22 logarithm "$logarithm"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
23
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
24 variableMetadata_out "$variableMetadata_out"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
25 graphs_out "$graphs_out"
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
26 </command>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
27
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
28 <inputs>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
29 <param name="dataMatrix_in" type="data" label="Data Matrix file" help="" format="tabular" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
30 <param name="sampleMetadata_in" type="data" label="Sample metadata file" help="" format="tabular" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
31 <param name="variableMetadata_in" type="data" label="Variable metadata file" help="" format="tabular" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
32
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
33 <param name="class_col" type="data_column" data_ref="sampleMetadata_in" use_header_names="true" label="Class column" help="Class column in Sample metadata" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
34
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
35 <conditional name="type_cond">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
36 <param name="type" type="select" label="What kind of tests do you want to perform?" display="radio" help="If you only have two classes, 'One class' could be selected to choose which class should be on the numerator/denominator.">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
37 <option value="One_class">Tests between one class and the remaining samples </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
38 <option value="Each_class" selected="true">Tests for each class </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
39 </param>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
40 <when value="One_class">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
41 <param name="class1" type="text" label="Selected class" help="Class name if you choose to test one class against the remaining samples." />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
42 <param name="fold_frac" type="select" label="Where should the class be placed for the mean fold change calculation?" display="radio">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
43 <option value="Top">Numerator (Top) </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
44 <option value="Bottom">Denominator (Bottom) </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
45 </param>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
46 </when>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
47 <when value="Each_class">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
48 </when>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
49 </conditional>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
50
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
51 <param name="logarithm" type="select" label="Logarithm" help="Choose if you want the mean fold change to be converted into a log mean fold change (log2 or log10)">
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
52 <option value="none">none </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
53 <option value="log2">log2 </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
54 <option value="log10">log10 </option>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
55 </param>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
56
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
57 </inputs>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
58
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
59 <outputs>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
60 <data name="variableMetadata_out" label="IC_${variableMetadata_in.name}" format="tabular" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
61 <data name="graphs_out" label="IC_Graphs" format="pdf" />
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
62 </outputs>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
63
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
64 <help>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
65
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
66 .. class:: infomark
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
67
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
68 **Authors**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
69 | Anthony Fernandes - PFEM ; INRA
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
70
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
71 ---------------------------------------------------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
72
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
73 ========================
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
74 Intensity Check
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
75 ========================
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
76
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
77 -----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
78 Description
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
79 -----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
80
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
81 This tool performs two tests: a mean fold change calculation and the number of missing values.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
82
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
83 **Fold:**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
84 The test calculates the mean fold change between two classes. It could be converted into logarithm.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
85
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
86 **Missing values:**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
87 This tool calculates the number and the proportion of missing values in the data matrix considering the class.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
88 Missing values in numerical columns of data must be coded NA.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
89
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
90 **Two types of tests:**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
91 | - Between **one class** and the remaining samples: if you have only two classes or if you want to test only one class versus all the remaining samples without class distinction.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
92 | - **Each class**: if the class columns contains at least three classes and you want to test each of them. Can also be used with only two classes, but you will not choose which class to put as numerator/denominator.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
93
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
94 -----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
95 Input files
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
96 -----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
97
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
98 +----------------------------+------------+
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
99 | Parameter | Format |
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
100 +============================+============+
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
101 | 1 : Data Matrix file | tabular |
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
102 +----------------------------+------------+
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
103 | 2 : Sample metadata file | tabular |
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
104 +----------------------------+------------+
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
105 | 3 : Variable metadata file | tabular |
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
106 +----------------------------+------------+
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
107
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
108 ----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
109 Parameters
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
110 ----------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
111
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
112 **Class column**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
113 | Select the class column in sample metadata table.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
114
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
115 **Type of test**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
116 | Two options:
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
117 | - "One class" allows to perform tests on one class against the remaining samples.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
118 | - "Each class" allows to add several columns with the ratio between all the classes and the number of missing values for each class.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
119
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
120 **Selected class**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
121 | If the type is "one class", specify it to calculate the ratio and the number of missing values.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
122
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
123 **Numerator or denominator**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
124 | If the type is "one class", choose "top" or "bottom" to put the selected class as numerator or denominator (respectively) for the mean fold change.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
125
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
126 **Logarithm**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
127 | Choose if you want to transform the mean fold change with a log2 or log10.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
128
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
129 ------------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
130 Output file
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
131 ------------
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
132
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
133 **Variable metadata file**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
134 | Contains the previous columns in variable metadata file and the new ones with fold tests, number and proportion of missing values.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
135 | In the column names for fold, the first class specified is the one used like numerator for the ratio.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
136
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
137 **Graphs file**
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
138 | Contains barplots with the proportion of NA considering classes and boxplots with the fold values.
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
139
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
140 </help>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
141
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
142
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
143 </tool>
51c39ea1fd54 Uploaded
melpetera
parents:
diff changeset
144