annotate bigwigCompare.xml @ 40:7f8dc9e3df05

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