annotate profiler.xml @ 6:c5847db0cb41 draft

Uploaded
author bgruening
date Wed, 14 Aug 2013 07:18:18 -0400
parents 1f312af2f8db
children 73761f33f198
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
1 <tool id="deeptools_profiler" name="profiler" version="1.0">
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
2 <description>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
3 creates a profile plot for a score associated to genomic regions
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
4 </description>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
5 <requirements>
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
6 <requirement type="package" version="1.5.1_df852fa1ef13251a17274ee18fbf919fbc515079">deepTools</requirement>
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
7 <requirement type="package" >deepTools</requirement>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
8 </requirements>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
9 <command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
10 profiler
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
11
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
12 --matrixFile $matrixFile
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
13
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
14 #if $output.showOutputSettings == "yes"
5
1f312af2f8db Uploaded
bgruening
parents: 4
diff changeset
15 #set newoutFileName = str($outFileName)+"."+str($output.outFileFormat)
1f312af2f8db Uploaded
bgruening
parents: 4
diff changeset
16 --outFileName $newoutFileName
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
17 #if $output.saveData:
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
18 --outFileNameData '$outFileNameData'
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
19 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
20
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
21 #if $output.saveMatrix:
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
22 --outFileNameMatrix '$outFileNameMatrix'
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
23 #end if
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
24
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
25 #if $output.saveSortedRegions:
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
26 --outFileSortedRegions '$outFileSortedRegions'
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
27 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
28 #else
5
1f312af2f8db Uploaded
bgruening
parents: 4
diff changeset
29 #set newoutFileName = str($outFileName)+".png"
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
30 --outFileName $newoutFileName
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
31 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
32
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
33 #if $scaleRegions.showScaleRegionsOpt == "yes":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
34 --startLabel $scaleRegions.startLabel
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
35 --endLabel $scaleRegions.endLabel
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
37
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
38 #if $advancedOpt.showAdvancedOpt == "yes"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
39 #if $advancedOpt.averageType:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
40 --averageType '$advancedOpt.averageType'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
41 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
42 --plotHeight $advancedOpt.plotHeight
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
43 --plotWidth $advancedOpt.plotWidth
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
44 --plotType $advancedOpt.plotType
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
45
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
46 --regionsLabel '$advancedOpt.regionsLabel'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
47
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
48 #if str($advancedOpt.plotTitle.value) != "None":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
49 --plotTitle '$advancedOpt.plotTitle'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
50 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
51
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
52 $advancedOpt.onePlotPerGroup
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
53
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
54 #if $advancedOpt.yMin:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
55 --yMin $advancedOpt.yMin
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
56 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
57 #if $advancedOpt.yMax:
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
58 --yMax $advancedOpt.yMax
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
59 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
60
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
61 --xAxisLabel '$advancedOpt.xAxisLabel'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
62 #if str($advancedOpt.yAxisLabel.value) != "None":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
63 --yAxisLabel '$advancedOpt.yAxisLabel'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
64 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
65 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
66 ; mv $newoutFileName $outFileName
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
67 </command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
68 <inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
69 <param name="matrixFile" format="bgzip" type="data" label="Matrix file from the computeMatrix tool"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
70 <conditional name="scaleRegions">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
71 <param name="showScaleRegionsOpt" type="select" label="The input matrix was computed in scale-regions mode">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
72 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
73 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
74 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
75 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
76 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
77 <param name="startLabel" type="text" value="TSS" size="10" label="Label for the region start" help ="[only for scale-regions mode] Label shown in the plot for the start of the region. Default is TSS (transcription start site), but could be changed to anything, e.g. &quot;peak start&quot;." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
78 <param name="endLabel" type="text" value="TES" size="10" label="Label for the region end" help="[only for scale-regions mode] Label shown in the plot for the region end. Default is TES (transcription end site)."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
79 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
80 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
81
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82 <conditional name="output" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
83 <param name="showOutputSettings" type="select" label="Show advanced output settings" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
88 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89 <param name="outFileFormat" type="select" label="Image file format">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
90 <option value="png" selected="true">png</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
91 <option value="pdf">pdf</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
92 <option value="svg">svg</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
93 <option value="eps">eps</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
94 <option value="emf">emf</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
95 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
96 <param name="saveData" type="boolean" label="Save the data underlying data for the average profile"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
97 <param name="saveMatrix" type="boolean" label="Save the the matrix of values underlying the heatmap"/>
5
1f312af2f8db Uploaded
bgruening
parents: 4
diff changeset
98 <param name="saveSortedRegions" type="boolean" label="Save the regions after skipping zeros or min/max threshold values" help="This outputs the file of genomic intervals in the order that will be shown in the heatmap or summary profile. This is useful, for example, to generate other heatmaps keeping the sorting of the first heatmap."/>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
99 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
100 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
101
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
102 <conditional name="advancedOpt">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
103 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
104 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
105 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
106 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
107 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
108 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
109 <param name="averageType" type="select" label="Define the type of statistic that should be used for the profile.">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
110 <option value="mean" selected="true">mean</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
111 <option value="median">median</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
112 <option value="min">min</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
113 <option value="max">max</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
114 <option value="sum">sum</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
115 <option value="std">std</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
116 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
117 <param name="plotHeight" type="integer" value="5" min="3"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
118 label="Plot height"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
119 help="Height in cm. The default for the plot height is 5 centimeters. The minimum value is 3 cm." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
120 <param name="plotWidth" type="integer" value="8" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
121 label="Plot width"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
122 help="Width in cm. The default value is 8 centimeters. The minimum value is 1 cm." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
123 <param name="plotType" type="select" label="Plot type"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
124 help="For the summary plot (profile) only. The &quot;lines&quot; option will plot the profile line based on the average type selected. The &quot;fill&quot; option fills the region between zero and the profile curve. The fill in color is semi transparent to distinguish different profiles. The &quot;std&quot; option colors the region between the profile and the standard deviation of the data. As in the case of fill, a semi-transparent color is used. The option &quot;overlapped_lines&quot; plots each region values, one on top of the other; this option only works if &quot;one plot per proup&quot; is set.">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
125 <option value="lines" selected="true">lines</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
126 <option value="fill">fill</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
127 <option value="std">std</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
128 <option value="overlapped_lines">overlapped lines</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
129 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
130
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
131 <param name="regionsLabel" type="text" value="genes" size="30" label="Labels for the regions plotted in the heatmap" help="If more than one region is being plotted a list of labels separated by comma and limited by quotes, is required. For example, &quot;label1, label2&quot;."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
132 <param name="plotTitle" type="text" value="" size="30" label="Title of the plot" help="Title of the plot, to be printed on top of the generated image. Leave blank for no title." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
133 <param name="onePlotPerGroup" type="boolean" truevalue="--onePlotPerGroup" falsevalue="" label="Do one plot per group" help="When the region file contains groups separated by &quot;#&quot;, the default is to plot the averages for the distinct plots in one plot. If this option is set, each group will get its own plot, stacked on top of each other."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
134 <param name="yMin" type="float" value="" size="3" label="Minimum value for the Y-axis of the summary plot. Leave empty for automatic values" optional="true"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
135 <param name="yMax" type="float" value="" size="3" label="Maximum value for Y-axis of the summary plot. Leave empty for automatic values" optional="true"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
136 <param name="xAxisLabel" type="text" value="gene distance (bp)" size="50" label="Description for the x-axis label" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
137 <param name="yAxisLabel" type="text" value="" size="50" label="Description for the y-axis label for the top panel" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
138 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
139 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
140 </inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
141 <outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
142 <data format="png" name="outFileName" label="${tool.name} image">
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
143 <change_format>
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
144 <when input="output.outFileFormat" value="pdf" format="pdf" />
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
145 <when input="output.outFileFormat" value="svg" format="svg" />
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
146 <when input="output.outFileFormat" value="eps" format="eps" />
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
147 <when input="output.outFileFormat" value="emf" format="emf" />
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
148 </change_format>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
149 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
150 <data format="tabular" name="outFileNameData" label="${tool.name} raw plot data">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
151 <filter>(output['showOutputSettings'] == 'yes' and output['saveData'] == True)</filter>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
152 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
153 <data format="tabular" name="outFileNameMatrix" label="${tool.name} matrix of heatmap values">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
154 <filter>(output['showOutputSettings'] == 'yes' and output['saveMatrix'] == True)</filter>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
155 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
156 <data format="bed" name="outFileSortedRegions" label="${tool.name} sorted/filtered regions">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
157 <filter>(output['showOutputSettings'] == 'yes' and output['saveSortedRegions'] == True)</filter>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
158 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
159 </outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
160 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
161
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
162 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
163
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
164 This tool creates a profile plot for a score associated to genomic regions.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
165 Typically, these regions are genes, but any other regions defined in a BED or
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
166 INTERVAL format will work. A preprocessed matrix generated by the tool
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
167 computeMatrix is required.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
168
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
169 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
170
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
171 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
172
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
173 If you would like to give us feedback or you run into any trouble, please send an email to deeptools@googlegroups.com
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
174
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
175 This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
176
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
177
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
178 .. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
179 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
180
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
181 </help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
182 </tool>