annotate bigwigCompare.xml @ 0:b2886915ce68 draft default tip

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