annotate profiler.xml @ 14:b0d64a9930d6 draft

Uploaded
author bgruening
date Thu, 14 Nov 2013 05:43:15 -0500
parents a68a771625d2
children 8710187d1eb5
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">
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
2 <description>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
3 creates a profile plot for a score associated to genomic regions
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
4 </description>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
5 <expand macro="requirements" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
6 <macros>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
7 <import>deepTools_macros.xml</import>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
8 </macros>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
9 <command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
10 profiler
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
11
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
12 --matrixFile $matrixFile
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
13
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
14 #if $output.showOutputSettings == "yes"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
15 #set newoutFileName = str($outFileName)+"."+str($output.outFileFormat)
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
16 --outFileName $newoutFileName
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
17
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
18 #if $output.saveData:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
19 --outFileNameData '$outFileNameData'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
20 #end if
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
21
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
22 #if $output.saveMatrix:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
23 --outFileNameMatrix '$outFileNameMatrix'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
24 #end if
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
25
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
26 #if $output.saveSortedRegions:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
27 --outFileSortedRegions '$outFileSortedRegions'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
28 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
29 #else
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
30 #set newoutFileName = str($outFileName)+".png"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
31 --outFileName $newoutFileName
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
32 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
33
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
34 #if $scaleRegions.showScaleRegionsOpt == "yes":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
35 --startLabel $scaleRegions.startLabel
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
36 --endLabel $scaleRegions.endLabel
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
37 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
38
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
39 #if $advancedOpt.showAdvancedOpt == "yes":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
40 #if $advancedOpt.averageType:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
41 --averageType '$advancedOpt.averageType'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
42 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
43 --plotHeight $advancedOpt.plotHeight
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
44 --plotWidth $advancedOpt.plotWidth
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
45 --plotType $advancedOpt.plotType
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
46
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
47 --regionsLabel '$advancedOpt.regionsLabel'
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
48
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
49 #if str($advancedOpt.plotTitle.value) != "None":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
50 --plotTitle '$advancedOpt.plotTitle'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
51 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
52
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
53 $advancedOpt.onePlotPerGroup
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
54
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
55 #if $advancedOpt.yMin:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
56 --yMin $advancedOpt.yMin
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
57 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
58 #if $advancedOpt.yMax:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
59 --yMax $advancedOpt.yMax
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
60 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
61
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
62 --xAxisLabel '$advancedOpt.xAxisLabel'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
63 #if str($advancedOpt.yAxisLabel.value) != "None":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
64 --yAxisLabel '$advancedOpt.yAxisLabel'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
65 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
66 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
67 ; mv $newoutFileName $outFileName
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
68 </command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
69 <inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
70 <param name="matrixFile" format="bgzip" type="data" label="Matrix file from the computeMatrix tool"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
71 <conditional name="scaleRegions">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
72 <param name="showScaleRegionsOpt" type="select" label="The input matrix was computed in scale-regions mode">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
73 <option value="no" selected="true">no</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
74 <option value="yes">yes</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
75 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
76 <when value="no" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
77 <when value="yes">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
78 <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;." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
79 <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)."/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
80 </when>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
81 </conditional>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
83 <expand macro="graphic_output_settings" />
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
85 <conditional name="advancedOpt">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
86 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
87 <option value="no" selected="true">no</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
88 <option value="yes">yes</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
89 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
90 <when value="no" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
91 <when value="yes">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
92 <param name="averageType" type="select" label="Define the type of statistic that should be used for the profile.">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
93 <option value="mean" selected="true">mean</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
94 <option value="median">median</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
95 <option value="min">min</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
96 <option value="max">max</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
97 <option value="sum">sum</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
98 <option value="std">std</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
99 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
100 <param name="plotHeight" type="integer" value="5" min="3"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
101 label="Plot height"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
102 help="Height in cm. The default for the plot height is 5 centimeters. The minimum value is 3 cm." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
103 <param name="plotWidth" type="integer" value="8" min="1"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
104 label="Plot width"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
105 help="Width in cm. The default value is 8 centimeters. The minimum value is 1 cm." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
106 <param name="plotType" type="select" label="Plot type"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
107 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.">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
108 <option value="lines" selected="true">lines</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
109 <option value="fill">fill</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
110 <option value="std">std</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
111 <option value="overlapped_lines">overlapped lines</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
112 </param>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
113
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
114 <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;."/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
115 <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." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
116 <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."/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
117 <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"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
118 <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"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
119 <param name="xAxisLabel" type="text" value="gene distance (bp)" size="50" label="Description for the x-axis label" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
120 <param name="yAxisLabel" type="text" value="" size="50" label="Description for the y-axis label for the top panel" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
121 </when>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
122 </conditional>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
123 </inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
124 <outputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
125 <data format="png" name="outFileName" label="${tool.name} image">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
126 <change_format>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
127 <when input="output.outFileFormat" value="pdf" format="pdf" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
128 <when input="output.outFileFormat" value="svg" format="svg" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
129 <when input="output.outFileFormat" value="eps" format="eps" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
130 <when input="output.outFileFormat" value="emf" format="emf" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
131 </change_format>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
132 </data>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
133 <data format="tabular" name="outFileNameData" label="${tool.name} raw plot data">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
134 <filter>(output['showOutputSettings'] == 'yes' and output['saveData'] == True)</filter>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
135 </data>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
136 <data format="tabular" name="outFileNameMatrix" label="${tool.name} matrix of heatmap values">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
137 <filter>(output['showOutputSettings'] == 'yes' and output['saveMatrix'] == True)</filter>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
138 </data>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
139 <data format="bed" name="outFileSortedRegions" label="${tool.name} sorted/filtered regions">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
140 <filter>(output['showOutputSettings'] == 'yes' and output['saveSortedRegions'] == True)</filter>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
141 </data>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
142 </outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
143 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
144
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
145 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
146
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
147 This tool plots the average enrichments over all genomic
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
148 regions supplied to computeMarix. It is a very useful complement to the
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
149 heatmapper, especially in cases when you want to compare the scores for
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
150 many different groups. Like heatmapper, profiler does not change the
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
151 values that were compute by computeMatrix, but you can choose between
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
152 many different ways to color and display the plots.
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
153
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
154
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
155 .. image:: $PATH_TO_IMAGES/visual_profiler_DmelPolII.png
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
156 :alt: Meta-gene profile of Rna Polymerase II
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
157
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
158
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
159 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
160
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
161 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
162
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
163 @REFERENCES@
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
164
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
165 </help>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
166 </tool>