annotate bigwigCompare.xml @ 33:fc3830717e24 draft

Uploaded
author bgruening
date Tue, 28 Jan 2014 16:30:41 -0500
parents e43b4015b4cc
children 934b9fccabd4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
33
fc3830717e24 Uploaded
bgruening
parents: 24
diff changeset
1 <tool id="deeptools_bigwigCompare" name="bigwigCompare" version="1.0.3">
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
2 <description>normalizes and compares two bigWig files to obtain the ratio, log2ratio or difference</description>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
3 <expand macro="requirements"/>
22
8710187d1eb5 Uploaded
bgruening
parents: 21
diff changeset
4 <expand macro="stdio" />
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
5 <macros>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
6 <import>deepTools_macros.xml</import>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
7 </macros>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
8 <command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
9 bigwigCompare
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
10
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
11 @THREADS@
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
12
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
13 --bigwig1 '$bigwigFile1'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
14 --bigwig2 '$bigwigFile2'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
15
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
16 --outFileName '$outFileName'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
17 --outFileFormat '$outFileFormat'
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
18
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
19 --ratio $comparison_type
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
20
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
21 #if $advancedOpt.showAdvancedOpt == "yes":
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
22 #if str($advancedOpt.region.value) != '':
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
23 --region '$advancedOpt.region'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
24 #end if
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
25
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
26 --missingDataAsZero $advancedOpt.missingDataAsZero
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
27 --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
28 --pseudocount '$advancedOpt.pseudocount'
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
29 --binSize $advancedOpt.binSize
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
30
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
31 #end if
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
32 </command>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
33 <inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
34 <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />
21
8436c195dd6c Uploaded
bgruening
parents: 15
diff changeset
35 <param name="bigwigFile2" format="bigwig" type="data" label="bigWig file" />
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
37 <param name="comparison_type" type="select"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
38 label="How to compare the two files"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
39 help="The reciprocal ratio returns the negative of the inverse of the ratio if the ratio is less than 0. The resulting values are interpreted as negative fold changes." >
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
40 <option value="log2" selected="true">log2 ratio</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
41 <option value="ratio">simple ratio</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
42 <option value="subtract">difference (subtract input from treatment)</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
43 <option value="add">sum</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
44 <option value="reciprocal_ratio">reciprocal ratio</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
45 </param>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
46
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
47 <param name="outFileFormat" type="select" label="Coverage file format">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
48 <option value="bigwig" selected="true">bigwig</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
49 <option value="bedgraph">bedgraph</option>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
50 </param>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
51
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
52 <conditional name="advancedOpt">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
53 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
54 <option value="no" selected="true">no</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
55 <option value="yes">yes</option>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
56 </param>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
57 <when value="no" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
58 <when value="yes">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
59 <param name="binSize" type="integer" value="50" min="1"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
60 label="Bin size in bp"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
61 help="Size of the bins in bp for the ouput of the bigwig/bedgraph file "/>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
62
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
63 <param name="region" type="text" value=""
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
64 label="Region of the genome to limit the operation to"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
65 help="This is useful when testing parameters to reduce the computing time. The format is chr:start:end, for example &quot;chr10&quot; or &quot;chr10:456700:891000&quot;" />
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
66
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
67 <param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
68 label ="Treat missing data as zero"
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
69 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." />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
70
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
71 <param name="scaleFactor1" type="float" value="1" label="Scale factor for treatment"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
72 <param name="scaleFactor2" type="float" value="1" label="Scale factor for input"/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
73 <param name="pseudocount" type="float" value="1" label="Pseudocount" help="Small number to avoid dividing by zero."/>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
74 </when>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
75 </conditional>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
76 </inputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
77 <outputs>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
78 <data format="bigwig" name="outFileName">
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
79 <change_format>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
80 <when input="outFileFormat" value="bigwig" format="bigwig" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
81 <when input="outFileFormat" value="bedgraph" format="bedgraph" />
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
82 </change_format>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
83 </data>
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
84 </outputs>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
88 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
90 This tool compares two bigwig files based on the number of mapped reads. To
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
91 compare the bigwig files the genome is partitioned into bins of equal size,
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
92 then the number of reads found in each BAM file are counted for such bins and
5
1f312af2f8db Uploaded
bgruening
parents: 1
diff changeset
93 finally a summarizing value is reported. This value can be the ratio of the
1f312af2f8db Uploaded
bgruening
parents: 1
diff changeset
94 number of reads per bin, the log2 of the ratio, the sum or the difference.
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
95
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
96 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
97
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
98 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
99
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
100 @REFERENCES@
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
101
10
a68a771625d2 Uploaded
bgruening
parents: 9
diff changeset
102 </help>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
103 </tool>