annotate bigwigCompare.xml @ 21:8436c195dd6c draft

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