annotate bigwigCompare.xml @ 54:87bfd96f8d95 draft

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