annotate genomeCoverageBed.xml @ 20:3fe00810c5a2 draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 6692e3a4fa1bf6e9a407735afdbb2454ed32b316
author iuc
date Wed, 27 Jan 2016 15:14:44 -0500
parents a2d4c30ba2f9
children 2a576a9ef0cb
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
1 <tool id="bedtools_genomecoveragebed" name="Genome Coverage" version="@WRAPPER_VERSION@.0">
17
a2d4c30ba2f9 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 0887009a23d176b21536c9fd8a18c4fecc417d4f
iuc
parents: 8
diff changeset
2 <description>compute the coverage over an entire genome</description>
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
3 <macros>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
4 <import>macros.xml</import>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
5 </macros>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
6 <expand macro="requirements" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
7 <expand macro="stdio" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
8 <command>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
9 <![CDATA[
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
10 bedtools genomecov
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
11 #if $input.ext == "bam"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
12 -ibam '$input'
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
13 #else
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
14 -i '$input'
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
15 -g $genome
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
16 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
17
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
18 $split
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
19 $strand
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
20
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
21 #if str($report.report_select) == "bg":
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
22 #if $report.zero_regions:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
23 $report.zero_regions
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
24 #else:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
25 -bg
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
26 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
27
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
28 #if str($report.scale):
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
29 -scale $report.scale
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
30 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
31 #else:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
32 #if str($report.max):
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
33 -max $report.max
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
34 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
35 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
36 $d
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
37 $dz
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
38 $five
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
39 $three
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
40
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
41 > '$output'
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
42 ]]>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
43 </command>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
44 <inputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
45 <param format="bed,bam" name="input" type="data" label="The BAM or BED file from which coverage should be computed">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
46 <validator type="unspecified_build" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
47 </param>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
48 <conditional name="report">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
49 <param name="report_select" type="select" label="Output type">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
50 <option value="bg" selected="true">BedGraph coverage file</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
51 <option value="hist">Data suiteable for Histogram</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
52 </param>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
53 <when value="bg">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
54 <param name="zero_regions" type="boolean" checked="False" truevalue="-bga" falsevalue=""
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
55 label="Report regions with zero coverage" help="If set, regions without any coverage will also be reported. (-bga)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
56 <param name="scale" type="float" value="1.0"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
57 label="Scale the coverage by a constant factor"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
58 help="Each bedGraph coverage value is multiplied by this factor before being reported. Useful for normalizing coverage by, e.g., reads per million (RPM). (-scale)"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
59 </when>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
60 <when value="hist">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
61 <param name="max" type="integer" label="Specify max depth" value="0"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
62 help="Combine all positions with a depth >= max into a single bin in the histogram. (-max)"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
63 </when>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
64 </conditional>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
65 <expand macro="genome" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
66 <expand macro="split" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
67 <param name="strand" type="select" label="Calculate coverage based on" help="(-strand)">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
68 <option value="">both strands combined</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
69 <option value="-strand +">positive strand only</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
70 <option value="-strand -">negative strand only</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
71 </param>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
72
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
73 <param name="d" type="boolean" checked="False" truevalue="-d" falsevalue=""
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
74 label="Report the depth at each genome position with 1-based coordinates" help="(-d)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
75 <param name="dz" type="boolean" checked="False" truevalue="-dz" falsevalue=""
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
76 label="Report the depth at each genome position with 0-based coordinatess" help="(-dz)" />
20
3fe00810c5a2 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 6692e3a4fa1bf6e9a407735afdbb2454ed32b316
iuc
parents: 17
diff changeset
77 <param name="five" type="boolean" checked="False" truevalue="-5" falsevalue=""
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
78 label="Calculate coverage of 5’ positions" help="Instead of entire interval. (-5)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
79 <param name="three" type="boolean" checked="False" truevalue="-3" falsevalue=""
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
80 label="Calculate coverage of 3’ positions" help="Instead of entire interval. (-3)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
81 </inputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
82 <outputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
83 <data format="bedgraph" name="output">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
84 <change_format>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
85 <when input="report.report_select" value="hist" format="tabular" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
86 </change_format>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
87 </data>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
88 </outputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
89 <tests>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
90 <test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
91 <param name="input" value="genomeCoverageBed1.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
92 <param name="genome" value="genomeCoverageBed1.len" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
93 <param name="report_select" value="hist" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
94 <output name="output" file="genomeCoverageBed_result1.bed" ftype="tabular" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
95 </test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
96 </tests>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
97 <help>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
98 <![CDATA[
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
99 **What it does**
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
100
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
101 This tool calculates the genome-wide coverage of intervals defined in a BAM or BED file and reports them in BedGraph format.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
102
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
103 .. image:: $PATH_TO_IMAGES/genomecov-glyph.png
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
104
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
105 .. class:: warningmark
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
106
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
107 The input BED or BAM file must be sorted by chromosome name (but doesn't necessarily have to be sorted by start position).
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
108
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
109 -----
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
110
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
111 **Example 1**
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
112
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
113 Input (BED format)-
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
114 Overlapping, un-sorted intervals::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
115
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
116 chr1 140 176
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
117 chr1 100 130
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
118 chr1 120 147
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
119
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
120
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
121 Output (BedGraph format)-
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
122 Sorted, non-overlapping intervals, with coverage value on the 4th column::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
123
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
124 chr1 100 120 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
125 chr1 120 130 2
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
126 chr1 130 140 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
127 chr1 140 147 2
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
128 chr1 147 176 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
129
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
130 -----
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
131
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
132 **Example 2 - with ZERO-Regions selected (assuming hg19)**
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
133
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
134 Input (BED format)-
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
135 Overlapping, un-sorted intervals::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
136
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
137 chr1 140 176
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
138 chr1 100 130
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
139 chr1 120 147
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
140
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
141
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
142 BedGraph output will contain five columns:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
143
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
144 * 1. Chromosome name (or 'genome' for whole-genome coverage)
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
145 * 2. Coverage depth
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
146 * 3. The number of bases on chromosome (or genome) with depth equal to column 2.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
147 * 4. The size of chromosome (or entire genome) in base pairs
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
148 * 5. The fraction of bases on chromosome (or entire genome) with depth equal to column 2.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
149
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
150 **Example Output**:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
151
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
152 chr2L 0 1379895 23011544 0.0599653
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
153 chr2L 1 837250 23011544 0.0363839
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
154 chr2L 2 904442 23011544 0.0393038
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
155 chr2L 3 913723 23011544 0.0397072
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
156 chr2L 4 952166 23011544 0.0413778
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
157 chr2L 5 967763 23011544 0.0420555
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
158 chr2L 6 986331 23011544 0.0428624
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
159 chr2L 7 998244 23011544 0.0433801
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
160 chr2L 8 995791 23011544 0.0432735
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
161 chr2L 9 996398 23011544 0.0432999
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
162
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
163
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
164 @REFERENCES@
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
165 ]]>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
166 </help>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
167 <expand macro="citations" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
168 </tool>