annotate bigwigCompare.xml @ 9:73761f33f198 draft

Uploaded
author bgruening
date Tue, 17 Sep 2013 10:27:29 -0400
parents c5847db0cb41
children a68a771625d2
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">
5
1f312af2f8db Uploaded
bgruening
parents: 1
diff changeset
2 <description>normalizes and compares two bigWig files to obtain the ratio, log2ratio or difference</description>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
3 <requirements>
9
73761f33f198 Uploaded
bgruening
parents: 6
diff changeset
4 <requirement type="package" version="1.5.1_3e13687c89e951476776b15afb4bbbc3b906f761">deepTools</requirement>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
5 <requirement type="package" version="0.1">ucsc_tools</requirement>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
6 <requirement type="package" version="1.7.1">numpy</requirement>
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
7 <requirement type="package" >deepTools</requirement>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
8 </requirements>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
9 <command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
10 bigwigCompare
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
11
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
12 ##ToDo
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
13 --numberOfProcessors 4
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
14
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
15 --bigwig1 '$bigwigFile1'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
16 --bigwig2 '$bigwigFile2'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
17
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
18 --outFileName '$outFileName'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
19 --outFileFormat '$outFileFormat'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
20
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
21 --ratio $comparison_type
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
22
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
23 #if $advancedOpt.showAdvancedOpt == "yes":
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
24 #if str($advancedOpt.region.value) != '':
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
25 --region '$advancedOpt.region'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
26 #end if
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
27
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
28 --missingDataAsZero $advancedOpt.missingDataAsZero
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
29 --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
30 --pseudocount '$advancedOpt.pseudocount'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
31 --binSize $advancedOpt.binSize
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
32
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
33 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
34
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
35 </command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36 <inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
37 <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
38 <param name="bigwigFile2" format="bigwig" type="data" label="Input bigwig file" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
39
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
40 <param name="comparison_type" type="select"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
41 label="How to compare the two files"
09b65c12a75a Uploaded
bgruening
parents:
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." >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
43 <option value="log2" selected="true">log2 ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
44 <option value="ratio">simple ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
45 <option value="subtract">difference (subtract input from treatment)</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
46 <option value="add">sum</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
47 <option value="reciprocal_ratio">reciprocal ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
48 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
49
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
50 <param name="outFileFormat" type="select" label="Coverage file format">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
51 <option value="bigwig" selected="true">bigwig</option>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
52 <option value="bedgraph">bedgraph</option>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
53 </param>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
54
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
55 <conditional name="advancedOpt">
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
56 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
57 <option value="no" selected="true">no</option>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
58 <option value="yes">yes</option>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
59 </param>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
60 <when value="no" />
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
61 <when value="yes">
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
62 <param name="binSize" type="integer" value="50" min="1"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
63 label="Bin size in bp"
21d563d5f2b2 Uploaded
bgruening
parents: 0
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
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
66 <param name="region" type="text" value=""
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
67 label="Region of the genome to limit the operation to"
21d563d5f2b2 Uploaded
bgruening
parents: 0
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;" />
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
69
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
70 <param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
71 label ="Treat missing data as zero"
21d563d5f2b2 Uploaded
bgruening
parents: 0
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." />
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
73
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
74 <param name="scaleFactor1" type="float" value="1" label="Scale factor for treatment"/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
75 <param name="scaleFactor2" type="float" value="1" label="Scale factor for input"/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
76 <param name="pseudocount" type="float" value="1" label="Pseudocount" help="Small number to avoid dividing by zero."/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
77 </when>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
78 </conditional>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
79 </inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
80 <outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
81 <data format="bigwig" name="outFileName">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82 <change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
83 <when input="outFileFormat" value="bigwig" format="bigwig" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84 <when input="outFileFormat" value="bedgraph" format="bedgraph" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85 </change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87 </outputs>
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
6
c5847db0cb41 Uploaded
bgruening
parents: 5
diff changeset
103 If you would like to give us feedback or you run into any trouble, please send an email to deeptools@googlegroups.com
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
104
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
105 This tool is developed by the `Bioinformatics and Deep-Sequencing Unit`_ at the `Max Planck Institute for Immunobiology and Epigenetics`_.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
106
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
107
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
108 .. _Bioinformatics and Deep-Sequencing Unit: http://www3.ie-freiburg.mpg.de/facilities/research-facilities/bioinformatics-and-deep-sequencing-unit/
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
109 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
110
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
111 </help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
112
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
113 </tool>