annotate pileup_interval.xml @ 2:1e897622570e draft

planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
author devteam
date Tue, 13 Oct 2015 12:28:06 -0400
parents 36826b2b4096
children d78f28cae91b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2
1e897622570e planemo upload commit 33927a87ba2eee9bf0ecdd376a66241b17b3d734
devteam
parents: 1
diff changeset
1 <tool id="pileup_interval" name="Pileup-to-Interval" version="1.0.2">
0
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
2 <description>condenses pileup format into ranges of bases</description>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
3 <command interpreter="python">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
4 pileup_interval.py
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
5 --input=$input
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
6 --output=$output
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
7 --coverage=$coverage
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
8 --format=$format_type.format
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
9 #if $format_type.format == "ten":
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
10 --base=$format_type.which_base
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
11 --seq_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
12 --loc_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
13 --base_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
14 --cvrg_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
15 #elif $format_type.format == "manual":
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
16 --base="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
17 --seq_column=$format_type.seq_column
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
18 --loc_column=$format_type.loc_column
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
19 --base_column=$format_type.base_column
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
20 --cvrg_column=$format_type.cvrg_column
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
21 #else:
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
22 --base="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
23 --seq_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
24 --loc_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
25 --base_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
26 --cvrg_column="None"
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
27 #end if
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
28 </command>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
29 <inputs>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
30 <param name="input" type="data" format="tabular" label="Choose a pileup file to condense:" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
31 <conditional name="format_type">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
32 <param name="format" type="select" label="which contains:" help="See &quot;Types of pileup datasets&quot; below for examples">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
33 <option value="six" selected="true">Pileup with six columns (simple)</option>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
34 <option value="ten">Pileup with ten columns (with consensus)</option>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
35 <option value="manual">Set columns manually</option>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
36 </param>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
37 <when value="six" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
38 <when value="ten">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
39 <param name="which_base" type="select" label="Which base do you want to concatenate">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
40 <option value="first" selected="true">Reference base (first)</option>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
41 <option value="second">Consensus base (second)</option>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
42 </param>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
43 </when>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
44 <when value="manual">
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
45 <param name="seq_column" label="Select column with sequence name" type="data_column" numerical="false" data_ref="input" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
46 <param name="loc_column" label="Select column with base location" type="data_column" numerical="false" data_ref="input" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
47 <param name="base_column" label="Select column with base to concatenate" type="data_column" numerical="false" data_ref="input" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
48 <param name="cvrg_column" label="Select column with coverage" type="data_column" numerical="true" data_ref="input" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
49 </when>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
50 </conditional>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
51 <param name="coverage" type="integer" value="3" label="Do not report bases with coverage less than:" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
52 </inputs>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
53 <outputs>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
54 <data format="tabular" name="output" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
55 </outputs>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
56 <tests>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
57 <test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
58 <param name="input" value="pileup_interval_in1.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
59 <param name="format" value="six" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
60 <param name="coverage" value="3" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
61 <output name="output" file="pileup_interval_out1.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
62 </test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
63 <test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
64 <param name="input" value="pileup_interval_in2.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
65 <param name="format" value="ten" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
66 <param name="which_base" value="first" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
67 <param name="coverage" value="3" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
68 <output name="output" file="pileup_interval_out2.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
69 </test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
70 <test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
71 <param name="input" value="pileup_interval_in2.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
72 <param name="format" value="manual" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
73 <param name="seq_column" value="1" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
74 <param name="loc_column" value="2" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
75 <param name="base_column" value="3" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
76 <param name="cvrg_column" value="8" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
77 <param name="coverage" value="3" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
78 <output name="output" file="pileup_interval_out2.tabular" />
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
79 </test>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
80 </tests>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
81 <help>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
82
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
83 **What is does**
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
84
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
85 Reduces the size of a results set by taking a pileup file and producing a condensed version showing consecutive sequences of bases meeting coverage criteria. The tool works on six and ten column pileup formats produced with *samtools pileup* command. You also can specify columns for the input file manually. The tool assumes that the pileup dataset was produced by *samtools pileup* command (although you can override this by setting column assignments manually).
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
86
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
87 --------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
88
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
89 **Types of pileup datasets**
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
90
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
91 The description of pileup format below is largely based on information that can be found on SAMTools_ documentation page. The 6- and 10-column variants are described below.
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
92
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
93 .. _SAMTools: http://samtools.sourceforge.net/pileup.shtml
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
94
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
95 **Six column pileup**::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
96
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
97 1 2 3 4 5 6
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
98 ---------------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
99 chrM 412 A 2 ., II
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
100 chrM 413 G 4 ..t, IIIH
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
101 chrM 414 C 4 ...a III2
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
102 chrM 415 C 4 TTTt III7
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
103
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
104 where::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
105
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
106 Column Definition
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
107 ------ ----------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
108 1 Chromosome
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
109 2 Position (1-based)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
110 3 Reference base at that position
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
111 4 Coverage (# reads aligning over that position)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
112 5 Bases within reads where (see Galaxy wiki for more info)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
113 6 Quality values (phred33 scale, see Galaxy wiki for more)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
114
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
115 **Ten column pileup**
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
116
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
117 The `ten-column`__ pileup incorporates additional consensus information generated with *-c* option of *samtools pileup* command::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
118
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
119
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
120 1 2 3 4 5 6 7 8 9 10
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
121 ------------------------------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
122 chrM 412 A A 75 0 25 2 ., II
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
123 chrM 413 G G 72 0 25 4 ..t, IIIH
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
124 chrM 414 C C 75 0 25 4 ...a III2
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
125 chrM 415 C T 75 75 25 4 TTTt III7
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
126
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
127 where::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
128
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
129 Column Definition
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
130 ------- ----------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
131 1 Chromosome
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
132 2 Position (1-based)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
133 3 Reference base at that position
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
134 4 Consensus bases
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
135 5 Consensus quality
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
136 6 SNP quality
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
137 7 Maximum mapping quality
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
138 8 Coverage (# reads aligning over that position)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
139 9 Bases within reads where (see Galaxy wiki for more info)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
140 10 Quality values (phred33 scale, see Galaxy wiki for more)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
141
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
142
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
143 .. __: http://samtools.sourceforge.net/cns0.shtml
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
144
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
145 ------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
146
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
147 **The output format**
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
148
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
149 The output file condenses the information in the pileup file so that consecutive bases are listed together as sequences. The starting and ending points of the sequence range are listed, with the starting value converted to a 0-based value.
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
150
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
151 Given the following input with minimum coverage set to 3::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
152
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
153 1 2 3 4 5 6
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
154 ---------------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
155 chr1 112 G 3 ..Ta III6
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
156 chr1 113 T 2 aT.. III5
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
157 chr1 114 A 5 ,,.. IIH2
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
158 chr1 115 C 4 ,., III
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
159 chrM 412 A 2 ., II
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
160 chrM 413 G 4 ..t, IIIH
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
161 chrM 414 C 4 ...a III2
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
162 chrM 415 C 4 TTTt III7
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
163 chrM 490 T 3 a I
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
164
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
165 the following would be the output::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
166
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
167 1 2 3 4
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
168 -------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
169 chr1 111 112 G
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
170 chr1 113 115 AC
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
171 chrM 412 415 GCC
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
172 chrM 489 490 T
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
173
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
174 where::
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
175
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
176 Column Definition
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
177 ------- ----------------------------
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
178 1 Chromosome
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
179 2 Starting position (0-based)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
180 3 Ending position (1-based)
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
181 4 Sequence of bases
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
182
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
183 </help>
8afc93a5f9ae Uploaded tool tarball.
devteam
parents:
diff changeset
184 </tool>