annotate testing_cgatools-982e19c29ec0/cgatools/tools/cgatools_1.6/evidence2sam.xml @ 0:ef23f9cd599b draft default tip

Uploaded
author devteam
date Thu, 27 Sep 2012 13:37:59 -0400
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
1 <tool id="cg_evidence2sam" name="evidence2sam(beta) 1.6" version="1.0.0">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
2 <!--
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
3 This tool creates a GUI for the evidence2sam function of cgatools from Complete Genomics, Inc.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
4 written 8-31-2012 by bcrain@completegenomics.com
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
5 -->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
6
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
7 <description>converts evidence mappings to SAM format</description>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
8
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
9 <command>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
10 <!-- print version of cgatools to STDOUT-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
11 cgatools | head -1;
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
12
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
13 <!-- print command lines to STDOUT-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
14 echo "cgatools evidence2sam --beta
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
15 --reference $crr.fields.path
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
16 --output $output
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
17 --evidence-dnbs $data_sources.input
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
18 --consistent-mapping-range $range
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
19 #if $region.selectregion == "yes"
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
20 --extract-genomic-region $region.coordinates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
21 #end if
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
22 $duplicates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
23 $mates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
24 $intervals
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
25 $skip
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
26 $svcandidates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
27 $unmapped
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
28 $primary
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
29 ";
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
30
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
31 <!-- execute cgatools-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
32 cgatools evidence2sam --beta
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
33 --reference $crr.fields.path
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
34 --evidence-dnbs $data_sources.input
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
35 #if $region.selectregion == "yes"
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
36 --extract-genomic-region $region.coordinates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
37 #end if
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
38 $duplicates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
39 $mates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
40 $intervals
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
41 $skip
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
42 $svcandidates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
43 $unmapped
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
44 $primary
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
45 --consistent-mapping-range $range
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
46 --output $output
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
47 </command>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
48
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
49 <outputs>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
50 <data format="tabular" name="output" label="${tool.name} output"/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
51 </outputs>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
52
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
53 <inputs>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
54 <!--form field to select crr file-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
55 <param name="crr" type="select" label="Reference genome (.crr file)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
56 <options from_data_table="cg_crr_files" />
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
57 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
58
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
59 <!--conditional to select input file-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
60 <conditional name="data_sources">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
61 <param name="data_source" type="select" label="Where is the input evidence file?">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
62 <option value="in">imported into Galaxy</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
63 <option value="out" selected="true">located outside Galaxy (data on server or mounted drive)</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
64 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
65
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
66 <!--form field to select evidence files-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
67 <when value="in">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
68 <param name="input" type="data" format="tabluar" label="EvidenceDnbs file">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
69 <validator type="dataset_ok_validator" />
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
70 <validator type="dataset_metadata_in_file" filename="cg_crr_files.loc"
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
71 metadata_name="dbkey" metadata_column="1"
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
72 message="cgatools is not currently available for this build."/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
73 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
74 </when>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
75
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
76 <!--form field to enter external input file-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
77 <when value="out">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
78 <param name="input" type="text" label="EvidenceDnbs file (/path/file)" size="40" help="e.g. /harddrive/GS00000XXXX-DID/GS00000YYYY-ASM/GS00123-DNA_G01_2000/ASM/EVIDENCE/evidenceDnbs-chr21-GS00000YYYY-ASM.tsv.bz2">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
79 <validator type="empty_field" message="You must supply an evidenceDnbs file"/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
80 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
81 </when>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
82 </conditional>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
83
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
84 <!--form field to select chromosomal region-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
85 <conditional name="region">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
86 <param name="selectregion" type="select" label="Do you what to extract specific genomic region?">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
87 <option value="no" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
88 <option value="yes">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
89 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
90
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
91 <when value="yes">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
92 <param name="coordinates" type="text" label="Enter genomic coordinates to avoid converting the entire file (chr,from,to)" size="40" help="Specify the region as a half-open interval chr,from,to (e.g. chrX,15203639,15412498)"/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
93 </when>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
94 </conditional>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
95
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
96 <!--form field to select duplicate handling-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
97 <param name="duplicates" type="select" label="Keep local duplicates of DNB mappings (default no)" help="All the output SAM records will be marked as 'not primary' if this option is used.">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
98 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
99 <option value="--keep-duplicates">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
100 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
101
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
102 <!--form field to generate mate sequence-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
103 <param name="mates" type="select" label="Generate mate sequence (R2) and score (Q2) tags (default no)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
104 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
105 <option value="--add-mate-sequence">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
106 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
107
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
108 <!--form field to generate interval ids-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
109 <param name="intervals" type="select" label="Generate interval id (ZI:I) and allele id (ZA:I) tags (default no)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
110 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
111 <option value="--add-allele-id">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
112 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
113
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
114 <!--form field to skip not mapped reads-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
115 <param name="skip" type="select" label="Skip not mapped records (default no)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
116 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
117 <option value="--skip-not-mapped">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
118 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
119
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
120 <!--form field to skip not mapped reads-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
121 <param name="svcandidates" type="select" label="Mate unique single arm mappings in SAM including those on different stands and chromosomes (default no)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
122 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
123 <option value="--mate-sv-candidates">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
124 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
125
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
126 <!--form field to skip not mapped reads-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
127 <param name="unmapped" type="select" label="Generate mate sequence and score tags for inconsistent mappings only (default no)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
128 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
129 <option value="--add-unmapped-mate-info">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
130 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
131
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
132 <!--form field to skip not mapped reads-->
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
133 <param name="primary" type="select" label="Use primary mappings only (default no)" help="Report only the best mappings">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
134 <option value="" selected="true">no</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
135 <option value="--primary-mappings-only">yes</option>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
136 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
137
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
138 <param name="range" type="integer" value="1300" label="Maximum distance between consistent mates (default 1300)">
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
139 <validator type="empty_field" message="You must enter a value, the default is 1300" />
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
140 </param>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
141 </inputs>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
142
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
143 <stdio>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
144 <regex match="failed" source="stderr" level="fatal"/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
145 <regex match="error" source="stderr" level="fatal"/>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
146 <regex match="Export the sequence:" source="stderr" level="warning" description="Finished:" />
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
147 </stdio>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
148
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
149 <help>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
150
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
151 **What it does**
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
152
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
153 This tool uses cgatools evidence2sam to convert Complete Genomics evidence mappings to SAM format
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
154
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
155 **cgatools 1.6.0 Documentation**
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
156
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
157 Userguide: http://cgatools.sourceforge.net/docs/1.6.0/cgatools-user-guide.pdf
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
158
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
159 Release notes: http://cgatools.sourceforge.net/docs/1.6.0/cgatools-release-notes.pdf
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
160
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
161 **Command line reference**::
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
162
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
163 COMMAND NAME
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
164 evidence2sam - Converts CGI variant evidence data into SAM format.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
165
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
166 DESCRIPTION
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
167 The evidence2sam converter takes as input evidence mapping files
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
168 (evidenceDnbs-*) and generates one SAM file as an output. The output is
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
169 sent into stdout by default. By default, all the evidence mapping records
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
170 from the input are converted into a pair of corresponding SAM records - one
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
171 record for each HalfDNB. The negative gaps in CGI mappings are represented
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
172 using GS/GQ/GC tags.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
173
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
174 OPTIONS
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
175 -h [ --help ]
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
176 Print this help message.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
177
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
178 --beta
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
179 This is a beta command. To run this command, you must pass the --beta
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
180 flag.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
181
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
182 -e [ --evidence-dnbs ] arg
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
183 Input evidence dnbs file.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
184
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
185 -s [ --reference ] arg
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
186 Reference file.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
187
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
188 -o [ --output ] arg (=STDOUT)
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
189 The output SAM file (may be omitted for stdout).
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
190
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
191 -r [ --extract-genomic-region ] arg
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
192 defines a region as a half-open interval 'chr,from,to'.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
193
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
194 --keep-duplicates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
195 Keep local duplicates of DNB mappings.All the output SAM records will
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
196 be marked as not primary if this option is used.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
197
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
198 --add-allele-id
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
199 Generate interval id and allele id tags.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
200
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
201 --skip-not-mapped
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
202 Skip not mapped records
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
203
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
204 --add-mate-sequence
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
205 Generate mate sequence and score tags.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
206
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
207 --mate-sv-candidates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
208 Inconsistent mappings are normally converted as single arm mappings
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
209 with no mate information provided. If the option is used map2sam will
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
210 mate unique single arm mappings in SAM including those on different
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
211 stands and chromosomes. To distinguish these "artificially" mated
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
212 records a tag "XS:i:1" is used. The MAPQ provided for these records is
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
213 a single arm mapping weight.
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
214
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
215 --add-unmapped-mate-info
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
216 works like add-mate-sequence, but is applied to inconsistent mappings
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
217 only
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
218
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
219 --primary-mappings-only
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
220 report only the best mappings
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
221
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
222 --consistent-mapping-range arg (=1300)
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
223 limit the maximum distance between consistent mates
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
224
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
225
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
226 SUPPORTED FORMAT_VERSION
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
227 0.3 or later
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
228 </help>
ef23f9cd599b Uploaded
devteam
parents:
diff changeset
229 </tool>