annotate bigwigCompare.xml @ 29:3a2aab18a217 draft

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