annotate bigwigCompare.xml @ 1:21d563d5f2b2 draft

Uploaded
author bgruening
date Mon, 05 Aug 2013 10:09:51 -0400
parents 09b65c12a75a
children 1f312af2f8db
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
1 <tool id="bigwigCompare" name="bigwigCompare" version="1.0">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
2 <description>compares two bigwig files based on the number of mapped reads</description>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
3 <requirements>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
4 <requirement type="package" version="1.5.1_59e067cce039cb93add04823c9f51cab202f8c2b">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>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
7 </requirements>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
8 <command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
9 bigwigCompare
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
10
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
11 ##ToDo
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
12 --numberOfProcessors 4
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
13
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
14 --bigwig1 '$bigwigFile1'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
15 --bigwig2 '$bigwigFile2'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
16
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
17 --outFileName '$outFileName'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
18 --outFileFormat '$outFileFormat'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
19
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
20 --ratio $comparison_type
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
21
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
22 #if $advancedOpt.showAdvancedOpt == "yes":
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
23 #if str($advancedOpt.region.value) != '':
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
24 --region '$advancedOpt.region'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
25 #end if
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
26
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
27 --missingDataAsZero $advancedOpt.missingDataAsZero
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
28 --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
29 --pseudocount '$advancedOpt.pseudocount'
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
30 --binSize $advancedOpt.binSize
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
31
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
32 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
33
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
34 </command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
35 <inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36 <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
37 <param name="bigwigFile2" format="bigwig" type="data" label="Input bigwig file" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
38
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
39 <param name="comparison_type" type="select"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
40 label="How to compare the two files"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
41 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
42 <option value="log2" selected="true">log2 ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
43 <option value="ratio">simple ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
44 <option value="subtract">difference (subtract input from treatment)</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
45 <option value="add">sum</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
46 <option value="reciprocal_ratio">reciprocal ratio</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
47 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
48
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
49 <param name="outFileFormat" type="select" label="Coverage file format">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
50 <option value="bigwig" selected="true">bigwig</option>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
51 <option value="bedgraph">bedgraph</option>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
52 </param>
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
53
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
54 <conditional name="advancedOpt">
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
55 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
56 <option value="no" selected="true">no</option>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
57 <option value="yes">yes</option>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
58 </param>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
59 <when value="no" />
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
60 <when value="yes">
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
61 <param name="binSize" type="integer" value="50" min="1"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
62 label="Bin size in bp"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
63 help="Size of the bins in bp for the ouput of the bigwig/bedgraph file "/>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
64
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
65 <param name="region" type="text" value=""
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
66 label="Region of the genome to limit the operation to"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
67 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
68
1
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
69 <param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
70 label ="Treat missing data as zero"
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
71 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
72
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
73 <param name="scaleFactor1" type="float" value="1" label="Scale factor for treatment"/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
74 <param name="scaleFactor2" type="float" value="1" label="Scale factor for input"/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
75 <param name="pseudocount" type="float" value="1" label="Pseudocount" help="Small number to avoid dividing by zero."/>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
76 </when>
21d563d5f2b2 Uploaded
bgruening
parents: 0
diff changeset
77 </conditional>
0
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
78 </inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
79 <outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
80 <data format="bigwig" name="outFileName">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
81 <change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82 <when input="outFileFormat" value="bigwig" format="bigwig" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
83 <when input="outFileFormat" value="bedgraph" format="bedgraph" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84 </change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 </outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
88 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
90 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
91
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
92 This tool compares two bigwig files based on the number of mapped reads. To
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
93 compare the bigwig files the genome is partitioned into bins of equal size,
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
94 then the number of reads found in each BAM file are counted for such bins and
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
95 finally a summarizing value is reported. This vaule can be the ratio of the
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
96 number of readsper bin, the log2 of the ratio, the sum or the difference.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
97
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
98 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
99
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
100 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
101
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
102 Please acknowledge that this tool **is still in development** and we will be very happy to receive feedback from the users. If you run into any trouble please sent an email to `Fidel Ramirez`_.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
103
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
104 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
105
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
106
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
107 .. _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
108 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
109 .. _Fidel Ramirez: ramirez@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>