annotate profiler.xml @ 43:c5787c91cab8 draft

Uploaded
author bgruening
date Tue, 04 Feb 2014 09:02:21 -0500
parents 2f7edf06a5da
children b9feca1f07f0
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
43
c5787c91cab8 Uploaded
bgruening
parents: 37
diff changeset
1 <tool id="deeptools_profiler" name="profiler" version="1.0.4">
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" />
22
8710187d1eb5 Uploaded
bgruening
parents: 10
diff changeset
6 <expand macro="stdio" />
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
7 <macros>
34
934b9fccabd4 Uploaded
bgruening
parents: 33
diff changeset
8 <token name="@BINARY@">profiler</token>
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
9 <import>deepTools_macros.xml</import>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
10 </macros>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
11 <command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
12 profiler
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
13
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
14 --matrixFile $matrixFile
24
e43b4015b4cc Uploaded
bgruening
parents: 22
diff changeset
15 --outFileName $outFileName
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
16
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
17 #if $output.showOutputSettings == "yes"
24
e43b4015b4cc Uploaded
bgruening
parents: 22
diff changeset
18 --plotFileFormat $output.outFileFormat
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
19
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
20 #if $output.saveData:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
21 --outFileNameData '$outFileNameData'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
22 #end if
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
23
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
24 #if $output.saveSortedRegions:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
25 --outFileSortedRegions '$outFileSortedRegions'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
26 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
27 #else
24
e43b4015b4cc Uploaded
bgruening
parents: 22
diff changeset
28 --plotFileFormat 'png'
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
29 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
30
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
31 #if $scaleRegions.showScaleRegionsOpt == "yes":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
32 --startLabel $scaleRegions.startLabel
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
33 --endLabel $scaleRegions.endLabel
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
34 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
35
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
36 #if $advancedOpt.showAdvancedOpt == "yes":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
37 #if $advancedOpt.averageType:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
38 --averageType '$advancedOpt.averageType'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
39 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
40 --plotHeight $advancedOpt.plotHeight
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
41 --plotWidth $advancedOpt.plotWidth
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
42 --plotType $advancedOpt.plotType
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
43
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
44 --regionsLabel '$advancedOpt.regionsLabel'
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
45
34
934b9fccabd4 Uploaded
bgruening
parents: 33
diff changeset
46 #if str($advancedOpt.plotTitle).strip() != "":
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
47 --plotTitle '$advancedOpt.plotTitle'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
48 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
49
34
934b9fccabd4 Uploaded
bgruening
parents: 33
diff changeset
50 #if str($advancedOpt.colors).strip() != "":
32
3f2096404113 Uploaded
bgruening
parents: 31
diff changeset
51 --colors #echo ' '.join( ["'%s'" % $color for $color in $advancedOpt.colors.split()] )#
30
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
52 #end if
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
53
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
54 $advancedOpt.onePlotPerGroup
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
55
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
56 #if $advancedOpt.yMin:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
57 --yMin $advancedOpt.yMin
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
58 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
59 #if $advancedOpt.yMax:
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
60 --yMax $advancedOpt.yMax
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
61 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
62
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
63 --xAxisLabel '$advancedOpt.xAxisLabel'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
64 #if str($advancedOpt.yAxisLabel.value) != "None":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
65 --yAxisLabel '$advancedOpt.yAxisLabel'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
66 #end if
36
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
67
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
68 @kmeans_clusterin@
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
69
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
70 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
71 </command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
72 <inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
73 <param name="matrixFile" format="bgzip" type="data" label="Matrix file from the computeMatrix tool"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
74 <conditional name="scaleRegions">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
75 <param name="showScaleRegionsOpt" type="select" label="The input matrix was computed in scale-regions mode">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
76 <option value="no" selected="true">no</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
77 <option value="yes">yes</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
78 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
79 <when value="no" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
80 <when value="yes">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
81 <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
82 <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
83 </when>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
84 </conditional>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85
27
f996339050ac Uploaded
bgruening
parents: 25
diff changeset
86 <expand macro="input_graphic_output_settings">
25
df9f0dbb1d2a Uploaded
bgruening
parents: 24
diff changeset
87 <expand macro="input_image_file_format" />
df9f0dbb1d2a Uploaded
bgruening
parents: 24
diff changeset
88 </expand>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
90 <conditional name="advancedOpt">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
91 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
92 <option value="no" selected="true">no</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
93 <option value="yes">yes</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
94 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
95 <when value="no" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
96 <when value="yes">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
97 <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
98 <option value="mean" selected="true">mean</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
99 <option value="median">median</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
100 <option value="min">min</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
101 <option value="max">max</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
102 <option value="sum">sum</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
103 <option value="std">std</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
104 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
105 <param name="plotHeight" type="integer" value="5" min="3"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
106 label="Plot height"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
107 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
108 <param name="plotWidth" type="integer" value="8" min="1"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
109 label="Plot width"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
110 help="Width in cm. The default value is 8 centimeters. The minimum value is 1 cm." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
111 <param name="plotType" type="select" label="Plot type"
30
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
112 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;add standard error&quot; option colors the region between the profile and the standard error 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.">
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
113 <option value="lines" selected="true">lines</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
114 <option value="fill">fill</option>
30
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
115 <option value="se">add standard error</option>
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
116 <option value="overlapped_lines">overlapped lines</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
117 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
118 <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
119 <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." />
32
3f2096404113 Uploaded
bgruening
parents: 31
diff changeset
120 <param name="colors" type="text" value="" size="40" label="List of colors to use for the plotted lines" help="Color names and html hex strings (e.g. #eeff22) are accepted. The color names should be given separated by spaces. (--colors red blue green)">
3f2096404113 Uploaded
bgruening
parents: 31
diff changeset
121 <validator type="expression" message="Only numbers, digits, '#' and spaces are allowed.">all(c in ' #abcdefghijklmnopqrstuvwxyz0123456789' for c in value)</validator>
30
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
122 </param>
2e5b92e7f3cb Uploaded
bgruening
parents: 27
diff changeset
123
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
124 <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
125 <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
126 <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
127 <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
128 <param name="yAxisLabel" type="text" value="" size="50" label="Description for the y-axis label for the top panel" />
36
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
129
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
130 <expand macro="kmeans_clustering" />
ea2f64efe70d Uploaded
bgruening
parents: 34
diff changeset
131
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
132 </when>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
133 </conditional>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
134 </inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
135 <outputs>
27
f996339050ac Uploaded
bgruening
parents: 25
diff changeset
136 <expand macro="output_image_file_format" />
f996339050ac Uploaded
bgruening
parents: 25
diff changeset
137 <expand macro="output_graphic_outputs" />
22
8710187d1eb5 Uploaded
bgruening
parents: 10
diff changeset
138 </outputs>
8710187d1eb5 Uploaded
bgruening
parents: 10
diff changeset
139 <help>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
140
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
141 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
142
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
143 This tool plots the average enrichments over all genomic
43
c5787c91cab8 Uploaded
bgruening
parents: 37
diff changeset
144 regions supplied to computeMarix. It requires that computeMatrix was successfully run.
c5787c91cab8 Uploaded
bgruening
parents: 37
diff changeset
145 It is a very useful complement to the heatmapper, especially in cases when you want to
c5787c91cab8 Uploaded
bgruening
parents: 37
diff changeset
146 compare the scores for many different groups. Like heatmapper, profiler does not change the
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
147 values that were compute by computeMatrix, but you can choose between
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
148 many different ways to color and display the plots.
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
149
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
150
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
151 .. image:: $PATH_TO_IMAGES/visual_profiler_DmelPolII.png
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
152 :alt: Meta-gene profile of Rna Polymerase II
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
153
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
154
43
c5787c91cab8 Uploaded
bgruening
parents: 37
diff changeset
155 You can find more details on the profiler wiki page: https://github.com/fidelram/deepTools/wiki/Visualizations#wiki-profiler
37
2f7edf06a5da Uploaded
bgruening
parents: 36
diff changeset
156
2f7edf06a5da Uploaded
bgruening
parents: 36
diff changeset
157
2f7edf06a5da Uploaded
bgruening
parents: 36
diff changeset
158 -----
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
159
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
160 @REFERENCES@
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
161
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
162 </help>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
163 </tool>