annotate plotCorrelation.xml @ 62:1d932daaa198 draft

Uploaded
author bgruening
date Tue, 27 Jan 2015 15:19:23 -0500
parents
children 9bee2c86eeb1
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
62
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
1 <tool id="deeptools_plotCorrelation" name="plotCorrelation" version="@WRAPPER_VERSION@.0">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
2 <description>creates a heatmap for a score associated to genomic regions</description>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
3 <expand macro="requirements"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
4 <expand macro="stdio" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
5 <macros>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
6 <token name="@BINARY@">heatmapper</token>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
7 <import>deepTools_macros.xml</import>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
8 </macros>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
9 <command>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
10 <![CDATA[
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
11 heatmapper
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
12
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
13 --matrixFile $matrixFile
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
14 --outFileName $outFileName
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
15
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
16 #if $output.showOutputSettings == "yes"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
17 --plotFileFormat $output.outFileFormat
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
18 #if $outFileNameData:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
19 --outFileNameData '$outFileNameData'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
20 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
21
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
22 #if $outFileNameMatrix:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
23 --outFileNameMatrix '$outFileNameMatrix'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
24 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
25
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
26 #if $outFileSortedRegions:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
27 --outFileSortedRegions '$outFileSortedRegions'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
28 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
29 #else
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
30 --plotFileFormat 'png'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
31 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
32
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
33 #if $advancedOpt.showAdvancedOpt == "yes"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
34 #if $advancedOpt.sortRegions:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
35 --sortRegions '$advancedOpt.sortRegions'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
36 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
37
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
38 #if $advancedOpt.sortUsing:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
39 --sortUsing '$advancedOpt.sortUsing'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
40 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
41
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
42 #if $advancedOpt.averageTypeSummaryPlot:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
43 --averageTypeSummaryPlot '$advancedOpt.averageTypeSummaryPlot'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
44 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
45
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
46 #if str($advancedOpt.missingDataColor.value) != "None":
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
47 --missingDataColor '$advancedOpt.missingDataColor'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
48 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
49
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
50 --colorMap '$advancedOpt.colorMap'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
51
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
52 #if str($advancedOpt.zMin).strip() != "":
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
53 --zMin $advancedOpt.zMin
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
54 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
55 #if $advancedOpt.zMax:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
56 --zMax $advancedOpt.zMax
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
57 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
58
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
59 #if str($advancedOpt.yMin).strip() != "":
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
60 --yMin $advancedOpt.yMin
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
61 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
62 #if $advancedOpt.yMax:
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
63 --yMax $advancedOpt.yMax
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
64 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
65
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
66 --xAxisLabel '$advancedOpt.xAxisLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
67 --yAxisLabel '$advancedOpt.yAxisLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
68
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
69 --heatmapWidth $advancedOpt.heatmapWidth
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
70 --heatmapHeight $advancedOpt.heatmapHeight
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
71
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
72 --whatToShow '$advancedOpt.whatToShow'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
73
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
74 --startLabel '$advancedOpt.startLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
75 --endLabel '$advancedOpt.endLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
76 --refPointLabel '$advancedOpt.referencePointLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
77 --regionsLabel '$advancedOpt.regionsLabel'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
78
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
79 #if str($advancedOpt.plotTitle.value) != "None":
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
80 --plotTitle '$advancedOpt.plotTitle'
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
81 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
82
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
83 $advancedOpt.onePlotPerGroup
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
84
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
85 @KMEANS_CLUSTERING@
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
86
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
87 #end if
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
88 ]]>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
89 </command>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
90 <inputs>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
91 <param name="corData" format="bgzip" type="data" label="Matrix file from the computeMatrix tool"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
92
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
93 <expand macro="input_graphic_output_settings">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
94 <expand macro="input_image_file_format" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
95 <expand macro="input_save_matrix_values" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
96 </expand>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
97
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
98 <conditional name="advancedOpt" >
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
99 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
100 <option value="no" selected="true">no</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
101 <option value="yes">yes</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
102 </param>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
103 <when value="no" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
104 <when value="yes">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
105
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
106 <expand macro="colormap" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
107
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
108 <param name="zMin" type="float" value="" size="3"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
109 label="Minimum value for the heatmap intensities. Leave empty for automatic values"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
110 <param name="zMax" type="float" value="" size="3"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
111 label="Maximum value for the heatmap intensities. Leave empty for automatic values"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
112
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
113 <param name="plotNumbers" type="boolean" truevalue="--plotNumbers" falsevalue=""
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
114 label="Plot the correlation value"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
115 help="If set, then the correlation number is plotted on top of the heatmap. (--plotNumbers)"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
116
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
117
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
118
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
119
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
120 <param name="yMin" type="float" value="" size="3"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
121 label="Minimum value for the Y-axis of the summary plot. Leave empty for automatic values"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
122 <param name="yMax" type="float" value="" size="3"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
123 label="Maximum value for Y-axis of the summary plot. Leave empty for automatic values"/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
124 <param name="xAxisLabel" type="text" value="distance from TSS (bp)" size="200"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
125 label="Description for the x-axis label" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
126 <param name="yAxisLabel" type="text" value="genes" size="30"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
127 label="Description for the y-axis label for the top panel" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
128
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
129 <param name="heatmapWidth" type="float" value="7.5" min="1" max="100"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
130 label="Heatmap width in cm" help="The minimum value is 1 and the maximum is 100."/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
131 <param name="heatmapHeight" type="float" value="25" min="3" max="100"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
132 label="Heatmap height in cm" help="The minimum value is 3 and the maximum is 100."/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
133
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
134 <param name="whatToShow" type="select" label="What to show"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
135 help ="The default is to include a summary or profile plot on top of the heatmap and a heatmap colorbar.">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
136 <option value="plot, heatmap and colorbar" selected="true">summary plot, heatmap and colorbar</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
137 <option value="plot and heatmap">summary plot and heatmap (no colorbar)</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
138 <option value="heatmap only">heatmap only</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
139 <option value="heatmap and colorbar">heatmap and colorbar</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
140 <option value="colorbar only">colorbar only</option>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
141 </param>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
142
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
143 <param name="startLabel" type="text" value="TSS" size="10"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
144 label="Label for the region start"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
145 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;." />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
146 <param name="endLabel" type="text" value="TES" size="10"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
147 label="Label for the region end"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
148 help="[only for scale-regions mode] Label shown in the plot for the region end. Default is TES (transcription end site)."/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
149
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
150 <param name="referencePointLabel" type="text" value="TSS" size="10"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
151 label="Reference point label"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
152 help ="[only for scale-regions mode] Label shown in the plot for the reference-point. Default is the same as the reference point selected (e.g. TSS), but could be anything, e.g. &quot;peak start&quot; etc." />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
153 <param name="regionsLabel" type="text" value="genes" size="30"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
154 label="Labels for the regions plotted in the heatmap"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
155 help="If more than one region is being plotted a list of labels separated by comma and limited by quotes, is required. For example, label1, label2.">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
156 <sanitizer>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
157 <valid initial="string.printable">
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
158 </valid>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
159 </sanitizer>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
160 </param>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
161 <param name="plotTitle" type="text" value="" size="30"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
162 label="Title of the plot" help="Title of the plot, to be printed on top of the generated image. Leave blank for no title. (--plotTitle)" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
163 <param name="onePlotPerGroup" type="boolean" truevalue="--onePlotPerGroup" falsevalue=""
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
164 label="Do one plot per group"
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
165 help="When computeMatrix was used on more than one group of genes, the average plots for all the groups will be drawn in one panel by default. If this option is set, each group will get its own plot, stacked on top of each other."/>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
166
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
167 <expand macro="kmeans_clustering" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
168 </when>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
169 </conditional>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
170 </inputs>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
171 <outputs>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
172 <expand macro="output_image_file_format" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
173 <expand macro="output_graphic_outputs" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
174 <expand macro="output_save_matrix_values" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
175 </outputs>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
176 <tests>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
177 <test>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
178 <param name="matrixFile" value="computeMatrix_result1.gz" ftype="bgzip" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
179 <output name="outFileName" file="heatmapper_result1.png" ftype="png" compare="sim_size" delta="100" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
180 </test>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
181 </tests>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
182 <help>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
183 <![CDATA[
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
184 **What it does**
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
185
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
186 Tool for visualizing a correlation using either bamCorrelate or
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
187 bigwigCorrelate. Pearson or Spearman methods are available to compute correlation
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
188 coefficients. Results can be saved into a heat map image or as multiple
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
189 scatter plots. Further output files are optional.
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
190
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
191 -----
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
192
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
193 @REFERENCES@
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
194 ]]>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
195 </help>
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
196 <expand macro="citations" />
1d932daaa198 Uploaded
bgruening
parents:
diff changeset
197 </tool>