|
21
|
1 <tool id="bismark_bowtie2" name="Bismark" version="0.10.2">
|
|
18
|
2 <!-- Wrapper compatible with Bismark version 0.10 -->
|
|
9
|
3 <description>bisulfite mapper (bowtie2)</description>
|
|
|
4 <!--<version_command>bismark version</version_command>-->
|
|
|
5 <requirements>
|
|
|
6 <requirement type="set_environment">SCRIPT_PATH</requirement>
|
|
18
|
7 <requirement type="package" version="0.1.19">samtools</requirement>
|
|
|
8 <requirement type="package" version="2.1.0">bowtie2</requirement>
|
|
9
|
9 </requirements>
|
|
21
|
10 <stdio>
|
|
|
11 <exit_code range="1:" />
|
|
|
12 <exit_code range=":-1" />
|
|
|
13 <regex match="Error:" />
|
|
|
14 <regex match="Exception:" />
|
|
|
15 </stdio>
|
|
9
|
16 <command interpreter="python">
|
|
21
|
17 <![CDATA[
|
|
9
|
18 bismark_wrapper.py
|
|
21
|
19
|
|
9
|
20 ## Change this to accommodate the number of threads you have available.
|
|
18
|
21 --num-threads "\${GALAXY_SLOTS:-24}"
|
|
9
|
22
|
|
20
|
23 --bismark_path \$SCRIPT_PATH
|
|
9
|
24
|
|
|
25 --bowtie2
|
|
|
26
|
|
|
27 ##
|
|
|
28 ## Bismark Genome Preparation, if desired.
|
|
|
29 ##
|
|
|
30
|
|
|
31 ## Handle reference file.
|
|
|
32 #if $refGenomeSource.genomeSource == "history":
|
|
|
33 --own-file=$refGenomeSource.ownFile
|
|
|
34 #else:
|
|
|
35 --indexes-path ${refGenomeSource.index.fields.path}
|
|
|
36 #end if
|
|
|
37
|
|
|
38
|
|
|
39 ##
|
|
|
40 ## Input parameters
|
|
|
41 ##
|
|
|
42
|
|
|
43 #if $singlePaired.sPaired == "single":
|
|
|
44 --single-paired $singlePaired.input_singles
|
|
|
45
|
|
|
46 #if $singlePaired.input_singles.ext == "fastqillumina":
|
|
|
47 --phred64-quals
|
|
|
48 --fastq
|
|
|
49 #elif $singlePaired.input_singles.ext == "fastqsanger":
|
|
|
50 --fastq
|
|
|
51 #elif $singlePaired.input_singles.ext == "fasta":
|
|
|
52 --fasta
|
|
|
53 #end if
|
|
|
54 #else:
|
|
18
|
55 --mate-paired
|
|
|
56 #set $mate1 = list()
|
|
|
57 #set $mate2 = list()
|
|
|
58 #for $mate_pair in $singlePaired.mate_list
|
|
|
59 $mate1.append( str($mate_pair.input_mate1) )
|
|
|
60 $mate2.append( str($mate_pair.input_mate2) )
|
|
|
61 #end for
|
|
9
|
62
|
|
18
|
63 --mate1 #echo ','.join($mate1)
|
|
|
64 --mate2 #echo ','.join($mate2)
|
|
|
65
|
|
21
|
66 #for $mate_pair in $singlePaired.mate_list:
|
|
|
67 #if $mate_pair.input_mate1.ext == "fastqillumina":
|
|
|
68 --phred64-quals
|
|
|
69 --fastq
|
|
|
70 #elif $mate_pair.input_mate1.ext == "fastqsanger":
|
|
|
71 --fastq
|
|
|
72 #elif $mate_pair.input_mate1.ext == "fasta":
|
|
|
73 --fasta
|
|
|
74 #end if
|
|
|
75 #break
|
|
|
76 #end for
|
|
9
|
77
|
|
|
78 -I $singlePaired.minInsert
|
|
|
79 -X $singlePaired.maxInsert
|
|
|
80 #end if
|
|
|
81
|
|
18
|
82 #if $sort_bam:
|
|
|
83 --sort-bam
|
|
|
84 #end if
|
|
9
|
85
|
|
|
86 ## for now hardcode the value for the required memory per thread in --best mode
|
|
|
87 --chunkmbs 512
|
|
|
88
|
|
|
89
|
|
|
90 #if $params.settingsType == "custom":
|
|
|
91
|
|
|
92 ## default 20
|
|
|
93 --seed-len $params.seed_len
|
|
|
94 ## default 0
|
|
|
95 --seed-mismatches $params.seed_mismatches
|
|
|
96 ## default 15
|
|
|
97 --seed-extention-attempts $params.seed_extention_attempts
|
|
|
98 ## default 2
|
|
|
99 --max-reseed $params.max_reseed
|
|
21
|
100
|
|
9
|
101 ## default 70
|
|
|
102 ##--maqerr $params.maqerr
|
|
|
103
|
|
|
104 ## default unlimited
|
|
|
105 #if $params.qupto != 0:
|
|
|
106 --qupto $params.qupto
|
|
|
107 #end if
|
|
|
108 #if $params.skip_reads != 0:
|
|
|
109 --skip-reads $params.skip_reads
|
|
|
110 #end if
|
|
|
111
|
|
|
112 ## if set, disable the original behaviour
|
|
|
113 $params.no_mixed
|
|
|
114 ## if set, disable the original behaviour
|
|
|
115 $params.no_discordant
|
|
|
116
|
|
18
|
117 #if $params.bismark_stdout:
|
|
|
118 --stdout $output_stdout
|
|
|
119 #end if
|
|
9
|
120
|
|
18
|
121 #if $params.isReportOutput:
|
|
|
122 --output-report-file $report_file
|
|
|
123 #end if
|
|
9
|
124
|
|
|
125 #end if
|
|
|
126
|
|
|
127 ##
|
|
|
128 ## Output parameters.
|
|
|
129 ##
|
|
|
130 --output $output
|
|
18
|
131 ##$suppress_header
|
|
9
|
132
|
|
|
133 #if str( $singlePaired.sPaired ) == "single"
|
|
|
134 #if $output_unmapped_reads_l
|
|
|
135 --output-unmapped-reads $output_unmapped_reads_l
|
|
|
136 #end if
|
|
|
137 #if $output_suppressed_reads_l
|
|
|
138 --output-suppressed-reads $output_suppressed_reads_l
|
|
|
139 #end if
|
|
|
140 #else
|
|
|
141 #if $output_unmapped_reads_l and $output_unmapped_reads_r
|
|
|
142 --output-unmapped-reads-l $output_unmapped_reads_l
|
|
|
143 --output-unmapped-reads-r $output_unmapped_reads_r
|
|
|
144 #end if
|
|
|
145 #if $output_suppressed_reads_l and $output_suppressed_reads_l
|
|
|
146 --output-suppressed-reads-l $output_suppressed_reads_l
|
|
|
147 --output-suppressed-reads-r $output_suppressed_reads_r
|
|
|
148 #end if
|
|
|
149 #end if
|
|
|
150
|
|
21
|
151 ]]>
|
|
9
|
152 </command>
|
|
|
153 <inputs>
|
|
|
154 <conditional name="refGenomeSource">
|
|
|
155 <param name="genomeSource" type="select" label="Will you select a reference genome from your history or use a built-in index?" help="Built-ins were indexed using default options">
|
|
|
156 <option value="indexed">Use a built-in index</option>
|
|
|
157 <option value="history">Use one from the history</option>
|
|
|
158 </param>
|
|
|
159 <when value="indexed">
|
|
|
160 <param name="index" type="select" label="Select a reference genome" help="If your genome of interest is not listed, contact your Galaxy admin">
|
|
|
161 <options from_data_table="bowtie2_indexes">
|
|
|
162 <filter type="sort_by" column="2"/>
|
|
|
163 <validator type="no_options" message="No indexes are available for the selected input dataset"/>
|
|
|
164 </options>
|
|
|
165 </param>
|
|
|
166 </when> <!-- build-in -->
|
|
|
167 <when value="history">
|
|
|
168 <param name="ownFile" type="data" format="fasta" metadata_name="dbkey" label="Select the reference genome" />
|
|
|
169 </when> <!-- history -->
|
|
|
170 </conditional> <!-- refGenomeSource -->
|
|
|
171
|
|
|
172 <!-- Input Parameters -->
|
|
|
173 <conditional name="singlePaired">
|
|
|
174 <param name="sPaired" type="select" label="Is this library mate-paired?">
|
|
|
175 <option value="single">Single-end</option>
|
|
|
176 <option value="paired">Paired-end</option>
|
|
|
177 </param>
|
|
|
178 <when value="single">
|
|
|
179 <param name="input_singles" type="data" format="fastqsanger,fastqillumina,fastq,fasta" label="FASTQ/FASTA file" help="FASTQ or FASTA files." />
|
|
|
180 </when>
|
|
|
181 <when value="paired">
|
|
18
|
182 <repeat name="mate_list" title="Paired End Pairs" min="1">
|
|
|
183 <param name="input_mate1" type="data" format="fastqsanger,fastqillumina,fastq,fasta" label="Mate pair 1" help="FASTQ or FASTA files." />
|
|
|
184 <param name="input_mate2" type="data" format="fastqsanger,fastqillumina,fastq,fasta" label="Mate pair 2" help="FASTQ or FASTA files." />
|
|
|
185 </repeat>
|
|
9
|
186 <param name="minInsert" type="integer" value="0" label="Minimum insert size for valid paired-end alignments" />
|
|
18
|
187 <param name="maxInsert" type="integer" value="500" label="Maximum insert size for valid paired-end alignments" />
|
|
9
|
188 </when>
|
|
|
189 </conditional>
|
|
|
190
|
|
18
|
191 <param name="sort_bam" type="boolean" truevalue="true" falsevalue="false" checked="False" label="Sort BAM file by chromosomal position (not compatibile with methylation extractor)"/>
|
|
9
|
192
|
|
|
193 <conditional name="params">
|
|
|
194 <param name="settingsType" type="select" label="Bismark settings to use" help="You can use the default settings or set custom values for any of Bismark's parameters.">
|
|
|
195 <option value="default">Use Defaults</option>
|
|
|
196 <option value="custom">Full parameter list</option>
|
|
|
197 </param>
|
|
|
198 <when value="default" />
|
|
|
199 <!-- Full/advanced params. -->
|
|
|
200 <when value="custom">
|
|
|
201 <!-- -N -->
|
|
|
202 <param name="seed_mismatches" type="integer" value="0" label="Number of mismatches to be allowed in a seed alignment during multiseed alignment" />
|
|
|
203 <!-- -L -->
|
|
|
204 <param name="seed_len" type="integer" value="20" label="Length of the seed substrings to align during multiseed alignment" />
|
|
|
205 <!--
|
|
|
206 <param name="maqerr" type="integer" value="70" label="Maximum permitted total of quality values at all mismatched read positions throughout the entire alignment, not just in the 'seed'." />
|
|
|
207 -->
|
|
|
208 <!-- -D -->
|
|
|
209 <param name="seed_extention_attempts" type="integer" value="15" label="How many consecutive seed extension attempts can fail before Bowtie 2 moves on" />
|
|
|
210 <!-- -R -->
|
|
|
211 <param name="max_reseed" type="integer" value="2" label="Maximum number of times Bowtie 2 will re-seed reads with repetitive seeds" />
|
|
|
212
|
|
|
213 <param name="qupto" type="integer" value="0" label="Only aligns the first N reads or read pairs from the input" help="Default is 0 and means 'no-limit'." />
|
|
|
214 <param name="skip_reads" type="integer" value="0" label="Skip (i.e. do not align) the first N reads or read pairs from the input" />
|
|
|
215
|
|
18
|
216 <param name="no_discordant" type="boolean" truevalue="--no-discordant" falsevalue="" checked="false" label="Disable looking for discordant alignments if it cannot find any concordant alignments" help="" />
|
|
|
217 <param name="no_mixed" type="boolean" truevalue="--no-mixed" falsevalue="" checked="false" label="Disable Bowtie 2's behaviour to try to find alignments for the individual mates" help="" />
|
|
9
|
218
|
|
18
|
219 <param name="suppressed_read_file" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Write ambiguous reads to an extra output file" help="Write all reads which produce more than one valid alignment with the same number of lowest mismatches or other reads that fail to align uniquely." />
|
|
|
220 <param name="unmapped_read_file" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Write all reads that could not be aligned to a file" />
|
|
9
|
221 <!-- output Options -->
|
|
18
|
222 <param name="bismark_stdout" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Write the bismark output and summary information to an extra file" />
|
|
|
223 <param name="isReportOutput" type="boolean" truevalue="true" falsevalue="false" checked="false" label="Offer all report files concatenated in one file" />
|
|
|
224
|
|
21
|
225 <!--end output options -->
|
|
9
|
226 </when> <!-- full -->
|
|
|
227 </conditional> <!-- params -->
|
|
18
|
228 <!--
|
|
|
229 <param name="suppress_header" type="boolean" truevalue="..suppress-header" falsevalue="" checked="false" label="Suppress the header in the output SAM file" help="Bowtie produces SAM with several lines of header information by default." />
|
|
|
230 -->
|
|
9
|
231 </inputs>
|
|
18
|
232
|
|
|
233
|
|
9
|
234 <outputs>
|
|
|
235 <data format="txt" name="report_file" label="${tool.name} on ${on_string}: Report">
|
|
18
|
236 <filter>
|
|
|
237 ((
|
|
|
238 params['settingsType'] == "custom" and
|
|
|
239 params['isReportOutput'] is True
|
|
|
240 ))
|
|
|
241 </filter>
|
|
9
|
242 </data>
|
|
18
|
243 <data format="txt" name="output_stdout" label="${tool.name} on ${on_string}: Summary">
|
|
|
244 <filter>
|
|
|
245 ((
|
|
|
246 params['settingsType'] == "custom" and
|
|
|
247 params['bismark_stdout'] is True
|
|
|
248 ))
|
|
|
249 </filter>
|
|
|
250 </data>
|
|
|
251
|
|
|
252 <data format="bam" name="output" label="${tool.name} on ${on_string}: mapped reads">
|
|
9
|
253 <actions>
|
|
|
254 <conditional name="refGenomeSource.genomeSource">
|
|
|
255 <when value="indexed">
|
|
|
256 <action type="metadata" name="dbkey">
|
|
|
257 <option type="from_data_table" name="bowtie2_indexes" column="1" offset="0">
|
|
|
258 <filter type="param_value" column="0" value="#" compare="startswith" keep="False"/>
|
|
|
259 <filter type="param_value" ref="refGenomeSource.index" column="0"/>
|
|
|
260 </option>
|
|
|
261 </action>
|
|
|
262 </when>
|
|
|
263 <when value="history">
|
|
|
264 <action type="metadata" name="dbkey">
|
|
|
265 <option type="from_param" name="refGenomeSource.ownFile" param_attribute="dbkey" />
|
|
|
266 </action>
|
|
|
267 </when>
|
|
|
268 </conditional>
|
|
|
269 </actions>
|
|
|
270 </data>
|
|
|
271
|
|
|
272 <data format="fastq" name="output_suppressed_reads_l" label="${tool.name} on ${on_string}: suppressed reads (L)">
|
|
|
273 <filter>
|
|
|
274 ((
|
|
|
275 params['settingsType'] == "custom" and
|
|
|
276 params['suppressed_read_file'] is True
|
|
|
277 ))
|
|
|
278 </filter>
|
|
|
279 <actions>
|
|
|
280 <conditional name="singlePaired.sPaired">
|
|
|
281 <when value="single">
|
|
|
282 <action type="format">
|
|
|
283 <option type="from_param" name="singlePaired.input_singles" param_attribute="ext" />
|
|
|
284 </action>
|
|
|
285 </when>
|
|
|
286 <when value="paired">
|
|
21
|
287 <!--action type="format">
|
|
18
|
288 <option type="from_param" name="singlePaired.mate_list[0].input_mate1" param_attribute="ext" />
|
|
21
|
289 </action-->
|
|
9
|
290 </when>
|
|
|
291 </conditional>
|
|
|
292 </actions>
|
|
|
293 </data>
|
|
|
294
|
|
|
295 <data format="fastq" name="output_suppressed_reads_r" label="${tool.name} on ${on_string}: suppressed reads (R)">
|
|
21
|
296 <filter>
|
|
|
297 ((
|
|
|
298 singlePaired['sPaired'] == "paired" and
|
|
|
299 params['settingsType'] == "custom" and
|
|
|
300 params['suppressed_read_file'] is True
|
|
|
301 ))
|
|
|
302 </filter>
|
|
9
|
303 <actions>
|
|
|
304 <conditional name="singlePaired.sPaired">
|
|
|
305 <when value="single">
|
|
|
306 <action type="format">
|
|
|
307 <option type="from_param" name="singlePaired.input_singles" param_attribute="ext" />
|
|
|
308 </action>
|
|
|
309 </when>
|
|
|
310 <when value="paired">
|
|
21
|
311 <!--action type="format">
|
|
18
|
312 <option type="from_param" name="singlePaired.mate_list[0].input_mate1" param_attribute="ext" />
|
|
21
|
313 </action-->
|
|
9
|
314 </when>
|
|
|
315 </conditional>
|
|
|
316 </actions>
|
|
|
317 </data>
|
|
|
318
|
|
|
319 <!-- Outout unmapped reads -->
|
|
|
320 <data format="fastq" name="output_unmapped_reads_l" label="${tool.name} on ${on_string}: unmapped reads (L)">
|
|
|
321 <filter>
|
|
|
322 ((
|
|
|
323 params['settingsType'] == "custom" and
|
|
|
324 params['unmapped_read_file'] is True
|
|
|
325 ))
|
|
|
326 </filter>
|
|
|
327 <actions>
|
|
|
328 <conditional name="singlePaired.sPaired">
|
|
|
329 <when value="single">
|
|
|
330 <action type="format">
|
|
|
331 <option type="from_param" name="singlePaired.input_singles" param_attribute="ext" />
|
|
|
332 </action>
|
|
|
333 </when>
|
|
|
334 <when value="paired">
|
|
21
|
335 <!--action type="format">
|
|
18
|
336 <option type="from_param" name="singlePaired.mate_list[0].input_mate1" param_attribute="ext" />
|
|
21
|
337 </action-->
|
|
9
|
338 </when>
|
|
|
339 </conditional>
|
|
|
340 </actions>
|
|
|
341 </data>
|
|
18
|
342
|
|
9
|
343 <data format="fastq" name="output_unmapped_reads_r" label="${tool.name} on ${on_string}: unmapped reads (R)">
|
|
21
|
344 <filter>
|
|
|
345 ((
|
|
|
346 singlePaired['sPaired'] == "paired" and
|
|
|
347 params['settingsType'] == "custom" and
|
|
|
348 params['unmapped_read_file'] is True
|
|
|
349 ))
|
|
|
350 </filter>
|
|
9
|
351 <actions>
|
|
|
352 <conditional name="singlePaired.sPaired">
|
|
|
353 <when value="single">
|
|
|
354 <action type="format">
|
|
|
355 <option type="from_param" name="singlePaired.input_singles" param_attribute="ext" />
|
|
|
356 </action>
|
|
|
357 </when>
|
|
|
358 <when value="paired">
|
|
21
|
359 <!--action type="format">
|
|
18
|
360 <option type="from_param" name="singlePaired.mate_list[0].input_mate1" param_attribute="ext" />
|
|
21
|
361 </action-->
|
|
9
|
362 </when>
|
|
|
363 </conditional>
|
|
|
364 </actions>
|
|
|
365 </data>
|
|
|
366 </outputs>
|
|
|
367
|
|
|
368 <tests>
|
|
|
369 </tests>
|
|
|
370
|
|
|
371 <help>
|
|
21
|
372 <![CDATA[
|
|
9
|
373
|
|
|
374 **What it does**
|
|
|
375
|
|
|
376 Bismark_ is a bisulfite mapper and methylation caller. Bismark takes in FastA or FastQ files and aligns the
|
|
|
377 reads to a specified bisulfite genome. Sequence reads are transformed into a bisulfite converted forward strand
|
|
|
378 version (C->T conversion) or into a bisulfite treated reverse strand (G->A conversion of the forward strand).
|
|
|
379 Each of these reads are then aligned to bisulfite treated forward strand index of a reference genome
|
|
|
380 (C->T converted) and a bisulfite treated reverse strand index of the genome (G->A conversion of the
|
|
18
|
381 forward strand, by doing this alignments will produce the same positions). These instances of Bowtie 2
|
|
9
|
382 are run in parallel. The sequence file(s) are then read in again sequence by sequence to pull out the original
|
|
|
383 sequence from the genome and determine if there were any protected C's present or not.
|
|
|
384
|
|
|
385 .. _Bismark: http://www.bioinformatics.babraham.ac.uk/projects/bismark/
|
|
|
386
|
|
|
387 As of version 0.7.0 Bismark will only run 2 alignment threads for OT and OB in parallel, the 4 strand mode can be
|
|
|
388 re-enabled by using non_directional mode.
|
|
|
389
|
|
|
390 It is developed by Krueger F and Andrews SR. at the Babraham Institute. Krueger F, Andrews SR. (2011) Bismark: a flexible aligner and methylation caller for Bisulfite-Seq applications. Bioinformatics, 27, 1571-2.
|
|
|
391
|
|
|
392 ------
|
|
|
393
|
|
|
394 **Know what you are doing**
|
|
|
395
|
|
|
396 .. class:: warningmark
|
|
|
397
|
|
|
398 There is no such thing (yet) as an automated gearshift in short read mapping. It is all like stick-shift driving in San Francisco. In other words = running this tool with default parameters will probably not give you meaningful results. A way to deal with this is to **understand** the parameters by carefully reading the `documentation`__ and experimenting. Fortunately, Galaxy makes experimenting easy.
|
|
|
399
|
|
|
400 .. __: http://www.bioinformatics.babraham.ac.uk/projects/bismark/
|
|
|
401
|
|
18
|
402
|
|
|
403 .. class:: warningmark
|
|
|
404
|
|
|
405 Make sure all your input reads are in the correct and same format. If thats not the case please adjust/convert the filetype with galaxy's build-in converters.
|
|
|
406
|
|
9
|
407 ------
|
|
|
408
|
|
|
409 **Input formats**
|
|
|
410
|
|
|
411 Bismark accepts files in either Sanger FASTQ format (galaxy type *fastqsanger*), Illumina FASTQ format (galaxy type *fastqillumina*) or FASTA format (galaxy type *fasta*). Use the FASTQ Groomer to prepare your files.
|
|
|
412
|
|
|
413 ------
|
|
|
414
|
|
|
415 **A Note on Built-in Reference Genomes**
|
|
|
416
|
|
|
417 The default variant for all genomes is "Full", defined as all primary chromosomes (or scaffolds/contigs) including mitochondrial plus associated unmapped, plasmid, and other segments. When only one version of a genome is available in this tool, it represents the default "Full" variant. Some genomes will have more than one variant available. The "Canonical Male" or sometimes simply "Canonical" variant contains the primary chromosomes for a genome. For example a human "Canonical" variant contains chr1-chr22, chrX, chrY, and chrM. The "Canonical Female" variant contains the primary chromosomes excluding chrY.
|
|
|
418
|
|
|
419 ------
|
|
|
420
|
|
|
421 The final output of Bismark is in SAM format by default.
|
|
|
422
|
|
|
423 **Outputs**
|
|
|
424
|
|
|
425 The output is in SAM format, and has the following columns::
|
|
|
426
|
|
|
427 Column Description
|
|
|
428 -------- --------------------------------------------------------
|
|
|
429 1 QNAME seq-ID
|
|
21
|
430 2 FLAG this flag tries to take the strand a bisulfite read
|
|
|
431 originated from into account
|
|
9
|
432 (this is different from ordinary DNA alignment flags!)
|
|
|
433 3 RNAME chromosome
|
|
|
434 4 POS start position
|
|
|
435 5 MAPQ always 255
|
|
|
436 6 CIGAR extended CIGAR string
|
|
|
437 7 MRNM Mate Reference sequence NaMe ('=' if same as RNAME)
|
|
|
438 8 MPOS 1-based Mate POSition
|
|
|
439 9 ISIZE Inferred insert SIZE
|
|
|
440 10 SEQ query SEQuence on the same strand as the reference
|
|
|
441 11 QUAL Phred33 scale
|
|
|
442 12 NM-tag edit distance to the reference)
|
|
21
|
443 13 XX-tag base-by-base mismatches to the reference.
|
|
9
|
444 This does not include indels.
|
|
|
445 14 XM-tag methylation call string
|
|
|
446 15 XR-tag read conversion state for the alignment
|
|
|
447 16 XG-tag genome conversion state for the alignment
|
|
21
|
448
|
|
9
|
449
|
|
|
450 Each read of paired-end alignments is written out in a separate line in the above format.
|
|
|
451
|
|
|
452
|
|
|
453 It looks like this (scroll sideways to see the entire example)::
|
|
|
454
|
|
|
455 QNAME FLAG RNAME POS MAPQ CIAGR MRNM MPOS ISIZE SEQ QUAL OPT
|
|
|
456 HWI-EAS91_1_30788AAXX:1:1:1761:343 4 * 0 0 * * 0 0 AAAAAAANNAAAAAAAAAAAAAAAAAAAAAAAAAAACNNANNGAGTNGNNNNNNNGCTTCCCACAGNNCTGG hhhhhhh;;hhhhhhhhhhh^hOhhhhghhhfhhhgh;;h;;hhhh;h;;;;;;;hhhhhhghhhh;;Phhh
|
|
|
457 HWI-EAS91_1_30788AAXX:1:1:1578:331 4 * 0 0 * * 0 0 GTATAGANNAATAAGAAAAAAAAAAATGAAGACTTTCNNANNTCTGNANNNNNNNTCTTTTTTCAGNNGTAG hhhhhhh;;hhhhhhhhhhhhhhhhhhhhhhhhhhhh;;h;;hhhh;h;;;;;;;hhhhhhhhhhh;;hhVh
|
|
|
458
|
|
|
459 -------
|
|
|
460
|
|
|
461 **Bismark settings**
|
|
|
462
|
|
|
463 All of the options have a default value. You can change any of them. If any Bismark function is missing please contact the tool author or your Galaxy admin.
|
|
|
464
|
|
|
465 ------
|
|
|
466
|
|
|
467 **Bismark parameter list**
|
|
|
468
|
|
18
|
469 This is an exhaustive list of Bismark options.
|
|
9
|
470
|
|
|
471 Input::
|
|
|
472
|
|
|
473 --singles A comma- or space-separated list of files containing the reads to be aligned (e.g.
|
|
|
474 lane1.fq,lane2.fq lane3.fq). Reads may be a mix of different lengths. Bismark will
|
|
|
475 produce one mapping result and one report file per input file.
|
|
|
476
|
|
|
477 -1 mates1 Comma-separated list of files containing the #1 mates (filename usually includes
|
|
|
478 "_1"), e.g. flyA_1.fq,flyB_1.fq). Sequences specified with this option must
|
|
|
479 correspond file-for-file and read-for-read with those specified in mates2.
|
|
|
480 Reads may be a mix of different lengths. Bismark will produce one mapping result
|
|
|
481 and one report file per paired-end input file pair.
|
|
|
482
|
|
|
483 -2 mates2 Comma-separated list of files containing the #2 mates (filename usually includes
|
|
|
484 "_2"), e.g. flyA_1.fq,flyB_1.fq). Sequences specified with this option must
|
|
|
485 correspond file-for-file and read-for-read with those specified in mates1.
|
|
|
486 Reads may be a mix of different lengths.
|
|
|
487
|
|
|
488 -q/--fastq The query input files (specified as mate1,mate2 or singles are FASTQ
|
|
|
489 files (usually having extension .fg or .fastq). This is the default. See also
|
|
|
490 --solexa-quals.
|
|
|
491
|
|
|
492 -f/--fasta The query input files (specified as mate1,mate2 or singles are FASTA
|
|
|
493 files (usually havin extension .fa, .mfa, .fna or similar). All quality values
|
|
|
494 are assumed to be 40 on the Phred scale.
|
|
|
495
|
|
|
496 -s/--skip INT Skip (i.e. do not align) the first INT reads or read pairs from the input.
|
|
|
497
|
|
|
498 -u/--upto INT Only aligns the first INT reads or read pairs from the input. Default: no limit.
|
|
|
499
|
|
|
500 --phred33-quals FASTQ qualities are ASCII chars equal to the Phred quality plus 33. Default: on.
|
|
|
501
|
|
|
502 --phred64-quals FASTQ qualities are ASCII chars equal to the Phred quality plus 64. Default: off.
|
|
|
503
|
|
|
504 --solexa-quals Convert FASTQ qualities from solexa-scaled (which can be negative) to phred-scaled
|
|
21
|
505 (which can't). The formula for conversion is:
|
|
9
|
506 phred-qual = 10 * log(1 + 10 ** (solexa-qual/10.0)) / log(10). Used with -q. This
|
|
|
507 is usually the right option for use with (unconverted) reads emitted by the GA
|
|
|
508 Pipeline versions prior to 1.3. Works only for Bowtie 1. Default: off.
|
|
|
509
|
|
|
510 --solexa1.3-quals Same as --phred64-quals. This is usually the right option for use with (unconverted)
|
|
|
511 reads emitted by GA Pipeline version 1.3 or later. Default: off.
|
|
|
512
|
|
|
513
|
|
|
514 Alignment::
|
|
|
515
|
|
|
516 -n/--seedmms INT The maximum number of mismatches permitted in the "seed", i.e. the first L base pairs
|
|
21
|
517 of the read (where L is set with -l/--seedlen). This may be 0, 1, 2 or 3 and the
|
|
9
|
518 default is 1. This option is only available for Bowtie 1 (for Bowtie 2 see -N).
|
|
|
519
|
|
|
520 -l/--seedlen The "seed length"; i.e., the number of bases of the high quality end of the read to
|
|
|
521 which the -n ceiling applies. The default is 28. Bowtie (and thus Bismark) is faster for
|
|
|
522 larger values of -l. This option is only available for Bowtie 1 (for Bowtie 2 see -L).
|
|
|
523
|
|
|
524 -e/--maqerr INT Maximum permitted total of quality values at all mismatched read positions throughout
|
|
|
525 the entire alignment, not just in the "seed". The default is 70. Like Maq, bowtie rounds
|
|
|
526 quality values to the nearest 10 and saturates at 30. This value is not relevant for
|
|
|
527 Bowtie 2.
|
|
|
528
|
|
|
529 --chunkmbs INT The number of megabytes of memory a given thread is given to store path descriptors in
|
|
|
530 --best mode. Best-first search must keep track of many paths at once to ensure it is
|
|
|
531 always extending the path with the lowest cumulative cost. Bowtie tries to minimize the
|
|
|
532 memory impact of the descriptors, but they can still grow very large in some cases. If
|
|
|
533 you receive an error message saying that chunk memory has been exhausted in --best mode,
|
|
|
534 try adjusting this parameter up to dedicate more memory to the descriptors. This value
|
|
|
535 is not relevant for Bowtie 2. Default: 512.
|
|
|
536
|
|
|
537 -I/--minins INT The minimum insert size for valid paired-end alignments. E.g. if -I 60 is specified and
|
|
|
538 a paired-end alignment consists of two 20-bp alignments in the appropriate orientation
|
|
|
539 with a 20-bp gap between them, that alignment is considered valid (as long as -X is also
|
|
|
540 satisfied). A 19-bp gap would not be valid in that case. Default: 0.
|
|
|
541
|
|
|
542 -X/--maxins INT The maximum insert size for valid paired-end alignments. E.g. if -X 100 is specified and
|
|
|
543 a paired-end alignment consists of two 20-bp alignments in the proper orientation with a
|
|
|
544 60-bp gap between them, that alignment is considered valid (as long as -I is also satisfied).
|
|
|
545 A 61-bp gap would not be valid in that case. Default: 500.
|
|
|
546
|
|
|
547
|
|
|
548
|
|
|
549 Output::
|
|
|
550
|
|
|
551 --non_directional The sequencing library was constructed in a non strand-specific manner, alignments to all four
|
|
|
552 bisulfite strands will be reported. Default: OFF.
|
|
|
553
|
|
|
554 (The current Illumina protocol for BS-Seq is directional, in which case the strands complementary
|
|
|
555 to the original strands are merely theoretical and should not exist in reality. Specifying directional
|
|
|
556 alignments (which is the default) will only run 2 alignment threads to the original top (OT)
|
|
|
557 or bottom (OB) strands in parallel and report these alignments. This is the recommended option
|
|
|
558 for sprand-specific libraries).
|
|
|
559
|
|
|
560 --sam-no-hd Suppress SAM header lines (starting with @). This might be useful when very large input files are
|
|
|
561 split up into several smaller files to run concurrently and the output files are to be merged.
|
|
|
562
|
|
|
563 --quiet Print nothing besides alignments.
|
|
|
564
|
|
|
565 --vanilla Performs bisulfite mapping with Bowtie 1 and prints the 'old' output (as in Bismark 0.5.X) instead
|
|
|
566 of SAM format output.
|
|
|
567
|
|
|
568 -un/--unmapped Write all reads that could not be aligned to a file in the output directory. Written reads will
|
|
|
569 appear as they did in the input, without any translation of quality values that may have
|
|
|
570 taken place within Bowtie or Bismark. Paired-end reads will be written to two parallel files with _1
|
|
|
571 and _2 inserted in their filenames, i.e. _unmapped_reads_1.txt and unmapped_reads_2.txt. Reads
|
|
|
572 with more than one valid alignment with the same number of lowest mismatches (ambiguous mapping)
|
|
|
573 are also written to _unmapped_reads.txt unless the option --ambiguous is specified as well.
|
|
|
574
|
|
|
575 --ambiguous Write all reads which produce more than one valid alignment with the same number of lowest
|
|
|
576 mismatches or other reads that fail to align uniquely to a file in the output directory.
|
|
|
577 Written reads will appear as they did in the input, without any of the translation of quality
|
|
|
578 values that may have taken place within Bowtie or Bismark. Paired-end reads will be written to two
|
|
|
579 parallel files with _1 and _2 inserted in theit filenames, i.e. _ambiguous_reads_1.txt and
|
|
|
580 _ambiguous_reads_2.txt. These reads are not written to the file specified with --un.
|
|
|
581
|
|
|
582 -o/--output_dir DIR Write all output files into this directory. By default the output files will be written into
|
|
|
583 the same folder as the input file(s). If the specified folder does not exist, Bismark will attempt
|
|
|
584 to create it first. The path to the output folder can be either relative or absolute.
|
|
|
585
|
|
|
586 --temp_dir DIR Write temporary files to this directory instead of into the same directory as the input files. If
|
|
|
587 the specified folder does not exist, Bismark will attempt to create it first. The path to the
|
|
|
588 temporary folder can be either relative or absolute.
|
|
|
589
|
|
|
590 ------
|
|
|
591
|
|
|
592 Bowtie 2 alignment options::
|
|
|
593
|
|
|
594 -N INT Sets the number of mismatches to allowed in a seed alignment during multiseed alignment.
|
|
|
595 Can be set to 0 or 1. Setting this higher makes alignment slower (often much slower)
|
|
|
596 but increases sensitivity. Default: 0. This option is only available for Bowtie 2 (for
|
|
|
597 Bowtie 1 see -n).
|
|
|
598
|
|
|
599 -L INT Sets the length of the seed substrings to align during multiseed alignment. Smaller values
|
|
|
600 make alignment slower but more senstive. Default: the --sensitive preset of Bowtie 2 is
|
|
|
601 used by default, which sets -L to 20. This option is only available for Bowtie 2 (for
|
|
|
602 Bowtie 1 see -l).
|
|
|
603
|
|
|
604 --ignore-quals When calculating a mismatch penalty, always consider the quality value at the mismatched
|
|
|
605 position to be the highest possible, regardless of the actual value. I.e. input is treated
|
|
|
606 as though all quality values are high. This is also the default behavior when the input
|
|
|
607 doesn't specify quality values (e.g. in -f mode). This option is invariable and on by default.
|
|
|
608
|
|
|
609
|
|
|
610 Bowtie 2 paired-end options::
|
|
|
611
|
|
|
612 --no-mixed This option disables Bowtie 2's behavior to try to find alignments for the individual mates if
|
|
|
613 it cannot find a concordant or discordant alignment for a pair. This option is invariable and
|
|
|
614 and on by default.
|
|
|
615
|
|
|
616 --no-discordant Normally, Bowtie 2 looks for discordant alignments if it cannot find any concordant alignments.
|
|
|
617 A discordant alignment is an alignment where both mates align uniquely, but that does not
|
|
|
618 satisfy the paired-end constraints (--fr/--rf/--ff, -I, -X). This option disables that behavior
|
|
|
619 and it is on by default.
|
|
|
620
|
|
|
621
|
|
|
622 Bowtie 2 effort options::
|
|
|
623
|
|
|
624 -D INT Up to INT consecutive seed extension attempts can "fail" before Bowtie 2 moves on, using
|
|
|
625 the alignments found so far. A seed extension "fails" if it does not yield a new best or a
|
|
|
626 new second-best alignment. Default: 15.
|
|
|
627
|
|
|
628 -R INT INT is the maximum number of times Bowtie 2 will "re-seed" reads with repetitive seeds.
|
|
|
629 When "re-seeding," Bowtie 2 simply chooses a new set of reads (same length, same number of
|
|
|
630 mismatches allowed) at different offsets and searches for more alignments. A read is considered
|
|
|
631 to have repetitive seeds if the total number of seed hits divided by the number of seeds
|
|
|
632 that aligned at least once is greater than 300. Default: 2.
|
|
|
633
|
|
|
634
|
|
|
635 Bowtie 2 Scoring options::
|
|
|
636
|
|
|
637 --score_min "func" Sets a function governing the minimum alignment score needed for an alignment to be considered
|
|
|
638 "valid" (i.e. good enough to report). This is a function of read length. For instance, specifying
|
|
|
639 L,0,-0.2 sets the minimum-score function f to f(x) = 0 + -0.2 * x, where x is the read length.
|
|
|
640 See also: setting function options at http://bowtie-bio.sourceforge.net/bowtie2. The default is
|
|
|
641 L,0,-0.2.
|
|
|
642
|
|
|
643
|
|
|
644 Bowtie 2 Reporting options::
|
|
|
645
|
|
|
646 --most_valid_alignments INT This used to be the Bowtie 2 parameter -M. As of Bowtie 2 version 2.0.0 beta7 the option -M is
|
|
|
647 deprecated. It will be removed in subsequent versions. What used to be called -M mode is still the
|
|
|
648 default mode, but adjusting the -M setting is deprecated. Use the -D and -R options to adjust the
|
|
|
649 effort expended to find valid alignments.
|
|
|
650
|
|
|
651 For reference, this used to be the old (now deprecated) description of -M:
|
|
|
652 Bowtie 2 searches for at most INT+1 distinct, valid alignments for each read. The search terminates when it
|
|
|
653 can't find more distinct valid alignments, or when it finds INT+1 distinct alignments, whichever
|
|
|
654 happens first. Only the best alignment is reported. Information from the other alignments is used to
|
|
21
|
655 estimate mapping quality and to set SAM optional fields, such as AS:i and XS:i. Increasing -M makes
|
|
9
|
656 Bowtie 2 slower, but increases the likelihood that it will pick the correct alignment for a read that
|
|
|
657 aligns many places. For reads that have more than INT+1 distinct, valid alignments, Bowtie 2 does not
|
|
|
658 guarantee that the alignment reported is the best possible in terms of alignment score. -M is
|
|
|
659 always used and its default value is set to 10.
|
|
|
660
|
|
21
|
661 ]]>
|
|
9
|
662 </help>
|
|
21
|
663 <citations>
|
|
|
664 <citation type="doi">10.1093/bioinformatics/btr167</citation>
|
|
|
665 </citations>
|
|
9
|
666 </tool>
|
