annotate profiler.xml @ 61:f3140d17939e draft

Uploaded
author bgruening
date Fri, 23 Jan 2015 16:53:31 -0500
parents
children 9bee2c86eeb1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
61
f3140d17939e Uploaded
bgruening
parents:
diff changeset
1 <tool id="deeptools_profiler" name="profiler" version="@WRAPPER_VERSION@.0">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
2 <description>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
3 creates a profile plot for a score associated to genomic regions
f3140d17939e Uploaded
bgruening
parents:
diff changeset
4 </description>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
5 <expand macro="requirements" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
6 <expand macro="stdio" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
7 <macros>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
8 <token name="@BINARY@">profiler</token>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
9 <import>deepTools_macros.xml</import>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
10 </macros>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
11 <command>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
12 <![CDATA[
f3140d17939e Uploaded
bgruening
parents:
diff changeset
13 profiler
f3140d17939e Uploaded
bgruening
parents:
diff changeset
14
f3140d17939e Uploaded
bgruening
parents:
diff changeset
15 --matrixFile $matrixFile
f3140d17939e Uploaded
bgruening
parents:
diff changeset
16 --outFileName $outFileName
f3140d17939e Uploaded
bgruening
parents:
diff changeset
17
f3140d17939e Uploaded
bgruening
parents:
diff changeset
18 #if $output.showOutputSettings == "yes"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
19 --plotFileFormat $output.outFileFormat
f3140d17939e Uploaded
bgruening
parents:
diff changeset
20
f3140d17939e Uploaded
bgruening
parents:
diff changeset
21 #if $output.saveData:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
22 --outFileNameData '$outFileNameData'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
23 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
24
f3140d17939e Uploaded
bgruening
parents:
diff changeset
25 #if $output.saveSortedRegions:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
26 --outFileSortedRegions '$outFileSortedRegions'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
27 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
28 #else
f3140d17939e Uploaded
bgruening
parents:
diff changeset
29 --plotFileFormat 'png'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
30 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
31
f3140d17939e Uploaded
bgruening
parents:
diff changeset
32 #if $scaleRegions.showScaleRegionsOpt == "yes":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
33 --startLabel '$scaleRegions.startLabel'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
34 --endLabel '$scaleRegions.endLabel'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
35 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
36
f3140d17939e Uploaded
bgruening
parents:
diff changeset
37 #if $advancedOpt.showAdvancedOpt == "yes":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
38 #if $advancedOpt.averageType:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
39 --averageType '$advancedOpt.averageType'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
40 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
41 --plotHeight $advancedOpt.plotHeight
f3140d17939e Uploaded
bgruening
parents:
diff changeset
42 --plotWidth $advancedOpt.plotWidth
f3140d17939e Uploaded
bgruening
parents:
diff changeset
43 --plotType $advancedOpt.plotType
f3140d17939e Uploaded
bgruening
parents:
diff changeset
44
f3140d17939e Uploaded
bgruening
parents:
diff changeset
45 --regionsLabel '$advancedOpt.regionsLabel'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
46
f3140d17939e Uploaded
bgruening
parents:
diff changeset
47 #if str($advancedOpt.plotTitle).strip() != "":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
48 --plotTitle '$advancedOpt.plotTitle'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
49 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
50
f3140d17939e Uploaded
bgruening
parents:
diff changeset
51 #if str($advancedOpt.colors).strip() != "":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
52 --colors #echo ' '.join( ["'%s'" % $color for $color in $advancedOpt.colors.split()] )#
f3140d17939e Uploaded
bgruening
parents:
diff changeset
53 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
54
f3140d17939e Uploaded
bgruening
parents:
diff changeset
55 $advancedOpt.onePlotPerGroup
f3140d17939e Uploaded
bgruening
parents:
diff changeset
56
f3140d17939e Uploaded
bgruening
parents:
diff changeset
57 #if $advancedOpt.yMin:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
58 --yMin $advancedOpt.yMin
f3140d17939e Uploaded
bgruening
parents:
diff changeset
59 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
60 #if $advancedOpt.yMax:
f3140d17939e Uploaded
bgruening
parents:
diff changeset
61 --yMax $advancedOpt.yMax
f3140d17939e Uploaded
bgruening
parents:
diff changeset
62 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
63
f3140d17939e Uploaded
bgruening
parents:
diff changeset
64 --xAxisLabel '$advancedOpt.xAxisLabel'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
65 #if str($advancedOpt.yAxisLabel.value) != "None":
f3140d17939e Uploaded
bgruening
parents:
diff changeset
66 --yAxisLabel '$advancedOpt.yAxisLabel'
f3140d17939e Uploaded
bgruening
parents:
diff changeset
67 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
68
f3140d17939e Uploaded
bgruening
parents:
diff changeset
69 @KMEANS_CLUSTERING@
f3140d17939e Uploaded
bgruening
parents:
diff changeset
70
f3140d17939e Uploaded
bgruening
parents:
diff changeset
71 #end if
f3140d17939e Uploaded
bgruening
parents:
diff changeset
72 ]]>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
73 </command>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
74 <inputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
75 <param name="matrixFile" format="bgzip" type="data" label="Matrix file from the computeMatrix tool"/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
76 <conditional name="scaleRegions">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
77 <param name="showScaleRegionsOpt" type="select" label="The input matrix was computed in scale-regions mode">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
78 <option value="no" selected="true">no</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
79 <option value="yes">yes</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
80 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
81 <when value="no" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
82 <when value="yes">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
83 <param name="startLabel" type="text" value="TSS" size="10"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
84 label="Label for the region start"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
85 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;." />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
86 <param name="endLabel" type="text" value="TES" size="10"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
87 label="Label for the region end"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
88 help="[only for scale-regions mode] Label shown in the plot for the region end. Default is TES (transcription end site)."/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
89 </when>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
90 </conditional>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
91
f3140d17939e Uploaded
bgruening
parents:
diff changeset
92 <expand macro="input_graphic_output_settings">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
93 <expand macro="input_image_file_format" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
94 </expand>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
95
f3140d17939e Uploaded
bgruening
parents:
diff changeset
96 <conditional name="advancedOpt">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
97 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
f3140d17939e Uploaded
bgruening
parents:
diff changeset
98 <option value="no" selected="true">no</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
99 <option value="yes">yes</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
100 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
101 <when value="no" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
102 <when value="yes">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
103 <param name="averageType" type="select" label="Define the type of statistic that should be used for the profile.">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
104 <option value="mean" selected="true">mean</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
105 <option value="median">median</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
106 <option value="min">min</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
107 <option value="max">max</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
108 <option value="sum">sum</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
109 <option value="std">std</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
110 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
111 <param name="plotHeight" type="integer" value="5" min="3"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
112 label="Plot height"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
113 help="Height in cm. The default for the plot height is 5 centimeters. The minimum value is 3 cm." />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
114 <param name="plotWidth" type="integer" value="8" min="1"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
115 label="Plot width"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
116 help="Width in cm. The default value is 8 centimeters. The minimum value is 1 cm." />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
117 <param name="plotType" type="select" label="Plot type"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
118 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.">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
119 <option value="lines" selected="true">lines</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
120 <option value="fill">fill</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
121 <option value="se">add standard error</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
122 <option value="overlapped_lines">overlapped lines</option>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
123 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
124 <param name="regionsLabel" type="text" value="genes" size="30"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
125 label="Labels for the regions plotted in the heatmap"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
126 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;."/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
127 <param name="plotTitle" type="text" value="" size="30"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
128 label="Title of the plot"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
129 help="Title of the plot, to be printed on top of the generated image. Leave blank for no title." />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
130 <param name="colors" type="text" value="" size="40"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
131 label="List of colors to use for the plotted lines"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
132 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)">
f3140d17939e Uploaded
bgruening
parents:
diff changeset
133 <validator type="expression"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
134 message="Only numbers, digits, '#' and spaces are allowed.">all(c in ' #abcdefghijklmnopqrstuvwxyz0123456789' for c in value)</validator>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
135 </param>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
136
f3140d17939e Uploaded
bgruening
parents:
diff changeset
137 <param name="onePlotPerGroup" type="boolean" truevalue="--onePlotPerGroup" falsevalue=""
f3140d17939e Uploaded
bgruening
parents:
diff changeset
138 label="Do one plot per group"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
139 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."/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
140 <param name="yMin" type="float" value="" size="3" optional="true"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
141 label="Minimum value for the Y-axis of the summary plot. Leave empty for automatic values"/>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
142 <param name="yMax" type="float" value="" size="3" optional="true"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
143 label="Maximum value for Y-axis of the summary plot. Leave empty for automatic values" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
144 <param name="xAxisLabel" type="text" value="gene distance (bp)" size="50"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
145 label="Description for the x-axis label" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
146 <param name="yAxisLabel" type="text" value="" size="50"
f3140d17939e Uploaded
bgruening
parents:
diff changeset
147 label="Description for the y-axis label for the top panel" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
148
f3140d17939e Uploaded
bgruening
parents:
diff changeset
149 <expand macro="kmeans_clustering" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
150
f3140d17939e Uploaded
bgruening
parents:
diff changeset
151 </when>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
152 </conditional>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
153 </inputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
154 <outputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
155 <expand macro="output_image_file_format" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
156 <expand macro="output_graphic_outputs" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
157 </outputs>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
158 <help>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
159 <![CDATA[
f3140d17939e Uploaded
bgruening
parents:
diff changeset
160 **What it does**
f3140d17939e Uploaded
bgruening
parents:
diff changeset
161
f3140d17939e Uploaded
bgruening
parents:
diff changeset
162 This tool plots the average enrichments over all genomic
f3140d17939e Uploaded
bgruening
parents:
diff changeset
163 regions supplied to computeMarix. It requires that computeMatrix was successfully run.
f3140d17939e Uploaded
bgruening
parents:
diff changeset
164 It is a very useful complement to the heatmapper, especially in cases when you want to
f3140d17939e Uploaded
bgruening
parents:
diff changeset
165 compare the scores for many different groups. Like heatmapper, profiler does not change the
f3140d17939e Uploaded
bgruening
parents:
diff changeset
166 values that were compute by computeMatrix, but you can choose between
f3140d17939e Uploaded
bgruening
parents:
diff changeset
167 many different ways to color and display the plots.
f3140d17939e Uploaded
bgruening
parents:
diff changeset
168
f3140d17939e Uploaded
bgruening
parents:
diff changeset
169
f3140d17939e Uploaded
bgruening
parents:
diff changeset
170 .. image:: $PATH_TO_IMAGES/visual_profiler_DmelPolII.png
f3140d17939e Uploaded
bgruening
parents:
diff changeset
171 :alt: Meta-gene profile of Rna Polymerase II
f3140d17939e Uploaded
bgruening
parents:
diff changeset
172
f3140d17939e Uploaded
bgruening
parents:
diff changeset
173
f3140d17939e Uploaded
bgruening
parents:
diff changeset
174 You can find more details on the profiler wiki page: https://github.com/fidelram/deepTools/wiki/Visualizations#wiki-profiler
f3140d17939e Uploaded
bgruening
parents:
diff changeset
175
f3140d17939e Uploaded
bgruening
parents:
diff changeset
176
f3140d17939e Uploaded
bgruening
parents:
diff changeset
177 -----
f3140d17939e Uploaded
bgruening
parents:
diff changeset
178
f3140d17939e Uploaded
bgruening
parents:
diff changeset
179 @REFERENCES@
f3140d17939e Uploaded
bgruening
parents:
diff changeset
180 ]]>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
181 </help>
f3140d17939e Uploaded
bgruening
parents:
diff changeset
182 <expand macro="citations" />
f3140d17939e Uploaded
bgruening
parents:
diff changeset
183 </tool>