annotate multiIntersectBed.xml @ 26:c0fbce5dc84a draft

planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 19967671ddd4e750f53d71274e5c12325a402811
author iuc
date Mon, 17 Oct 2016 10:13:20 -0400
parents a2d4c30ba2f9
children b0d5e752c0c5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
17
a2d4c30ba2f9 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 0887009a23d176b21536c9fd8a18c4fecc417d4f
iuc
parents: 8
diff changeset
1 <tool id="bedtools_multiintersectbed" name="Multiple Intersect" version="@WRAPPER_VERSION@.0">
a2d4c30ba2f9 planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 0887009a23d176b21536c9fd8a18c4fecc417d4f
iuc
parents: 8
diff changeset
2 <description>identifies common intervals among multiple interval files</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 multiinter
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
11 $header
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
12 $cluster
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
13 -filler "${filler}"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
14 #if $zero.value == True:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
15 -empty
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
16 -g $genome
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
17 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
18
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
19 #if str($tag.tag_select) == "tag":
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
20 #set files = '" "'.join( [ str( $file ) for $file in $tag.inputs ] )
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
21 -i "${files}"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
22 #else:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
23 -i
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
24 #for $file in $tag.beds:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
25 "${file.input}"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
26 #end for
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
27 -names
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
28 #for $file in $tag.beds:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
29 "{$file.custom_name}"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
30 #end for
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
31 #end if
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
32
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
33 > '$output'
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
34 ]]>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
35 </command>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
36 <inputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
37 <conditional name="tag">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
38 <param name="tag_select" type="select" label="Sample name">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
39 <option value="tag" selected="true">Use input's tag</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
40 <option value="custom">Enter custom name per file</option>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
41 </param>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
42 <when value="tag">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
43 <param name="inputs" format="bed" type="data" multiple="True" label="BED files" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
44 </when>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
45 <when value="custom">
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
46 <repeat name="beds" title="Add BED files" min="2" >
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
47 <param name="input" format="bed" type="data" multiple="True" label="BED file" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
48 <param name="custom_name" type="text" area="false" label="Custom sample name"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
49 </repeat>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
50 </when>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
51 </conditional>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
52 <expand macro="genome" />
26
c0fbce5dc84a planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 19967671ddd4e750f53d71274e5c12325a402811
iuc
parents: 17
diff changeset
53 <param name="cluster" type="boolean" checked="false" truevalue="-cluster" falsevalue=""
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
54 label="Invoke Ryan Layers's clustering algorithm"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
55 help="(-cluster)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
56 <param name="zero" type="boolean" checked="true"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
57 label="Report regions that are not covered by any of the files"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
58 help="If set, regions that are not overlapped by any file will also be reported. Requires a valid organism key for all input datasets" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
59 <param name="filler" type="text" value="N/A"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
60 label="Text to use for no-coverage value"
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
61 help="Can be 0.0, N/A, - or any other value. (-filler)" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
62 <expand macro="print_header" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
63
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
64 </inputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
65 <outputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
66 <data format="bed" name="output" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
67 </outputs>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
68 <tests>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
69 <test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
70 <param name="tag_select" value="tag"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
71 <param name="inputs" value="multiIntersectBed1.bed,multiIntersectBed2.bed,multiIntersectBed3.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
72 <param name="zero" value="False"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
73 <output name="output" file="multiIntersectBed_result1.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
74 </test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
75 <test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
76 <param name="tag_select" value="tag"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
77 <param name="inputs" value="multiIntersectBed1.bed,multiIntersectBed2.bed,multiIntersectBed3.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
78 <param name="header" value="True"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
79 <param name="zero" value="False"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
80 <output name="output" file="multiIntersectBed_result2.bed" lines_diff="2" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
81 </test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
82 <test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
83 <param name="tag_select" value="tag"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
84 <param name="inputs" value="multiIntersectBed1.bed,multiIntersectBed2.bed,multiIntersectBed3.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
85 <param name="zero" value="True"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
86 <param name="genome" value="multiIntersectBed1.len"/>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
87 <output name="output" file="multiIntersectBed_result3.bed" ftype="bed" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
88 </test>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
89 </tests>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
90 <help>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
91 <![CDATA[
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
92 **What it does**
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
93
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
94 This tool identifies common intervals among multiple, sorted BED files. Intervals can be common among 0 to N of the N input BED files.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
95
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
96
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
97 .. class:: warningmark
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
98
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
99 This tool requires that each BED file is reference-sorted (chrom, then start).
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
100
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
101
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
102 .. class:: infomark
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
103
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
104 The output file will contain five fixed columns, plus additional columns for each BED file:
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
105
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
106 * 1. Chromosome name (or 'genome' for whole-genome coverage).
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
107 * 2. The zero-based start position of the interval.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
108 * 3. The one-based end position of the interval.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
109 * 4. The number of input files that had at least one feature overlapping this interval.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
110 * 5. A list of input files or labels that had at least one feature overlapping this interval.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
111 * 6. For each input file, an indication (1 = Yes, 0 = No) of whether or not the file had at least one feature overlapping this interval.
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
112
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
113 ------
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
114
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
115 **Example input**::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
116
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
117 # a.bed
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
118 chr1 6 12bed
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
119 chr1 10 20
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
120 chr1 22 27
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
121 chr1 24 30
26
c0fbce5dc84a planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 19967671ddd4e750f53d71274e5c12325a402811
iuc
parents: 17
diff changeset
122
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
123 # b.bed
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
124 chr1 12 32
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
125 chr1 14 30
26
c0fbce5dc84a planemo upload for repository https://github.com/galaxyproject/tools-iuc/tree/master/tools/bedtools commit 19967671ddd4e750f53d71274e5c12325a402811
iuc
parents: 17
diff changeset
126
8
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
127 # c.bed
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
128 chr1 8 15
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
129 chr1 10 14
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
130 chr1 32 34
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
131
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
132
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
133 ------
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
134
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
135 **Example without a header and without reporting intervals with zero coverage**::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
136
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
137
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
138 chr1 6 8 1 1 1 0 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
139 chr1 8 12 2 1,3 1 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
140 chr1 12 15 3 1,2,3 1 1 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
141 chr1 15 20 2 1,2 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
142 chr1 20 22 1 2 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
143 chr1 22 30 2 1,2 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
144 chr1 30 32 1 2 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
145 chr1 32 34 1 3 0 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
146
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
147
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
148 **Example adding a header line**::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
149
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
150
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
151 chrom start end num list a.bed b.bed c.bed
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
152 chr1 6 8 1 1 1 0 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
153 chr1 8 12 2 1,3 1 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
154 chr1 12 15 3 1,2,3 1 1 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
155 chr1 15 20 2 1,2 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
156 chr1 20 22 1 2 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
157 chr1 22 30 2 1,2 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
158 chr1 30 32 1 2 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
159 chr1 32 34 1 3 0 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
160
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
161
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
162 **Example adding a header line and custom file labels**::
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
163
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
164
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
165 chrom start end num list joe bob sue
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
166 chr1 6 8 1 joe 1 0 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
167 chr1 8 12 2 joe,sue 1 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
168 chr1 12 15 3 joe,bob,sue 1 1 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
169 chr1 15 20 2 joe,bob 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
170 chr1 20 22 1 bob 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
171 chr1 22 30 2 joe,bob 1 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
172 chr1 30 32 1 bob 0 1 0
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
173 chr1 32 34 1 sue 0 0 1
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
174
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
175
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
176 @REFERENCES@
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
177 ]]>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
178 </help>
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
179 <expand macro="citations" />
0d3aa592ce27 Uploaded
iuc
parents:
diff changeset
180 </tool>