Mercurial > repos > bgruening > upload_testing

comparison computeMatrix.xml @ 39:c6f1a059bc7d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Uploaded
author bgruening
date Fri, 02 Aug 2013 12:18:55 -0400
parents
children 6a2a7374450b
comparison
equal deleted inserted replaced
38:1a78aa9ea234 39:c6f1a059bc7d
1 <tool id="computeMatrix" name="computeMatrix" version="1.0">
2 <description>summarizes and prepares an intermediary file containing scores associated with genomic regions that can be used afterwards to plot a heatmap or a profile</description>
3 <command>
4 computeMatrix
5 $mode.mode_select
6 --regionsFileName '$regionsFile'
7 --scoreFileName '$scoreFile'
8 --outFileName '$outFileName'
9
10 #if $output.showOutputSettings == "yes"
11 #if $output.saveData:
12 --outFileNameData '$outFileNameData'
13 #end if
14 #if $output.saveMatrix:
15 --outFileNameMatrix '$outFileNameMatrix'
16 #end if
17
18 #if $output.saveSortedRegions:
19 --outFileSortedRegions '$outFileSortedRegions'
20 #end if
21 #end if
22
23 #if $mode.mode_select == "reference-point":
24 --referencePoint $mode.referencePoint
25 $mode.nanAfterEnd
26 --beforeRegionStartLength $mode.beforeRegionStartLength
27 --afterRegionStartLength $mode.afterRegionStartLength
28 #else
29 --regionBodyLength $mode.regionBodyLength
30 --startLabel $mode.startLabel
31 --endLabel $mode.endLabel
32 #if $mode.regionStartLength.regionStartLength_select == "yes":
33 --beforeRegionStartLength $mode.regionStartLength.beforeRegionStartLength
34 --afterRegionStartLength $mode.regionStartLength.afterRegionStartLength
35 #end if
36 #end if
37
38 #if $advancedOpt.showAdvancedOpt == "yes":
39 --sortRegions '$advancedOpt.sortRegions'
40 --sortUsing '$advancedOpt.sortUsing'
41 --averageTypeBins '$advancedOpt.averageTypeBins'
42 $advancedOpt.missingDataAsZero
43 $advancedOpt.skipZeros
44
45 #if $advancedOpt.minThreshold:
46 --minThreshold $advancedOpt.minThreshold
47 #end if
48 #if $advancedOpt.maxThreshold:
49 --maxThreshold $advancedOpt.maxThreshold
50 #end if
51 #if $advancedOpt.scale:
52 --scale $advancedOpt.scale
53 #end if
54
55 #end if
56 --numberOfProcessors 4
57 </command>
58 <inputs>
59 <param name="regionsFile" format="bed,gff" type="data" label="Regions to plot" help="File, in BED or GFF format, containing the regions to plot."/>
60 <param name="scoreFile" format="bigwig,bam" type="data" label="Score file" help="Either a bigWig file (containing a score, usually covering the whole genome) or a BAM file. For this last case, coverage counts will be used for the heatmap."/>
61
62 <conditional name="mode" >
63 <param name="mode_select" type="select" label="computeMatrix has two main output options" help="In the scale-regions mode, all regions in the BED/GFF file are stretched or shrunk to the same length (bp) that is indicated by the user. Reference-point refers to a position within the BED/GFF regions (e.g start of region). In the reference-point mode only those genomic positions before (downstream) and/or after (upstream) the reference point will be plotted.">
64 <option value="scale-regions" selected="true">scale-regions</option>
65 <option value="reference-point">reference-point</option>
66 </param>
67
68 <when value="scale-regions" >
69 <param name="regionBodyLength" type="integer" value="500" label="Distance in bp to which all regions are going to be fitted"/>
70 <param name="startLabel" type="text" value="TSS" size="10" label="Label for the region start" help ="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;." />
71 <param name="endLabel" type="text" value="TES" size="10" label="Label for the region end" help="Label shown in the plot for the region end. Default is TES (transcription end site)."/>
72 <conditional name="regionStartLength">
73 <param name="regionStartLength_select" type="select" label="Set distance up- and downstream of the given regions">
74 <option value="no" selected="true">no</option>
75 <option value="yes">yes</option>
76 </param>
77 <when value="no" />
78 <when value="yes">
79 <param name="beforeRegionStartLength" type="integer" value="1000" min="1" optional="true" label="Distance upstream of the start site of the regions defined in the region file" help="If the regions are genes, this would be the distance upstream of the transcription start site."/>
80
81 <param name="afterRegionStartLength" type="integer" value="1000" min="1" optional="true" label="Distance downstream of the end site of the given regions" help="If the regions are genes, this would be the distance downstream of the transcription end site."/>
82 </when>
83 </conditional>
84 </when>
85
86 <when value="reference-point">
87 <param name="referencePoint" type="select" label="The reference point for the plotting">
88 <option value="TSS" selected="true">region start (TSS)</option>
89 <option value="TES" selected="true">region end (TES)</option>
90 <option value="center" selected="true">center of the region</option>
91 </param>
92 <param name="nanAfterEnd" type="boolean" truevalue="--nanAfterEnd" falsevalue="" label="Discard any values after the region end" help="This is useful to visualize the region end when not using the scale-regions mode and when the reference-point is set to the TSS."/>
93 <param name="beforeRegionStartLength" type="integer" value="1000" min="1" label="Distance upstream of the start site of the regions defined in the region file" help="If the regions are genes, this would be the distance upstream of the transcription start site."/>
94
95 <param name="afterRegionStartLength" type="integer" value="1000" min="1" label="Distance downstream of the end site of the given regions" help="If the regions are genes, this would be the distance downstream of the transcription end site."/>
96 </when>
97 </conditional>
98
99 <conditional name="output" >
100 <param name="showOutputSettings" type="select" label="Show additional output options" >
101 <option value="no" selected="true">no</option>
102 <option value="yes">yes</option>
103 </param>
104 <when value="no" />
105 <when value="yes">
106 <param name="saveData" type="boolean" label="Save the averages per matrix column into a text file" help="This corresponds to the underlying data used to plot a summary profile."/>
107 <param name="saveMatrix" type="boolean" label="Save the matrix of values underlying the heatmap" help="This matrix can easily be loaded into R or other programs."/>
108 <param name="saveSortedRegions" type="boolean" label="Save the regions after skiping zeros or min/max threshold values" help="The order of the regions in the file follows the sorting order selected. This is useful, for example, to generate other heatmaps keeping the sorting of the first heatmap."/>
109 </when>
110 </conditional>
111
112
113 <conditional name="advancedOpt" >
114 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
115 <option value="no" selected="true">no</option>
116 <option value="yes">yes</option>
117 </param>
118 <when value="no" />
119 <when value="yes">
120
121 <param name="binSize" type="integer" value="100" min="1" optional="true" label="Length, in base pairs, of the non-overlapping bin for averaging the score over the regions length" />
122
123 <param name="sortRegions" type="select" label="Sort regions"
124 help="Whether the output file should present the regions sorted.">
125 <option value="no" selected="true">no ordering</option>
126 <option value="descend">descending order</option>
127 <option value="ascend">ascending order</option>
128 </param>
129
130 <param name="sortUsing" type="select" label="Method used for sorting." help="The value is computed for each row." >
131 <option value="mean" selected="true">mean</option>
132 <option value="median">median</option>
133 <option value="min">min</option>
134 <option value="max">max</option>
135 <option value="sum">sum</option>
136 <option value="region_length">region length</option>
137 </param>
138
139 <param name="averageTypeBins" type="select" label="Define the type of statistic that should be used over the bin size range">
140 <option value="mean" selected="true">mean</option>
141 <option value="median">median</option>
142 <option value="min">min</option>
143 <option value="max">max</option>
144 <option value="sum">sum</option>
145 <option value="std">std</option>
146 </param>
147
148 <param name="missingDataAsZero" type="boolean" truevalue="--missingDataAsZero" falsevalue="" label="Indicate missing data as zero" help="Only for bigwig input! Set to &quot;yes&quot;, if missing data should be indicated as zeros. Default is to ignore such cases which will be depicted as black areas in the heatmap. (see &quot;Missing data color&quot; options of the heatmapper for additional options)."/>
149
150 <param name="skipZeros" type="boolean" truevalue="--skipZeros" falsevalue="" label="Skip zeros" help="Whether regions with only scores of zero should be included or not. Default is to include them."/>
151
152 <param name="minThreshold" type="float" optional="true" label="Minimum threshold" help="Any region containing a value that is equal or less than this numeric value will be skipped. This is useful to skip, for example, genes where the read count is zero for any of the bins. This could be the result of unmappable areas and can bias the overall results."/>
153 <param name="maxThreshold" type="float" optional="true" label="Maximum threshold" help="Any region containing a value that is equal or higher that this numeric value will be skipped. The max threshold is useful to skip those few regions with very high read counts (e.g. major satellites) that may bias the average values."/>
154 <param name="scale" type="float" optional="true" label="Scale" help="If set, all values are multiplied by this number."/>
155 </when>
156 </conditional>
157
158 </inputs>
159 <outputs>
160 <data format="bgzip" name="outFileName" label="${tool.name} on ${on_string}: matrix">
161 </data>
162 <data format="tabular" name="outFileNameData" label="${tool.name} on ${on_string}: raw data">
163 <filter>(output['showOutputSettings'] == 'yes' and output['saveData'] == True)</filter>
164 </data>
165 <data format="tabular" name="outFileNameMatrix" label="${tool.name} on ${on_string}: matrix of values">
166 <filter>(output['showOutputSettings'] == 'yes' and output['saveMatrix'] == True)</filter>
167 </data>
168 <data format="bed" name="outFileSortedRegions" label="${tool.name} on ${on_string}: sorted/filtered regions">
169 <filter>(output['showOutputSettings'] == 'yes' and output['saveSortedRegions'] == True)</filter>
170 </data>
171 </outputs>
172 <help>
173 **What it does**
174
175 This tool summarizes and prepares an intermediary file containing scores associated with genomic regions that can be used afterwards to plot a heatmap or a profile. Typically, these genomic regions are genes, but any other regions defined in a BED or GFF format can be used. This tool can also be used to filter and sort regions according to their score.
176
177 -----
178
179 .. class:: infomark
180
181 Please acknowledge that this tool **is still in development** and we will be very happy to receive feedback from the users. If you run into any trouble please sent an email to `Fidel Ramirez`_.
182
183 This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.
184
185
186 .. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
187 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
188 .. _Fidel Ramirez: ramirez@ie-freiburg.mpg.de
189 </help>
190
191 </tool>