annotate bigwigCompare.xml @ 27:bf1b1dcdd67b draft

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