annotate bigwigCompare.xml @ 110:fa6ef7619bbd draft default tip

Uploaded
author bgruening
date Mon, 26 Jan 2015 13:10:16 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
110
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
1 <tool id="deeptools_bigwigCompare" name="bigwigCompare" version="@WRAPPER_VERSION@.0">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
2 <description>normalizes and compares two bigWig files to obtain the ratio, log2ratio or difference</description>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
3 <expand macro="requirements"/>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
4 <expand macro="stdio" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
5 <macros>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
6 <token name="@BINARY@">bigwigCompare</token>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
7 <import>deepTools_macros.xml</import>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
8 </macros>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
9 <command>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
10 <![CDATA[
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
11 bigwigCompare
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
12
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
13 @THREADS@
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
14
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
15 --bigwig1 '$bigwigFile1'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
16 --bigwig2 '$bigwigFile2'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
17
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
18 --outFileName '$outFileName'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
19 --outFileFormat '$outFileFormat'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
20
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
21 --ratio $comparison.comparison_select
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
22
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
23 #if $comparison.comparison_select in ['ratio','log2']:
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
24 --pseudocount $comparison.pseudocount
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
25 #end if
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
26
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
27 #if str($region).strip() != '':
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
28 --region '$region'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
29 #end if
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
30
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
31 #if $advancedOpt.showAdvancedOpt == "yes":
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
32
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
33 --missingDataAsZero $advancedOpt.missingDataAsZero
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
34 --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
35 --binSize $advancedOpt.binSize
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
36
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
37 #end if
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
38 ]]>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
39 </command>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
40 <inputs>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
41 <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
42 <param name="bigwigFile2" format="bigwig" type="data" label="bigWig file" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
43
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
44 <conditional name="comparison">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
45 <param name="comparison_select" type="select"
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
46 label="How to compare the two files" help="(--ratio)">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
47 <option value="log2" selected="true">compute log2 of the number of reads ratio</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
48 <option value="ratio">compute the ratio of the number of reads</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
49 <option value="subtract">compute difference (subtract input from treatment) of the number of reads</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
50 <option value="add">compute the sum over all reads</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
51 <option value="reciprocal_ratio">compute the reciprocal ratio of the number of reads</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
52 </param>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
53 <when value="log2">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
54 <expand macro="pseudocount" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
55 </when>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
56 <when value="ratio">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
57 <expand macro="pseudocount" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
58 </when>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
59 <when value="subtract" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
60 <when value="add" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
61 <when value="reciprocal_ratio" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
62 </conditional>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
63
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
64 <param name="outFileFormat" type="select" label="Coverage file format">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
65 <option value="bigwig" selected="true">bigwig</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
66 <option value="bedgraph">bedgraph</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
67 </param>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
68
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
69 <expand macro="region_limit_operation" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
70
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
71 <conditional name="advancedOpt">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
72 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
73 <option value="no" selected="true">no</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
74 <option value="yes">yes</option>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
75 </param>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
76 <when value="no" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
77 <when value="yes">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
78 <param name="binSize" type="integer" value="50" min="1"
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
79 label="Length, in base pairs, of the non-overlapping bin for averaging the score over the regions length"
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
80 help="Size of the bins in bp for the output of the bigwig/bedgraph file. (--binSize)"/>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
81 <param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
82 label ="Treat missing data as zero"
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
83 help ="This parameter determines if missing data should be replaced with a zero. If set to &quot;no&quot;, missing data will be ignored and will not be included in the output file at all. Missing data is defined as those regions for which no value exists in *any* of the bigwig files. The decision to include or exclude missing data depends on the interpretation of the data. Missing data in a bigwig file may mean that there is no information available for certain regions, for example a repetitive region that is not being considered. In the same file regions with low coverage may get zero read counts. If missing data is replaced by zero, this would convert the excluded repetitive regions into regions of low coverage. (--missingDataAsZero)" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
84 <expand macro="scaleFactor" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
85 </when>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
86 </conditional>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
87 </inputs>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
88 <outputs>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
89 <data format="bigwig" name="outFileName">
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
90 <change_format>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
91 <when input="outFileFormat" value="bigwig" format="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
92 <when input="outFileFormat" value="bedgraph" format="bedgraph" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
93 </change_format>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
94 </data>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
95 </outputs>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
96 <tests>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
97 <test>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
98 <param name="bigwigFile1" value="1.bigwig" ftype="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
99 <param name="bigwigFile2" value="1.bigwig" ftype="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
100 <param name="showAdvancedOpt" value="no" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
101 <param name="outFileFormat" value="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
102 <param name="binSize" value="5" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
103 <param name="comparison_select" value="ratio" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
104 <output name="outFileName" file="bigwigCompare_result1.bw" ftype="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
105 </test>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
106 <test>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
107 <param name="bigwigFile1" value="1.bigwig" ftype="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
108 <param name="bigwigFile2" value="1.bigwig" ftype="bigwig" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
109 <param name="showAdvancedOpt" value="no" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
110 <param name="outFileFormat" value="bedgraph" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
111 <param name="binSize" value="10" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
112 <param name="comparison_select" value="ratio" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
113 <output name="outFileName" file="bigwigCompare_result2.bg" ftype="bedgraph" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
114 </test>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
115 </tests>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
116 <help>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
117 <![CDATA[
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
118 **What it does**
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
119
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
120 This tool compares two bigwig files based on the number of mapped reads. To
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
121 compare the bigwig files the genome is partitioned into bins of equal size,
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
122 then the number of reads found in each BAM file are counted for such bins and
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
123 finally a summarizing value is reported. This value can be the ratio of the
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
124 number of reads per bin, the log2 of the ratio, the sum or the difference.
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
125
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
126
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
127 -----
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
128
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
129 @REFERENCES@
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
130 ]]>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
131 </help>
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
132 <expand macro="citations" />
fa6ef7619bbd Uploaded
bgruening
parents:
diff changeset
133 </tool>