annotate deseq2.xml @ 17:a05999fd6e26 draft

Uploaded
author bgruening
date Mon, 30 Sep 2013 10:51:41 -0400
parents 1d2a02bc2208
children 72613128bd65
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
15
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
1 <tool id="deseq2" name="DESeq2" version="2.0.1">
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
2 <description>Determines differentially expressed features from count data</description>
1
c0dfa0f736aa Uploaded
bgruening
parents: 0
diff changeset
3 <requirements>
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
4 <requirement type="binary">Rscript</requirement>
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
5 <requirement type="R-module">DESeq2</requirement>
1
c0dfa0f736aa Uploaded
bgruening
parents: 0
diff changeset
6 <requirement type="package" version="3.0.1">R_3_0_1</requirement>
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
7 <requirement type="set_environment">DESEQ2_SCRIPT_PATH</requirement>
1
c0dfa0f736aa Uploaded
bgruening
parents: 0
diff changeset
8 </requirements>
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
9 <command interpreter="Rscript">
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
10 #import simplejson
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
11 deseq2.R
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
12 -o "$deseq_out"
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
13 --outfilefiltered "$deseq_out_filtered"
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
15 #if $pdf:
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
16 -p "$plots"
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
17 #end if
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
18
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
19 -i "$input_matrix"
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
20
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
21 #set $temp_factor_name = list()
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
22 #for $factor in $rep_factorName:
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
23 #set $temp_factor = dict()
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
24 #for $level in $factor.rep_factorLevel:
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
25 ##$temp_factor_list.append( '%s::%s:%s' % ($factor.factorName.replace(' ','_'), $level.factorLevel, $level.factorIndex) )
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
26 $temp_factor.update({str($level.factorLevel): map(int, str($level.factorIndex).split(','))})
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
27 #end for
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
28 $temp_factor_name.append([str($factor.factorName), $temp_factor])
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
29
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
30 #end for
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
31
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
32 ##-m "#echo ' '.join( $temp_factor_list )#"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
33 -m '#echo simplejson.dumps(temp_factor_name)#'
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
34 ##--organism "$organism"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
35 ##-t "$fittype"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
36 -c $countthreshold
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
37 </command>
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
38 <stdio>
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
39 <regex match="Execution halted"
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
40 source="both"
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
41 level="fatal"
15
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
42 description="Execution halted." />
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
43 <regex match="Input-Error 01"
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
44 source="both"
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
45 level="fatal"
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
46 description="Error in your input parameters: Make sure you only apply factors to selected samples." />
15
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
47 <regex match="Error in"
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
48 source="both"
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
49 level="fatal"
ff74cd9b0414 Uploaded
bgruening
parents: 14
diff changeset
50 description="An undefined error occured, please check your intput carefully and contact your administrator." />
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
51 </stdio>
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
52 <inputs>
16
1d2a02bc2208 Uploaded
bgruening
parents: 15
diff changeset
53 <param format="tabular" name="input_matrix" type="data" label="Countmatrix" help="You can create a count matrix with the tool
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
54 'Count reads in features with htseq-count'"/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
55
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
56 <repeat name="rep_factorName" title="Factor/Condition" min="1">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
57 <param name="factorName" type="text" value="FactorName" label="Specify a factor name" help=""/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
58 <repeat name="rep_factorLevel" title="Factor level" min="1">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
59 <param name="factorLevel" type="text" value="FactorLevel" label="Specify a factor level" help=""/>
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
60
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
61 <param name="factorIndex" label="Select columns that are associated with this factor level" type="data_column" data_ref="input_matrix"
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
62 numerical="True" multiple="true" use_header_names="true" size="120" display="checkboxes">
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
63 <validator type="no_options" message="Please select at least one column."/>
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
64 </param>
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
65 </repeat>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
66 </repeat>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
67 <!--
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
68 <param name="control_cols" type="select" display="checkboxes" multiple="true" optional="True" label="Select columns containing first condition"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
69 dynamic_options="get_matrix_header( input_dataset=input_matrix )" help="insert useful info here">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
70 <validator type="no_options" message="Please select at least one column."/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
71 </param>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
72 <param name="experiement_cols" type="select" display="checkboxes" multiple="true" optional="True" label="Select columns containing second condition"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
73 dynamic_options="get_matrix_header( input_dataset=input_matrix )" help="insert useful info here">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
74 <validator type="no_options" message="Please select at least one column."/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
75 </param>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
76
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
77 <repeat name="factor" title="factor">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
78 <param name="factor_name" type="text" value="Factor Name" label="Specify a factor name"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
79 help="Order of factors you add effects the design formual and hence effects whole analysis. Design formual will be created as follows: ~factor1+factor2+factor3+...+factorN+condition"/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
80 <param name="factor_index" type="select" display="checkboxes" multiple="true" optional="True" label="Choose sample to compare with"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
81 dynamic_options="get_matrix_header( input_dataset=input_matrix )" help="Select columns that are associated with a factor">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
82 <validator type="no_options" message="Please select at least one column."/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
83 </param>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
84 </repeat>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
85 -->
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
86 <!--param name="organism" size="10" type="select">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
87 <option value="human">human</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
88 <option value="mouse">mouse</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
89 <option value="fly">fly</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
90 <option value="other">other</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
91 </param-->
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
92 <param name="countthreshold" size="10" type="float" value="10" label="Filter out features with mean normalized counts lower than this value"/>
16
1d2a02bc2208 Uploaded
bgruening
parents: 15
diff changeset
93 <param name="fittype" type="select" label="Type of fitting of dispersions to the mean intensity">
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
94 <option value="parametric">parametric</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
95 <option value="local">local</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
96 <option value="mean">mean</option>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
97 </param>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
98 <param name="pdf" type="boolean" truevalue="" falsevalue="" checked="true" label="Visualising the analysis results"
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
99 help="output an additional PDF files" />
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
100 </inputs>
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
101
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
102 <outputs>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
103 <data format="tabular" name="deseq_out" label="DESeq2 result file on ${on_string}"/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
104 <data format="tabular" name="deseq_out_filtered" label="Independent filtering result file on ${on_string}"/>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
105 <data format="pdf" name="plots" label="DESeq2 plots on ${on_string}">
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
106 <filter>pdf == True</filter>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
107 </data>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
108 </outputs>
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
109 <code file="matrix_helper.py" />
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
110
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
111 <help>
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
112
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
113 .. class:: infomark
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
114
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
115 **What it does**
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
116
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
117 Estimate variance-mean dependence in count data from high-throughput sequencing assays and test for differential expression based on a model using the negative binomial distribution
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
118
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
119
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
120 **Inputs**
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
121
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
122 DESeq2_ requires one count matrix as input file. You can use the tool
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
123
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
124
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
125
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
126 **Output**
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
127
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
128 DESeq2_ generates a tabular file containing the different columns and optional visualized results as PDF.
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
129
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
130 ====== ==========================================================
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
131 Column Description
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
132 ------ ----------------------------------------------------------
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
133 1 Gene Identifiers
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
134 2 mean normalised counts, averaged over all samples from both conditions
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
135 3 the logarithm (to basis 2) of the fold change
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
136 4 standard error estimate for the log2 fold change estimate
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
137 5 p value for the statistical significance of this change
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
138 6 p value adjusted for multiple testing with the Benjamini-Hochberg procedure
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
139 which controls false discovery rate (FDR)
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
140 ====== ==========================================================
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
141
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
142
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
143 ------
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
144
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
145 **References**
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
146
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
147 DESeq2_ Authors: Michael Love (MPIMG Berlin), Simon Anders, Wolfgang Huber (EMBL Heidelberg)
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
148
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
149 If _DESeq2_ is used to obtain results for scientific publications it
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
150 should be cited as [1]_. A paper describing DESeq2_ is in preparation.
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
151
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
152
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
153
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
154 .. [1] Anders, S and Huber, W (2010): `Differential expression analysis for sequence count data`_.
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
155
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
156 .. _Differential expression analysis for sequence count data: http://dx.doi.org/10.1186/gb-2010-11-10-r106
14
bb5c80d15e0a Uploaded
bgruening
parents: 13
diff changeset
157 .. _DESeq2: http://master.bioconductor.org/packages/release/bioc/html/DESeq2.html
13
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
158
6d17a7d6fe9c Uploaded
bgruening
parents: 1
diff changeset
159
17
a05999fd6e26 Uploaded
bgruening
parents: 16
diff changeset
160 </help>
0
b02d2083dd89 Uploaded
bgruening
parents:
diff changeset
161 </tool>