annotate bigwigCompare.xml @ 0:09b65c12a75a draft

Uploaded
author bgruening
date Sat, 03 Aug 2013 13:42:12 -0400
parents
children 21d563d5f2b2
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>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
4 <requirement type="package" version="1.5.1_98e5d8a61431ea8605c0643d991a1a5d8999b4dc">deepTools</requirement>
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
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
10 --bigwig1 '$bigwigFile1'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
11 --bigwig2 '$bigwigFile2'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
12
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
13 --outFileName '$outFileName'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
14 --outFileFormat '$outFileFormat'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
15
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
16 --ratio $comparison_type
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
17
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
18 #if $advancedOpt.showAdvancedOpt == "yes":
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
19 #if str($advancedOpt.region.value) != '':
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
20 --region '$advancedOpt.region'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
21 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
22
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
23 --missingDataAsZero $advancedOpt.missingDataAsZero
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
24 --scaleFactors '$advancedOpt.scaleFactor1:$advancedOpt.scaleFactor2'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
25 --pseudocount '$advancedOpt.pseudocount'
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
26 --binSize $advancedOpt.binSize
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
27
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
28 #end if
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
29 --numberOfProcessors 4
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
30
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
31
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
32 </command>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
33
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
34 <inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
35 <param name="bigwigFile1" format="bigwig" type="data" label="Treatment bigwig file" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
36
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>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
51 <option value="bedgraph">bedgraph</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
52 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
53
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
54 <conditional name="advancedOpt">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
55 <param name="showAdvancedOpt" type="select" label="Show advanced options" >
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
56 <option value="no" selected="true">no</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
57 <option value="yes">yes</option>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
58 </param>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
59 <when value="no" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
60 <when value="yes">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
61
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
62 <param name="binSize" type="integer" value="50" min="1"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
63 label="Bin size in bp"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
64 help="Size of the bins in bp for the ouput of the bigwig/bedgraph file "/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
65
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
66 <param name="region" type="text" value=""
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
67 label="Region of the genome to limit the operation to"
09b65c12a75a Uploaded
bgruening
parents:
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;" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
69
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
70 <param name="missingDataAsZero" type="boolean" truevalue="yes" falsevalue="no" checked="True"
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
71 label ="Treat missing data as zero"
09b65c12a75a Uploaded
bgruening
parents:
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." />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
73
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
74 <param name="scaleFactor1" type="float" value="1" label="Scale factor for treatment"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
75 <param name="scaleFactor2" type="float" value="1" label="Scale factor for input"/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
76 <param name="pseudocount" type="float" value="1" label="Pseudocount" help="Small number to avoid dividing by zero."/>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
77
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
78 </when>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
79 </conditional>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
80
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
81 </inputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
82 <outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
83 <data format="bigwig" name="outFileName">
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
84 <change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
85 <when input="outFileFormat" value="bigwig" format="bigwig" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
86 <when input="outFileFormat" value="bedgraph" format="bedgraph" />
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
87 </change_format>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
88 </data>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
89 </outputs>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
90
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
91 <help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
92
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
93 **What it does**
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
94
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
95 This tool compares two bigwig files based on the number of mapped reads. To
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
96 compare the bigwig files the genome is partitioned into bins of equal size,
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
97 then the number of reads found in each BAM file are counted for such bins and
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
98 finally a summarizing value is reported. This vaule can be the ratio of the
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
99 number of readsper bin, the log2 of the ratio, the sum or the difference.
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
100
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
101 -----
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
102
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
103 .. class:: infomark
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
104
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
105 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
106
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
107 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
108
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
109
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
110 .. _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
111 .. _Max Planck Institute for Immunobiology and Epigenetics: http://www3.ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
112 .. _Fidel Ramirez: ramirez@ie-freiburg.mpg.de
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
113
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
114 </help>
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
115
09b65c12a75a Uploaded
bgruening
parents:
diff changeset
116 </tool>