Mercurial > repos > devteam > bowtie2
annotate bowtie2_wrapper.xml @ 6:e23b0cdeeba6 draft
planemo upload commit 5ad726dc73203a704666033cd3bf70b82575978f
| author | devteam |
|---|---|
| date | Wed, 26 Aug 2015 12:46:11 -0400 |
| parents | 42bb952b4e3c |
| children | 4f92dccc808a |
| rev | line source |
|---|---|
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
1 <tool id="bowtie2" name="Bowtie2" version="0.6"> |
| 2 | 2 <!-- Wrapper compatible with Bowtie version 2.2.4 --> |
| 3 <description>- map reads against reference genome</description> | |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
4 <macros> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
5 <import>read_group_macros.xml</import> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
6 </macros> |
| 0 | 7 <version_command>bowtie2 --version</version_command> |
| 8 <requirements> | |
| 2 | 9 <requirement type="package" version="2.2.4">bowtie2</requirement> |
| 0 | 10 <requirement type="package" version="0.1.18">samtools</requirement> |
| 11 </requirements> | |
| 12 <command> | |
| 2 | 13 |
| 0 | 14 ## prepare bowtie2 index |
| 15 #set index_path = '' | |
| 16 #if str($reference_genome.source) == "history": | |
| 2 | 17 bowtie2-build "$reference_genome.own_file" genome && |
| 18 ln -s "$reference_genome.own_file" genome.fa && | |
| 0 | 19 #set index_path = 'genome' |
| 20 #else: | |
| 21 #set index_path = $reference_genome.index.fields.path | |
| 22 #end if | |
| 23 | |
| 24 ## execute bowtie2 | |
| 2 | 25 |
| 0 | 26 bowtie2 |
| 27 | |
| 28 ## number of threads | |
| 29 -p \${GALAXY_SLOTS:-4} | |
| 30 | |
| 31 ## index file path | |
| 32 -x $index_path | |
| 33 | |
| 34 | |
| 2 | 35 ## Fastq inputs |
| 36 #if str( $library.type ) == "single": | |
| 3 | 37 -U "${library.input_1}" |
| 2 | 38 #if str( $library.unaligned_file ) == "true": |
| 0 | 39 --un $output_unaligned_reads_l |
| 40 #end if | |
| 2 | 41 #elif str( $library.type ) == "paired": |
| 3 | 42 -1 "${library.input_1}" |
| 43 -2 "${library.input_2}" | |
| 2 | 44 #if str( $library.paired_options.paired_options_selector ) == "yes": |
| 45 -I "${library.paired_options.I}" | |
| 46 -X "${library.paired_options.X}" | |
| 47 ${library.paired_options.fr_rf_ff} | |
| 48 ${library.paired_options.no_mixed} | |
| 49 ${library.paired_options.no_discordant} | |
| 50 ${library.paired_options.dovetail} | |
| 51 ${library.paired_options.no_contain} | |
| 52 ${library.paired_options.no_overlap} | |
| 53 #end if | |
| 54 #if str( $library.unaligned_file ) == "true": | |
| 55 --un-conc $output_unaligned_reads_l | |
| 56 #end if | |
| 0 | 57 #else |
| 2 | 58 ## prepare collection |
| 59 -1 $library.input_1.forward | |
| 60 -2 $library.input_1.reverse | |
| 61 #if str( $library.paired_options.paired_options_selector ) == "yes": | |
| 62 -I "${library.paired_options.I}" | |
| 63 -X "${library.paired_options.X}" | |
| 64 ${library.paired_options.fr_rf_ff} | |
| 65 ${library.paired_options.no_mixed} | |
| 66 ${library.paired_options.no_discordant} | |
| 67 ${library.paired_options.dovetail} | |
| 68 ${library.paired_options.no_contain} | |
| 69 ${library.paired_options.no_overlap} | |
| 70 #end if | |
| 71 #if str( $library.unaligned_file ) == "true": | |
| 0 | 72 --un-conc $output_unaligned_reads_l |
| 73 #end if | |
| 74 #end if | |
| 75 | |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
76 ## Read group information. |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
77 @define_read_group_helpers@ |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
78 #if str( $library.type ) == "single": |
|
6
e23b0cdeeba6
planemo upload commit 5ad726dc73203a704666033cd3bf70b82575978f
devteam
parents:
5
diff
changeset
|
79 #set $rg_auto_name = $read_group_name_default($library.input_1) |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
80 #elif str( $library.type ) == "paired": |
|
6
e23b0cdeeba6
planemo upload commit 5ad726dc73203a704666033cd3bf70b82575978f
devteam
parents:
5
diff
changeset
|
81 #set $rg_auto_name = $read_group_name_default($library.input_1, $library.input_2) |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
82 #else |
|
6
e23b0cdeeba6
planemo upload commit 5ad726dc73203a704666033cd3bf70b82575978f
devteam
parents:
5
diff
changeset
|
83 #set $rg_auto_name = $read_group_name_default($library.input_1) |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
84 #end if |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
85 @set_use_rg_var@ |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
86 @set_read_group_vars@ |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
87 #if $use_rg |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
88 $format_read_group("", $rg_id, '"', arg='--rg-id ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
89 $format_read_group("SM:", $rg_sm, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
90 $format_read_group("PL:", $rg_pl, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
91 $format_read_group("LB:", $rg_lb, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
92 $format_read_group("CN:", $rg_cn, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
93 $format_read_group("DS:", $rg_ds, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
94 $format_read_group("DT:", $rg_dt, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
95 $format_read_group("FO:", $rg_fo, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
96 $format_read_group("KS:", $rg_ks, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
97 $format_read_group("PG:", $rg_pg, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
98 $format_read_group("PI:", $rg_pi, '"', arg='--rg ') |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
99 $format_read_group("PU:", $rg_pu, '"', arg='--rg ') |
| 2 | 100 #end if |
| 0 | 101 |
| 2 | 102 ## Analysis type |
| 103 #if ( str( $analysis_type.analysis_type_selector ) == "simple" and str( $analysis_type.presets ) != "no_presets" ): | |
| 104 $analysis_type.presets | |
| 105 #elif str( $analysis_type.analysis_type_selector ) == "full": | |
| 106 #if str( $analysis_type.input_options.input_options_selector ) == "yes": | |
| 107 --skip "${analysis_type.input_options.skip}" | |
| 108 --qupto "${analysis_type.input_options.qupto}" | |
| 109 --trim5 "${analysis_type.input_options.trim5}" | |
| 110 --trim3 "${analysis_type.input_options.trim3}" | |
| 111 ${analysis_type.input_options.qv_encoding} | |
| 3 | 112 ${analysis_type.input_options.solexa_quals} |
| 113 ${analysis_type.input_options.int_quals} | |
| 0 | 114 #end if |
| 2 | 115 |
| 116 #if str( $analysis_type.alignment_options.alignment_options_selector ) == "yes": | |
| 3 | 117 -N "${analysis_type.alignment_options.N}" |
| 118 -L "${analysis_type.alignment_options.L}" | |
| 119 -i "${analysis_type.alignment_options.i}" | |
| 120 --n-ceil "${analysis_type.alignment_options.n_ceil}" | |
| 121 --dpad "${analysis_type.alignment_options.dpad}" | |
| 122 --gbar "${analysis_type.alignment_options.gbar}" | |
| 123 ${analysis_type.alignment_options.ignore_quals} | |
| 2 | 124 ${analysis_type.alignment_options.nofw} |
| 125 ${analysis_type.alignment_options.norc} | |
| 126 ${analysis_type.alignment_options.no_1mm_upfront} | |
| 127 #if str( $analysis_type.alignment_options.align_mode.align_mode_selector ) == "end-to-end": | |
| 128 --end-to-end | |
| 3 | 129 --score-min "${analysis_type.alignment_options.align_mode.score_min_ete}" |
| 2 | 130 #elif str( $analysis_type.alignment_options.align_mode.align_mode_selector ) == "local": |
| 131 --local | |
| 3 | 132 --score-min "${analysis_type.alignment_options.align_mode.score_min_loc}" |
| 2 | 133 #end if |
| 134 #end if | |
| 135 | |
| 136 #if str( $analysis_type.scoring_options.scoring_options_selector ) == "yes": | |
| 3 | 137 #if ( str( $analysis_type.alignment_options.alignment_options_selector ) == "yes" and str( $analysis_type.alignment_options.align_mode.align_mode_selector ) == "local" ): |
| 138 --ma "${analysis_type.scoring_options.ma}" | |
| 139 #end if | |
| 2 | 140 --mp "${analysis_type.scoring_options.mp}" |
| 141 --np "${analysis_type.scoring_options.np}" | |
| 142 --rdg "${analysis_type.scoring_options.rdg_read_open},${analysis_type.scoring_options.rdg_read_extend}" | |
| 143 --rfg "${analysis_type.scoring_options.rfg_ref_open},${analysis_type.scoring_options.rfg_ref_extend}" | |
| 144 #end if | |
| 145 | |
| 146 #if str( $analysis_type.reporting_options.reporting_options_selector ) == "k": | |
| 147 -k "${analysis_type.reporting_options.k}" | |
| 148 #elif str( $analysis_type.reporting_options.reporting_options_selector ) == "a": | |
| 149 -a | |
| 150 #end if | |
| 151 | |
| 152 #if str( $analysis_type.effort_options.effort_options_selector ) == "yes": | |
| 153 -D "${analysis_type.effort_options.D}" | |
| 154 -R "${analysis_type.effort_options.R}" | |
| 155 #end if | |
| 156 | |
| 157 #if str( $analysis_type.sam_options.sam_options_selector ) == "yes": | |
| 3 | 158 ${analysis_type.sam_options.no_unal} |
| 159 ${analysis_type.sam_options.omit_sec_seq} | |
| 2 | 160 #end if |
| 161 | |
| 162 #if str( $analysis_type.other_options.other_options_selector ) == "yes": | |
| 3 | 163 ${analysis_type.other_options.non_deterministic} |
| 2 | 164 --seed "${analysis_type.other_options.seed}" |
| 0 | 165 #end if |
| 166 | |
| 2 | 167 #elif str( $analysis_type.analysis_type_selector ) == "cline": |
| 168 ${analysis_type.cline} | |
|
4
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
169 #end if |
| 0 | 170 |
|
4
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
171 -S "galaxy_bowtie_2_output.sam" && |
|
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
172 |
| 2 | 173 ## view/sort and output BAM file |
|
4
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
174 ( samtools view -Su "galaxy_bowtie_2_output.sam" | samtools sort -o - - > $output ) |
| 3 | 175 |
| 0 | 176 ## rename unaligned sequence files |
| 177 #if $library.type == "paired" and $output_unaligned_reads_l and $output_unaligned_reads_r: | |
|
4
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
178 #from os.path import splitext |
|
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
179 #set _unaligned_root, _unaligned_ext = splitext( str( $output_unaligned_reads_l ) ) |
|
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
180 && mv "${ _unaligned_root }.1${_unaligned_ext}" "${ output_unaligned_reads_l }" |
|
1fc845afa3ac
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit 32fe80982b5c59687eece667f0372002588566f8-dirty
devteam
parents:
3
diff
changeset
|
181 && mv "${ _unaligned_root }.2${_unaligned_ext}" "${ output_unaligned_reads_r }" |
| 0 | 182 #end if |
| 2 | 183 |
| 0 | 184 </command> |
| 185 | |
| 186 <!-- basic error handling --> | |
| 187 <stdio> | |
| 188 <exit_code range="1:" level="fatal" description="Tool exception" /> | |
| 189 </stdio> | |
| 190 | |
| 191 <inputs> | |
| 192 <!-- single/paired --> | |
| 193 <conditional name="library"> | |
| 2 | 194 <param name="type" type="select" label="Is this single or paired library"> |
| 0 | 195 <option value="single">Single-end</option> |
| 196 <option value="paired">Paired-end</option> | |
| 2 | 197 <option value="paired_collection">Paired-end Dataset Collection</option> |
| 0 | 198 </param> |
| 2 | 199 |
| 0 | 200 <when value="single"> |
| 201 <param name="input_1" format="fastqsanger" type="data" label="FASTQ file" help="Nucleotide-space: Must have Sanger-scaled quality values with ASCII offset 33"/> | |
| 2 | 202 <param name="unaligned_file" type="boolean" truevalue="true" falsevalue="false" checked="False" label="Write unaligned reads (in fastq format) to separate file(s)" help="--un/--un-conc; This triggers --un parameter for single reads and --un-conc for paired reads" /> |
| 0 | 203 </when> |
| 204 <when value="paired"> | |
| 205 <param name="input_1" format="fastqsanger" type="data" label="FASTQ file" help="Nucleotide-space: Must have Sanger-scaled quality values with ASCII offset 33" /> | |
| 206 <param name="input_2" format="fastqsanger" type="data" label="FASTQ file" help="Nucleotide-space: Must have Sanger-scaled quality values with ASCII offset 33" /> | |
| 2 | 207 <param name="unaligned_file" type="boolean" truevalue="true" falsevalue="false" checked="False" label="Write unaligned reads (in fastq format) to separate file(s)" help="--un/--un-conc; This triggers --un parameter for single reads and --un-conc for paired reads" /> |
| 208 <conditional name="paired_options"> | |
| 209 <param name="paired_options_selector" type="select" label="Do you want to set paired-end options?" help="See "Alignment Options" section of Help below for information"> | |
| 210 <option value="no" selected="True">No</option> | |
| 211 <option value="yes">Yes</option> | |
| 212 </param> | |
| 213 <when value="yes"> | |
| 214 <param name="I" type="integer" value="0" min="0" label="Set the minimum fragment length for valid paired-end alignments" help="-I/--minins; E.g. if `-I 60` is specified and a paired-end alignment consists of two 20-bp alignments in the appropriate orientation with a 20-bp gap between them, that alignment is considered valid (as long as `-X` is also satisfied). A 19-bp gap would not be valid in that case. If trimming options `-3` or `-5` are also used, the `-I` constraint is applied with respect to the untrimmed mates. The larger the difference between `-I` and `-X`, the slower Bowtie 2 will run. This is because larger differences bewteen `-I` and `-X` require that Bowtie 2 scan a larger window to determine if a concordant alignment exists. For typical fragment length ranges (200 to 400 nucleotides), Bowtie 2 is very efficient. Default=0"/> | |
| 3 | 215 <param name="X" type="integer" value="500" min="0" label="Set the maximum fragment length for valid paired-end alignments" help="-X/--maxins; E.g. if `-X 100` is specified and a paired-end alignment consists of two 20-bp alignments in the proper orientation with a 60-bp gap between them, that alignment is considered valid (as long as `-I` is also satisfied). A 61-bp gap would not be valid in that case. If trimming options `-3` or `-5` are also used, the `-X` constraint is applied with respect to the untrimmed mates, not the trimmed mates; Default=500"/> |
| 216 <param name="fr_rf_ff" type="select" display="radio" label="Select the upstream/downstream mate orientations for a valid paired-end alignment against the forward reference strand" help="--fr, --rf, or --ff; E.g., if `--fr` is specified and there is a candidate paired-end alignment where mate 1 appears upstream of the reverse complement of mate 2 and the fragment length constraints (`-I` and `-X`) are met, that alignment is valid. Also, if mate 2 appears upstream of the reverse complement of mate 1 and all other constraints are met, that too is valid. `--rf` likewise requires that an upstream mate1 be reverse-complemented and a downstream mate2 be forward-oriented. `--ff` requires both an upstream mate 1 and a downstream mate 2 to be forward-oriented; Default=--fr (appropriate for Illumina's Paired-end Sequencing Assay)"> | |
| 2 | 217 <option value="--fr" selected="True">--fr</option> |
| 3 | 218 <option value="--rf">--rf</option> |
| 2 | 219 <option value="--ff">--ff</option> |
| 220 </param> | |
| 221 <param name="no_mixed" type="boolean" truevalue="--no-mixed" falsevalue="" checked="False" label="Disable no-mixed behavior" help="--no-mixed; By default, when `bowtie2` cannot find a concordant or discordant alignment for a pair, it then tries to find alignments for the individual mates; default=False"/> | |
| 222 <param name="no_discordant" type="boolean" truevalue="--no-discordant" falsevalue="" checked="False" label="Disable no-discordant behavior" help="--no-discordant; By default, `bowtie2` looks for discordant alignments if it cannot find any concordant alignments. A discordant alignment is an alignment where both mates align uniquely, but that does not satisfy the paired-end constraints (`--fr`/`--rf`/`--ff`, `-I`, `-X`); default=False"/> | |
| 3 | 223 <param name="dovetail" type="boolean" truevalue="--dovetail" falsevalue="" checked="False" label="Allow mate dovetailing" help="--dovetail; If the mates `dovetail`, that is if one mate alignment extends past the beginning of the other such that the wrong mate begins upstream, consider that to be concordant. Default=False"/> |
| 224 <param name="no_contain" type="boolean" truevalue="--no-contain" falsevalue="" checked="False" label="Allow one mate alignment to contain another" help="--no-contain; If one mate alignment contains the other, consider that to be non-concordant. Default=False"/> | |
| 225 <param name="no_overlap" type="boolean" truevalue="--no-overlap" falsevalue="" checked="False" label="Allow mate alignments to overlap" help="--no-overlap; If one mate alignment overlaps the other at all, consider that to be non-concordant. Default=False"/> | |
| 2 | 226 </when> |
| 227 <when value="no"> | |
| 228 <!-- do nothing --> | |
| 229 </when> | |
| 230 </conditional> | |
| 231 </when> | |
| 232 <when value="paired_collection"> | |
| 233 <param name="input_1" format="fastqsanger" type="data_collection" collection_type="paired" label="FASTQ Paired Dataset" help="Nucleotide-space: Must have Sanger-scaled quality values with ASCII offset 33" /> | |
| 234 <param name="unaligned_file" type="boolean" truevalue="true" falsevalue="false" checked="False" label="Write unaligned reads (in fastq format) to separate file(s)" help="--un/--un-conc; This triggers --un parameter for single reads and --un-conc for paired reads" /> | |
| 235 <conditional name="paired_options"> | |
| 236 <param name="paired_options_selector" type="select" label="Do you want to set paired-end options?" help="See "Alignment Options" section of Help below for information"> | |
| 237 <option value="no" selected="True">No</option> | |
| 238 <option value="yes">Yes</option> | |
| 239 </param> | |
| 240 <when value="yes"> | |
| 241 <param name="I" type="integer" value="0" min="0" label="Set the minimum fragment length for valid paired-end alignments" help="-I/--minins; E.g. if `-I 60` is specified and a paired-end alignment consists of two 20-bp alignments in the appropriate orientation with a 20-bp gap between them, that alignment is considered valid (as long as `-X` is also satisfied). A 19-bp gap would not be valid in that case. If trimming options `-3` or `-5` are also used, the `-I` constraint is applied with respect to the untrimmed mates. The larger the difference between `-I` and `-X`, the slower Bowtie 2 will run. This is because larger differences bewteen `-I` and `-X` require that Bowtie 2 scan a larger window to determine if a concordant alignment exists. For typical fragment length ranges (200 to 400 nucleotides), Bowtie 2 is very efficient. Default=0"/> | |
| 3 | 242 <param name="X" type="integer" value="500" min="0" label="Set the maximum fragment length for valid paired-end alignments" help="-X/--maxins; E.g. if `-X 100` is specified and a paired-end alignment consists of two 20-bp alignments in the proper orientation with a 60-bp gap between them, that alignment is considered valid (as long as `-I` is also satisfied). A 61-bp gap would not be valid in that case. If trimming options `-3` or `-5` are also used, the `-X` constraint is applied with respect to the untrimmed mates, not the trimmed mates; Default=500"/> |
| 243 <param name="fr_rf_ff" type="select" display="radio" label="Select the upstream/downstream mate orientations for a valid paired-end alignment against the forward reference strand" help="--fr, --rf, or --ff; E.g., if `--fr` is specified and there is a candidate paired-end alignment where mate 1 appears upstream of the reverse complement of mate 2 and the fragment length constraints (`-I` and `-X`) are met, that alignment is valid. Also, if mate 2 appears upstream of the reverse complement of mate 1 and all other constraints are met, that too is valid. `--rf` likewise requires that an upstream mate1 be reverse-complemented and a downstream mate2 be forward-oriented. `--ff` requires both an upstream mate 1 and a downstream mate 2 to be forward-oriented; Default=--fr (appropriate for Illumina's Paired-end Sequencing Assay)"> | |
| 2 | 244 <option value="--fr" selected="True">--fr</option> |
| 3 | 245 <option value="--rf">--rf</option> |
| 2 | 246 <option value="--ff">--ff</option> |
| 247 </param> | |
| 248 <param name="no_mixed" type="boolean" truevalue="--no-mixed" falsevalue="" checked="False" label="Disable no-mixed behavior" help="--no-mixed; By default, when `bowtie2` cannot find a concordant or discordant alignment for a pair, it then tries to find alignments for the individual mates; default=False"/> | |
| 249 <param name="no_discordant" type="boolean" truevalue="--no-discordant" falsevalue="" checked="False" label="Disable no-discordant behavior" help="--no-discordant; By default, `bowtie2` looks for discordant alignments if it cannot find any concordant alignments. A discordant alignment is an alignment where both mates align uniquely, but that does not satisfy the paired-end constraints (`--fr`/`--rf`/`--ff`, `-I`, `-X`); default=False"/> | |
| 3 | 250 <param name="dovetail" type="boolean" truevalue="--dovetail" falsevalue="" checked="False" label="Allow mate dovetailing" help="--dovetail; If the mates `dovetail`, that is if one mate alignment extends past the beginning of the other such that the wrong mate begins upstream, consider that to be concordant. Default=False"/> |
| 251 <param name="no_contain" type="boolean" truevalue="--no-contain" falsevalue="" checked="False" label="Allow one mate alignment to contain another" help="--no-contain; If one mate alignment contains the other, consider that to be non-concordant. Default=False"/> | |
| 252 <param name="no_overlap" type="boolean" truevalue="--no-overlap" falsevalue="" checked="False" label="Allow mate alignments to overlap" help="--no-overlap; If one mate alignment overlaps the other at all, consider that to be non-concordant. Default=False"/> | |
| 2 | 253 </when> |
| 254 <when value="no"> | |
| 255 <!-- do nothing --> | |
| 256 </when> | |
| 257 </conditional> | |
| 0 | 258 </when> |
| 259 </conditional> | |
| 2 | 260 |
| 0 | 261 <!-- reference genome --> |
| 262 <conditional name="reference_genome"> | |
| 2 | 263 <param name="source" 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. See `Indexes` section of help below"> |
| 264 <option value="indexed">Use a built-in genome index</option> | |
| 265 <option value="history">Use a genome from the history and build index</option> | |
| 0 | 266 </param> |
| 267 <when value="indexed"> | |
| 2 | 268 <param name="index" type="select" label="Select reference genome" help="If your genome of interest is not listed, contact the Galaxy team"> |
| 0 | 269 <options from_data_table="bowtie2_indexes"> |
| 270 <filter type="sort_by" column="2"/> | |
| 271 <validator type="no_options" message="No indexes are available for the selected input dataset"/> | |
| 272 </options> | |
| 273 </param> | |
| 274 </when> | |
| 275 <when value="history"> | |
| 2 | 276 <param name="own_file" type="data" format="fasta" metadata_name="dbkey" label="Select reference genome" /> |
| 0 | 277 </when> |
| 278 </conditional> | |
| 279 | |
| 2 | 280 <!-- read group settings --> |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
281 <expand macro="read_group_conditional" /> |
| 2 | 282 <conditional name="analysis_type"> |
| 283 <param name="analysis_type_selector" type="select" label="Select analysis mode"> | |
| 284 <option value="simple">1: Default setting only</option> | |
| 285 <option value="full">2: Full parameter list</option> | |
| 0 | 286 </param> |
| 2 | 287 <when value="simple"> |
| 288 <param name="presets" type="select" display="radio" label="Do you want to use presets?" help="Allow selecting among several preset parameter settings. Choosing between these will result in dramatic changes in runtime. See help below to understand effects of these presets."> | |
| 289 <option value="no_presets" selected="True">No, just use defaults</option> | |
| 290 <option value="--very-fast">Very fast end-to-end (--very-fast)</option> | |
| 291 <option value="--fast">Fast end-to-end (--fast)</option> | |
| 292 <option value="--sensitive">Sensitive end-to-end (--sensitive)</option> | |
| 293 <option value="--very-sensitive">Very sensitive end-to-end (--very-sensitive)</option> | |
| 294 <option value="--very-fast-local">Very fast local (--very-fast-local)</option> | |
| 295 <option value="--fast-local">Fast local (--fast-local)</option> | |
| 296 <option value="--sensitive-local">Sensitive local (--sensitive-local)</option> | |
| 297 <option value="--very-sensitive-local">Very sensitive local (--very-sensitive-local)</option> | |
| 0 | 298 </param> |
| 2 | 299 </when> |
| 300 <when value="full"> | |
| 301 <conditional name="input_options"> | |
| 302 <param name="input_options_selector" type="select" label="Do you want to tweak input options?" help="See "Input Options" section of Help below for information"> | |
| 303 <option value="yes">Yes</option> | |
| 304 <option value="no" selected="true">No</option> | |
| 305 </param> | |
| 306 <when value="yes"> | |
| 3 | 307 <param name="skip" type="integer" min="0" value="0" label="Skip (i.e. do not align) the first that many reads or pairs in the input" help="-s/--skip; default=0"/> |
| 308 <param name="qupto" type="integer" min="1" value="100000000" label="Align the first that many reads or read pairs from the input (after the -s/--skip reads or pairs have been skipped), then stop" help="-u/--qupto; for default behavior (no limit) leave this value very large"/> | |
| 2 | 309 <param name="trim5" type="integer" min="0" value="0" label="Trim that many bases from 5' (left) end of each read before alignment" help="-5/--trim5; default=0"/> |
| 310 <param name="trim3" type="integer" min="0" value="0" label="Trim that many bases from 3' (right) end of each read before alignment" help="-3/--trim3; default=0"/> | |
| 311 <param name="qv_encoding" type="select" display="radio" label="Select quality score encoding" help="See help below for more details"> | |
| 3 | 312 <option value="--phred33" selected="True">Input qualities are ASCII chars equal to the Phred quality plus 33. This is also called the "Phred+33" encoding, which is used by the very latest Illumina pipelines (--phred33)</option> |
| 313 <option value="--phred64">Input qualities are ASCII chars equal to the Phred quality plus 64. This is also called the "Phred+64" encoding (--phred64)</option> | |
| 2 | 314 </param> |
| 3 | 315 <param name="solexa_quals" type="boolean" truevalue="--solexa-quals" falsevalue="" checked="False" label="Convert input qualities from Solexa (which can be negative) to Phred (which can't). This scheme was used in older Illumina GA Pipeline versions (prior to 1.3)" help="--solexa-quals; default=False"/> |
| 316 <param name="int_quals" type="boolean" truevalue="--int-quals" falsevalue="" checked="False" label="Quality values are represented in the read input file as space-separated ASCII integers, e.g., 40 40 30 40..., rather than ASCII characters, e.g., II?I.... Integers are treated as being on the Phred quality scale unless --solexa-quals is also specified" help="--int-quals; default=False"/> | |
| 2 | 317 </when> |
| 318 <when value="no"> | |
| 319 <!-- do nothing --> | |
| 320 </when> | |
| 321 </conditional> | |
| 322 <conditional name="alignment_options"> | |
| 323 <param name="alignment_options_selector" type="select" label="Do you want to tweak alignment options?" help="See "Alignment Options" section of Help below for information"> | |
| 324 <option value="yes">Yes</option> | |
| 325 <option value="no" selected="true">No</option> | |
| 326 </param> | |
| 327 <when value="yes"> | |
| 328 <param name="N" type="integer" min="0" max="1" value="0" label="Set the number of mismatches to be allowed in a seed alignment during multiseed alignment (see `Multiseed alignment` section of help below)" help="-N; Can be set to 0 or 1. Setting this higher makes alignment slower (often much slower) but increases sensitivity; default=0"/> | |
| 3 | 329 <param name="L" type="integer" min="0" max="32" value="22" label="Sets the length of the seed substrings to align during multiseed alignment (see `Multiseed alignment` section of help below)" help="-L; Smaller values make alignment slower but more sensitive. Default=22"/> |
| 330 <param name="i" type="text" value="S,1,1.15" size="10" label="Set a function governing the interval between seed substrings to use during multiseed alignment (see `Multiseed alignment` section of help below). Also see description of this option below in the help section" help="-i; Since it's best to use longer intervals for longer reads, this parameter sets the interval as a function of the read length, rather than a single one-size-fits-all number. For instance, specifying `-i S,1,2.5` sets the interval function `f` to `f(x) = 1 + 2.5 * sqrt(x)`, where x is the read length. If the function returns a result less than 1, it is rounded up to 1. Default=`S,1,1.15`"/> | |
| 331 <param name="n_ceil" type="text" value="L,0,0.15" label="Set a function governing the maximum number of ambiguous characters (usually `N`s and/or `.`s) allowed in a read as a function of read length" help="--n-ceil; For instance, specifying `L,0,0.15` sets the N-ceiling function `f` to `f(x) = 0 + 0.15 * x`, where x is the read length. Reads exceeding this ceiling are filtered out. Default=`L,0,0.15`"/> | |
| 332 <param name="dpad" type="integer" min="0" value="15" label="Pad dynamic programming problems by that many columns on either side to allow gaps" help="--dpad; default=15"/> | |
| 2 | 333 <param name="gbar" type="integer" min="0" value="4" label="Disallow gaps within that many positions of the beginning or end of the read" help="--gbar; default=4"/> |
| 3 | 334 <param name="ignore_quals" type="boolean" truevalue="--ignore-quals" falsevalue="" selected="False" label="When calculating a mismatch penalty, always consider the quality value at the mismatched position to be the highest possible, regardless of the actual value" help="--ignore-quals; input is treated as though all quality values are high; default=False"/> |
| 2 | 335 <param name="nofw" type="boolean" truevalue="--nofw" falsevalue="" selected="False" label="Do not attempt to align unpaired reads to the forward (Watson) reference strand" help="In paired-end mode, `--nofw` and `--norc` pertain to the fragments; i.e. specifying `--nofw` causes `bowtie2` to explore only those paired-end configurations corresponding to fragments from the reverse-complement (Crick) strand. Default=False"/> |
| 336 <param name="norc" type="boolean" truevalue="--norc" falsevalue="" selected="False" label="Do not attempt to align unpaired reads to the reverse (Crick) reference strand" help="In paired-end mode, `--nofw` and `--norc` pertain to the fragments; i.e. specifying `--nofw` causes `bowtie2` to explore only those paired-end configurations corresponding to fragments from the reverse-complement (Crick) strand. Default=False"/> | |
| 3 | 337 <param name="no_1mm_upfront" type="boolean" truevalue="--no-1mm-upfront" falsevalue="" selected="False" label="Prevent searching for 1-mismatch end-to-end alignments before using the multiseed heuristic (see `Multiseed alignment` section of help below)" help="--no-1mm-upfront; By default, Bowtie 2 will attempt to find either an exact or a 1-mismatch end-to-end alignment for the read *before* trying the multiseed heuristic. Such alignments can be found very quickly, and many short read alignments have exact or near-exact end-to-end alignments. However, this can lead to unexpected alignments when the user also sets options governing the multiseed heuristic, like `-L` and `-N`. For instance, if the user specifies `-N 0` and `-L` equal to the length of the read, the user will be surprised to find 1-mismatch alignments reported. This option prevents Bowtie 2 from searching for 1-mismatch end-to-end alignments before using the multiseed heuristic, which leads to the expected behavior when combined with options such as `-L` and `-N`. This comes at the expense of speed; Default=False"/> |
| 2 | 338 <conditional name="align_mode"> |
| 339 <param name="align_mode_selector" type="select" display="radio" label="Select between `--local` and `--end-to-end` alignment modes" help="--local and --end-to-end; see help below for detailed explanation; default=--end-to-end"> | |
| 340 <option value="end-to-end" selected="True">End to End (--end-to-end)</option> | |
| 341 <option value="local">Local (--local)</option> | |
| 342 </param> | |
| 343 <when value="end-to-end"> | |
| 3 | 344 <param name="score_min_ete" type="text" value="L,-0.6,-0.6" label="Set a function governing the minimum alignment score needed for an alignment to be considered `valid` (i.e. good enough to report)" help="--score-min; This is a function of read length. For instance, specifying `L,0,-0.6` sets the minimum-score function `f` to `f(x) = 0 + -0.6 * x`, where `x` is the read length. The default in `--end-to-end` mode is `L,-0.6,-0.6` and the default in `--local` mode is `G,20,8`"/> |
| 2 | 345 </when> |
| 346 <when value="local"> | |
| 3 | 347 <param name="score_min_loc" type="text" value="G,20,8" label="Set a function governing the minimum alignment score needed for an alignment to be considered `valid` (i.e. good enough to report)" help="--score-min; This is a function of read length. For instance, specifying `L,0,-0.6` sets the minimum-score function `f` to `f(x) = 0 + -0.6 * x`, where `x` is the read length. The default in `--end-to-end` mode is `L,-0.6,-0.6` and the default in `--local` mode is `G,20,8`"/> |
| 2 | 348 </when> |
| 349 </conditional> | |
| 350 </when> | |
| 351 <when value="no"> | |
| 352 <!-- do nothing --> | |
| 353 </when> | |
| 354 </conditional> | |
| 355 <conditional name="scoring_options"> | |
| 356 <param name="scoring_options_selector" type="select" label="Do you want to tweak scoring options?" help="See "Scoring Options" section of Help below for information"> | |
| 357 <option value="yes">Yes</option> | |
| 358 <option value="no" selected="true">No</option> | |
| 359 </param> | |
| 360 <when value="yes"> | |
| 361 <param name="ma" type="integer" value="2" label="Set the match bonus" help="--ma; In `--local` mode match bonus is added to the alignment score for each position where a read character aligns to a reference character and the characters match. Not used in `--end-to-end` mode; Default=2"/> | |
| 362 <param name="mp" type="text" size="10" value="6,2" label="Set the maximum (`MX`) and minimum (`MN`) mismatch penalties, both integers" help="--mp; A number less than or equal to `MX` and greater than or equal to `MN` is subtracted from the alignment score for each position where a read character aligns to a reference character, the characters do not match, and neither is an `N`. If `--ignore-quals` is specified, the number subtracted quals `MX`. Otherwise, the number subtracted is `MN + floor( (MX-MN)(MIN(Q, 40.0)/40.0) )` where Q is the Phred quality value; Default=6,2"/> | |
| 363 <param name="np" type="integer" value="1" label="Sets penalty for positions where the read, reference, or both, contain an ambiguous character such as `N`" help="--np; Default=1"/> | |
| 364 <param name="rdg_read_open" type="integer" value="5" label="Set the read gap opening penalty" help="--rdg; this is the first component of --rdg flag - opening penalty; Default=5"/> | |
| 365 <param name="rdg_read_extend" type="integer" value="3" label="Set the read gap extension penalty" help="--rdg; this is the second component of --rdg flag - extension penalty; Default=3"/> | |
| 366 <param name="rfg_ref_open" type="integer" value="5" label="Set the reference gap opening penalty" help="--rfg; this is the first component of --rfg flag - opening penalty; Default=5"/> | |
| 367 <param name="rfg_ref_extend" type="integer" value="3" label="Set the reference gap extension penalty" help="--rfg; this is the second component of --rfg flag - extension penalty; Default=3"/> | |
| 368 </when> | |
| 369 <when value="no"> | |
| 370 <!-- do nothing --> | |
| 371 </when> | |
| 372 </conditional> | |
| 373 <conditional name="reporting_options"> | |
| 374 <param name="reporting_options_selector" type="select" label="Do you want to use -a or -k options" help="Make sure you understand implications of setting -k and -a. See "Reporting Options" section of Help below for information on -k and -a options"> | |
| 375 <option value="no" selected="true">No, do not set</option> | |
| 376 <option value="k">Set -k option and enter -k value</option> | |
| 377 <option value="a">Set -a option</option> | |
| 378 </param> | |
| 379 <when value="no"> | |
| 380 <!-- do nothing --> | |
| 381 </when> | |
| 3 | 382 <when value="k"> |
| 383 <param name="k" type="integer" min="1" value="1" label="Searches for at most that many distinct, valid alignments for each read" help="-k; see detailed description of this option in the help section below. Note: Bowtie 2 is not designed with large values for `-k` in mind, and when aligning reads to long, repetitive genomes large `-k` can be very, very slow"/> | |
| 2 | 384 </when> |
| 3 | 385 <when value="a"> |
| 2 | 386 <!-- do nothing here; set -a flag on the command line--> |
| 387 </when> | |
| 388 </conditional> | |
| 389 <conditional name="effort_options"> | |
| 390 <param name="effort_options_selector" type="select" label="Do you want to tweak effort options?" help="See "Effort Options" section of Help below for information"> | |
| 391 <option value="yes">Yes</option> | |
| 392 <option value="no" selected="true">No</option> | |
| 393 </param> | |
| 394 <when value="yes"> | |
| 3 | 395 <param name="D" type="integer" value="15" min="0" label="Attempt that many consecutive seed extension attempts to `fail` before Bowtie 2 moves on, using the alignments found so far" help="-D; A seed extension `fails` if it does not yield a new best or a new second-best alignment. This limit is automatically adjusted up when -k or -a are specified. Default=15"/> |
| 2 | 396 <param name="R" type="integer" value="2" min="0" label="Set the maximum number of times Bowtie 2 will `re-seed` reads with repetitive seeds" help="When `re-seeding`, Bowtie 2 simply chooses a new set of reads (same length, same number of mismatches allowed) at different offsets and searches for more alignments. A read is considered to have repetitive seeds if the total number of seed hits divided by the number of seeds that aligned at least once is greater than 300. Default=2"/> |
| 397 </when> | |
| 398 <when value="no"> | |
| 399 <!-- do nothing --> | |
| 400 </when> | |
| 401 </conditional> | |
| 0 | 402 |
| 2 | 403 <conditional name="sam_options"> |
| 404 <param name="sam_options_selector" type="select" label="Do you want to tweak SAM/BAM Options?" help="See "Output Options" section of Help below for information"> | |
| 405 <option value="yes">Yes</option> | |
| 406 <option value="no" selected="true">No</option> | |
| 407 </param> | |
| 408 <when value="yes"> | |
| 3 | 409 <param name="no_unal" type="boolean" truevalue="--no-unal" falsevalue="" label="Suppress SAM records for reads that failed to align" help="--no-unal; Default=False"/> |
| 410 <param name="omit_sec_seq" type="boolean" truevalue="--omit-sec-seq" falsevalue="" label="Suppress SEQ and QUAL strings for secondary alignments" help="--omit-sec-seq; Default=False"/> | |
| 2 | 411 </when> |
| 412 <when value="no"> | |
| 413 <!-- do nothing --> | |
| 414 </when> | |
| 415 </conditional> | |
| 416 <conditional name="other_options"> | |
| 417 <param name="other_options_selector" type="select" label="Do you want to tweak Other Options?" help="See "Other Options" section of Help below for information"> | |
| 418 <option value="yes">Yes</option> | |
| 419 <option value="no" selected="true">No</option> | |
| 420 </param> | |
| 421 <when value="yes"> | |
| 422 <param name="seed" type="integer" value="0" min="0" label="Use this number as the seed for pseudo-random number generator" help="--seed; Default=0"/> | |
| 3 | 423 <param name="non_deterministic" type="boolean" truevalue="--non-deterministic" falsevalue="" label="Re-initialize the pseudo-random generator for each read using the current time" help="--non-deterministic; see Help below for explanation of this option; default=False"/> |
| 2 | 424 </when> |
| 425 <when value="no"> | |
| 426 <!-- do nothing --> | |
| 427 </when> | |
| 428 </conditional> | |
| 0 | 429 </when> |
| 430 </conditional> | |
| 431 </inputs> | |
| 432 | |
| 433 <!-- define outputs --> | |
| 2 | 434 |
| 0 | 435 <outputs> |
| 2 | 436 |
| 0 | 437 <data format="fastqsanger" name="output_unaligned_reads_l" label="${tool.name} on ${on_string}: unaligned reads (L)" > |
| 2 | 438 <filter>library['unaligned_file'] is True</filter> |
| 0 | 439 <actions> |
| 440 <action type="format"> | |
| 441 <option type="from_param" name="library.input_1" param_attribute="ext" /> | |
| 442 </action> | |
| 443 </actions> | |
| 444 </data> | |
| 445 <data format="fastqsanger" name="output_unaligned_reads_r" label="${tool.name} on ${on_string}: unaligned reads (R)"> | |
| 2 | 446 <filter>( library['type'] == "paired" or library['type'] == "paired_collection" ) and library['unaligned_file'] is True</filter> |
| 0 | 447 <actions> |
| 448 <action type="format"> | |
| 449 <option type="from_param" name="library.input_1" param_attribute="ext" /> | |
| 450 </action> | |
| 451 </actions> | |
| 452 </data> | |
| 2 | 453 |
| 3 | 454 <data format="bam" name="output" label="${tool.name} on ${on_string}: aligned reads (sorted BAM)"> |
| 0 | 455 <actions> |
| 456 <conditional name="reference_genome.source"> | |
| 457 <when value="indexed"> | |
| 458 <action type="metadata" name="dbkey"> | |
| 459 <option type="from_data_table" name="bowtie2_indexes" column="1" offset="0"> | |
| 460 <filter type="param_value" column="0" value="#" compare="startswith" keep="False"/> | |
| 461 <filter type="param_value" ref="reference_genome.index" column="0"/> | |
| 462 </option> | |
| 463 </action> | |
| 464 </when> | |
| 465 <when value="history"> | |
| 466 <action type="metadata" name="dbkey"> | |
| 467 <option type="from_param" name="reference_genome.own_file" param_attribute="dbkey" /> | |
| 468 </action> | |
| 469 </when> | |
| 470 </conditional> | |
| 471 </actions> | |
| 472 </data> | |
| 3 | 473 |
| 0 | 474 </outputs> |
| 475 | |
| 476 <tests> | |
| 477 <test> | |
| 478 <!-- basic test on single paired default run --> | |
| 2 | 479 <param name="type" value="paired"/> |
| 0 | 480 <param name="selection" value="no"/> |
| 2 | 481 <param name="paired_options_selector" value="no"/> |
| 0 | 482 <param name="unaligned_file" value="false"/> |
| 2 | 483 <param name="analysis_type_selector" value="simple"/> |
| 0 | 484 <param name="source" value="history" /> |
| 2 | 485 <param name="input_1" value="bowtie2-fq1.fq" ftype="fastqsanger"/> |
| 486 <param name="input_2" value="bowtie2-fq2.fq" ftype="fastqsanger"/> | |
| 487 <param name="own_file" value="bowtie2-ref.fasta" /> | |
| 488 <output name="output" file="bowtie2-test1.bam" ftype="bam" lines_diff="2"/> | |
| 0 | 489 </test> |
|
5
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
490 <test> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
491 <!-- basic test on single paired default run --> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
492 <param name="type" value="paired"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
493 <param name="selection" value="no"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
494 <param name="paired_options_selector" value="no"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
495 <param name="unaligned_file" value="false"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
496 <param name="analysis_type_selector" value="simple"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
497 <param name="rg_selector" value="set"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
498 <param name="ID" value="rg1"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
499 <param name="PL" value="CAPILLARY"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
500 <param name="source" value="history" /> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
501 <param name="input_1" value="bowtie2-fq1.fq" ftype="fastqsanger"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
502 <param name="input_2" value="bowtie2-fq2.fq" ftype="fastqsanger"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
503 <param name="own_file" value="bowtie2-ref.fasta" /> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
504 <output name="output" file="bowtie2-test2.bam" ftype="bam" lines_diff="2"/> |
|
42bb952b4e3c
planemo upload for repository https://github.com/galaxyproject/tools-devteam/tree/master/tools/bowtie2 commit d0e3412c58bd3bdc1a483a1e2f7f9c2aa5c87a1f-dirty
devteam
parents:
4
diff
changeset
|
505 </test> |
| 0 | 506 </tests> |
| 507 | |
| 508 <help> | |
| 2 | 509 |
| 0 | 510 **Bowtie2 Overview** |
| 511 | |
| 2 | 512 Bowtie2_ is an ultrafast and memory-efficient tool for aligning sequencing reads to long reference sequences. It is particularly good at aligning reads of about 50 up to 100s or 1,000s of characters to relatively long (e.g. mammalian) genomes. Bowtie 2 supports gapped, local, and paired-end alignment modes. Galaxy wrapper for Bowtie 2 outputs alignments in `BAM format`_, enabling interoperation with a large number of other tools available at this site. |
| 513 Majority of information in this page is derived from an excellent `Bowtie2 manual`_ written by Ben Langmead. | |
| 514 | |
| 515 .. _Bowtie2: http://bowtie-bio.sourceforge.net/bowtie2/ | |
| 516 .. _`Bowtie2 manual`: http://bowtie-bio.sourceforge.net/bowtie2/manual.shtml | |
| 517 .. _`BAM format`: http://samtools.github.io/hts-specs/SAMv1.pdf | |
| 518 | |
| 519 ----- | |
| 0 | 520 |
| 2 | 521 **Selecting reference genomes for Bowtie2** |
| 522 | |
| 523 Galaxy wrapper for Bowtie2 allows you select between precomputed and user-defined indices for reference genomes using **Will you select a reference genome from your history or use a built-in index?** flag. This flag has two options: | |
| 0 | 524 |
| 2 | 525 1. **Use a built-in genome index** - when selected (this is default), Galaxy provides the user with **Select reference genome index** dropdown. Genomes listed in this dropdown have been pre-indexed with bowtie2-build utility and are ready to be mapped against. |
| 526 2. **Use a genome from the history and build index** - when selected, Galaxy provides the user with **Select reference genome sequence** dropdown. This dropdown is populated by all FASTA formatted files listed in your current history. If your genome of interest is uploaded into history it will be shown there. Selecting a genome from this dropdown will cause Galaxy to first transparently index it using bowtie2-build command, and then run mapping with bowtie2. | |
| 527 | |
| 528 If your genome of interest is not listed here you have two choices: | |
| 529 | |
| 530 1. Contact galaxy team using **Help->Support** link at the top of the interface and let us know that an index needs to be added | |
| 531 2. Upload your genome of interest as a FASTA file to Galaxy history and selected **Use a genome from the history and build index** option. | |
| 0 | 532 |
| 533 ------ | |
| 534 | |
| 2 | 535 .. class:: infomark |
| 536 | |
| 537 **Bowtie2 options** | |
| 538 | |
| 539 Galaxy wrapper for Bowtie2 implements most but not all options available through the command line. Supported options are described below. | |
| 540 | |
| 541 ----- | |
| 542 | |
| 0 | 543 **Inputs** |
| 544 | |
| 545 Bowtie 2 accepts files in Sanger FASTQ format (single or pair-end). Use the FASTQ Groomer to prepare your files. | |
| 546 | |
| 547 ------ | |
| 548 | |
| 2 | 549 **Input options**:: |
| 550 | |
| 551 -s/--skip <int> | |
| 552 Skip (i.e. do not align) the first `<int>` reads or pairs in the input. | |
| 553 | |
| 554 -u/--qupto <int> | |
| 555 Align the first `<int>` reads or read pairs from the input (after the | |
| 556 `-s`/`--skip` reads or pairs have been skipped), then stop. Default: no limit. | |
| 557 | |
| 558 -5/--trim5 <int> | |
| 559 Trim `<int>` bases from 5' (left) end of each read before alignment (default: 0). | |
| 0 | 560 |
| 2 | 561 -3/--trim3 <int> |
| 562 Trim `<int>` bases from 3' (right) end of each read before alignment (default: 0). | |
| 563 | |
| 564 --phred33 | |
| 565 Input qualities are ASCII chars equal to the Phred quality plus 33. This is | |
| 566 also called the "Phred+33" encoding, which is used by the very latest Illumina | |
| 567 pipelines. | |
| 568 | |
| 569 --phred64 | |
| 3 | 570 Input qualities are ASCII chars equal to the Phred quality plus 64. This is |
| 2 | 571 also called the "Phred+64" encoding. |
| 0 | 572 |
| 2 | 573 --solexa-quals |
| 574 Convert input qualities from Solexa Phred quality (which can be negative) to | |
| 575 Phred Phred quality (which can't). This scheme was used in older Illumina GA | |
| 576 Pipeline versions (prior to 1.3). Default: off. | |
| 577 | |
| 578 --int-quals | |
| 579 Quality values are represented in the read input file as space-separated ASCII integers, e.g., `40 40 30 40`..., rather than ASCII characters, e.g., `II?I`.... | |
| 3 | 580 Integers are treated as being on the Phred quality scale unless |
| 2 | 581 `--solexa-quals` is also specified. Default: off. |
| 582 | |
| 583 ------ | |
| 584 | |
| 585 **Presets in `--end-to-end` mode**:: | |
| 586 | |
| 587 --very-fast | |
| 588 Same as: `-D 5 -R 1 -N 0 -L 22 -i S,0,2.50` | |
| 589 | |
| 590 --fast | |
| 591 Same as: `-D 10 -R 2 -N 0 -L 22 -i S,0,2.50` | |
| 592 | |
| 593 --sensitive | |
| 594 Same as: `-D 15 -R 2 -L 22 -i S,1,1.15` (default in `--end-to-end` mode) | |
| 595 | |
| 596 --very-sensitive | |
| 597 Same as: `-D 20 -R 3 -N 0 -L 20 -i S,1,0.50` | |
| 0 | 598 |
| 599 ------ | |
| 600 | |
| 2 | 601 **Presets options in `--local` mode**:: |
| 0 | 602 |
| 2 | 603 --very-fast-local |
| 604 Same as: `-D 5 -R 1 -N 0 -L 25 -i S,1,2.00` | |
| 0 | 605 |
| 2 | 606 --fast-local |
| 607 Same as: `-D 10 -R 2 -N 0 -L 22 -i S,1,1.75` | |
| 0 | 608 |
| 2 | 609 --sensitive-local |
| 610 Same as: `-D 15 -R 2 -N 0 -L 20 -i S,1,0.75` (default in `--local` mode) | |
| 0 | 611 |
| 2 | 612 --very-sensitive-local |
| 613 Same as: `-D 20 -R 3 -N 0 -L 20 -i S,1,0.50` | |
| 614 | |
| 0 | 615 ------ |
| 616 | |
| 2 | 617 **Alignment options**:: |
| 618 | |
| 619 -N <int> | |
| 3 | 620 Sets the number of mismatches to allowed in a seed alignment during multiseed |
| 621 alignment. Can be set to 0 or 1. Setting this higher makes alignment slower | |
| 2 | 622 (often much slower) but increases sensitivity. Default: 0. |
| 623 | |
| 624 -L <int> | |
| 3 | 625 Sets the length of the seed substrings to align during multiseed alignment. |
| 626 Smaller values make alignment slower but more sensitive. Default: the | |
| 627 `--sensitive` preset is used by default, which sets `-L` to 22 in | |
| 628 `--end-to-end` mode and to 20 in `--local` mode. | |
| 2 | 629 |
| 630 -i <func> | |
| 631 Sets a function governing the interval between seed substrings to use during | |
| 3 | 632 multiseed alignment. For instance, if the read has 30 characers, and seed |
| 2 | 633 length is 10, and the seed interval is 6, the seeds extracted will be: |
| 634 | |
| 635 Read: TAGCTACGCTCTACGCTATCATGCATAAAC | |
| 636 Seed 1 fw: TAGCTACGCT | |
| 637 Seed 1 rc: AGCGTAGCTA | |
| 638 Seed 2 fw: CGCTCTACGC | |
| 639 Seed 2 rc: GCGTAGAGCG | |
| 640 Seed 3 fw: ACGCTATCAT | |
| 641 Seed 3 rc: ATGATAGCGT | |
| 642 Seed 4 fw: TCATGCATAA | |
| 643 Seed 4 rc: TTATGCATGA | |
| 644 | |
| 645 Since it's best to use longer intervals for longer reads, this parameter sets | |
| 646 the interval as a function of the read length, rather than a single | |
| 647 one-size-fits-all number. For instance, specifying `-i S,1,2.5` sets the | |
| 648 interval function `f` to `f(x) = 1 + 2.5 * sqrt(x)`, where x is the read length. | |
| 3 | 649 If the function returns a result less than |
| 2 | 650 1, it is rounded up to 1. Default: the `--sensitive` preset is used by |
| 651 default, which sets `-i` to `S,1,1.15` in `--end-to-end` mode to `-i S,1,0.75` | |
| 652 in `--local` mode. | |
| 653 | |
| 654 --n-ceil <func> | |
| 655 Sets a function governing the maximum number of ambiguous characters (usually | |
| 656 `N`s and/or `.`s) allowed in a read as a function of read length. For instance, | |
| 657 specifying `-L,0,0.15` sets the N-ceiling function `f` to `f(x) = 0 + 0.15 * x`, | |
| 3 | 658 where x is the read length. Reads exceeding this ceiling are filtered out. |
| 659 Default: `L,0,0.15`. | |
| 2 | 660 |
| 661 --dpad <int> | |
| 662 "Pads" dynamic programming problems by `<int>` columns on either side to allow | |
| 663 gaps. Default: 15. | |
| 664 | |
| 665 --gbar <int> | |
| 666 Disallow gaps within `<int>` positions of the beginning or end of the read. | |
| 667 Default: 4. | |
| 668 | |
| 669 --ignore-quals | |
| 670 When calculating a mismatch penalty, always consider the quality value at the | |
| 671 mismatched position to be the highest possible, regardless of the actual value. | |
| 672 I.e. input is treated as though all quality values are high. This is also the | |
| 673 default behavior when the input doesn't specify quality values (e.g. in `-f`, | |
| 674 `-r`, or `-c` modes). | |
| 0 | 675 |
| 2 | 676 --nofw/--norc |
| 677 If `--nofw` is specified, `bowtie2` will not attempt to align unpaired reads to | |
| 678 the forward (Watson) reference strand. If `--norc` is specified, `bowtie2` will | |
| 679 not attempt to align unpaired reads against the reverse-complement (Crick) | |
| 680 reference strand. In paired-end mode, `--nofw` and `--norc` pertain to the | |
| 681 fragments; i.e. specifying `--nofw` causes `bowtie2` to explore only those | |
| 682 paired-end configurations corresponding to fragments from the reverse-complement | |
| 683 (Crick) strand. Default: both strands enabled. | |
| 684 | |
| 685 --no-1mm-upfront | |
| 686 By default, Bowtie 2 will attempt to find either an exact or a 1-mismatch | |
| 3 | 687 end-to-end alignment for the read *before* trying the multiseed heuristic. Such |
| 2 | 688 alignments can be found very quickly, and many short read alignments have exact or |
| 689 near-exact end-to-end alignments. However, this can lead to unexpected | |
| 3 | 690 alignments when the user also sets options governing the multiseed heuristic, |
| 2 | 691 like `-L` and `-N`. For instance, if the user specifies `-N 0` and `-L` equal |
| 692 to the length of the read, the user will be surprised to find 1-mismatch alignments | |
| 693 reported. This option prevents Bowtie 2 from searching for 1-mismatch end-to-end | |
| 3 | 694 alignments before using the multiseed heuristic, which leads to the expected |
| 2 | 695 behavior when combined with options such as `-L` and `-N`. This comes at the |
| 696 expense of speed. | |
| 697 | |
| 698 --end-to-end | |
| 699 In this mode, Bowtie 2 requires that the entire read align from one end to the | |
| 700 other, without any trimming (or "soft clipping") of characters from either end. | |
| 701 The match bonus `--ma` always equals 0 in this mode, so all alignment scores | |
| 702 are less than or equal to 0, and the greatest possible alignment score is 0. | |
| 703 This is mutually exclusive with `--local`. `--end-to-end` is the default mode. | |
| 0 | 704 |
| 2 | 705 --local |
| 706 In this mode, Bowtie 2 does not require that the entire read align from one end | |
| 707 to the other. Rather, some characters may be omitted ("soft clipped") from the | |
| 708 ends in order to achieve the greatest possible alignment score. The match bonus | |
| 709 `--ma` is used in this mode, and the best possible alignment score is equal to | |
| 710 the match bonus (`--ma`) times the length of the read. Specifying `--local` | |
| 711 and one of the presets (e.g. `--local --very-fast`) is equivalent to specifying | |
| 712 the local version of the preset (`--very-fast-local`). This is mutually | |
| 713 exclusive with `--end-to-end`. `--end-to-end` is the default mode. | |
| 714 | |
| 715 ----- | |
| 716 | |
| 717 **Scoring options**:: | |
| 718 | |
| 719 --ma <int> | |
| 720 Sets the match bonus. In `--local` mode `<int>` is added to the alignment | |
| 721 score for each position where a read character aligns to a reference character | |
| 722 and the characters match. Not used in `--end-to-end` mode. Default: 2. | |
| 723 | |
| 724 --mp MX,MN | |
| 725 Sets the maximum (`MX`) and minimum (`MN`) mismatch penalties, both integers. A | |
| 726 number less than or equal to `MX` and greater than or equal to `MN` is | |
| 727 subtracted from the alignment score for each position where a read character | |
| 728 aligns to a reference character, the characters do not match, and neither is an | |
| 729 `N`. If `--ignore-quals` is specified, the number subtracted quals `MX`. | |
| 730 Otherwise, the number subtracted is `MN + floor( (MX-MN)(MIN(Q, 40.0)/40.0) )` | |
| 731 where Q is the Phred quality value. Default: `MX` = 6, `MN` = 2. | |
| 732 | |
| 733 --np <int> | |
| 734 Sets penalty for positions where the read, reference, or both, contain an | |
| 735 ambiguous character such as `N`. Default: 1. | |
| 736 | |
| 737 --rdg <int1>,<int2> | |
| 738 Sets the read gap open (`<int1>`) and extend (`<int2>`) penalties. A read gap of | |
| 739 length N gets a penalty of `<int1>` + N * `<int2>`. Default: 5, 3. | |
| 740 | |
| 741 --rfg <int1>,<int2> | |
| 742 Sets the reference gap open (`<int1>`) and extend (`<int2>`) penalties. A | |
| 743 reference gap of length N gets a penalty of `<int1>` + N * `<int2>`. Default: | |
| 744 5, 3. | |
| 0 | 745 |
| 2 | 746 --score-min <func> |
| 747 Sets a function governing the minimum alignment score needed for an alignment to | |
| 748 be considered "valid" (i.e. good enough to report). This is a function of read | |
| 749 length. For instance, specifying `L,0,-0.6` sets the minimum-score function `f` | |
| 3 | 750 to `f(x) = 0 + -0.6 * x`, where `x` is the read length. The default in `--end-to-end` mode is `L,-0.6,-0.6` and |
| 2 | 751 the default in `--local` mode is `G,20,8`. |
| 752 | |
| 753 ----- | |
| 754 | |
| 755 **Reporting options**:: | |
| 756 | |
| 757 -k <int> | |
| 758 By default, `bowtie2` searches for distinct, valid alignments for each read. | |
| 759 When it finds a valid alignment, it continues looking for alignments that are | |
| 760 nearly as good or better. The best alignment found is reported (randomly | |
| 761 selected from among best if tied). Information about the best alignments is | |
| 762 used to estimate mapping quality and to set SAM optional fields, such as | |
| 763 `AS:i` and `XS:i`. | |
| 764 | |
| 765 When `-k` is specified, however, `bowtie2` behaves differently. Instead, it | |
| 766 searches for at most `<int>` distinct, valid alignments for each read. The | |
| 767 search terminates when it can't find more distinct valid alignments, or when it | |
| 768 finds `<int>`, whichever happens first. All alignments found are reported in | |
| 769 descending order by alignment score. The alignment score for a paired-end | |
| 770 alignment equals the sum of the alignment scores of the individual mates. Each | |
| 771 reported read or pair alignment beyond the first has the SAM 'secondary' bit | |
| 772 (which equals 256) set in its FLAGS field. For reads that have more than | |
| 773 `<int>` distinct, valid alignments, `bowtie2` does not guarantee that the | |
| 774 `<int>` alignments reported are the best possible in terms of alignment score. | |
| 775 `-k` is mutually exclusive with `-a`. | |
| 0 | 776 |
| 2 | 777 Note: Bowtie 2 is not designed with large values for `-k` in mind, and when |
| 778 aligning reads to long, repetitive genomes large `-k` can be very, very slow. | |
| 779 | |
| 780 -a | |
| 781 Like `-k` but with no upper limit on number of alignments to search for. `-a` | |
| 782 is mutually exclusive with `-k`. | |
| 783 | |
| 784 Note: Bowtie 2 is not designed with `-a` mode in mind, and when | |
| 785 aligning reads to long, repetitive genomes this mode can be very, very slow. | |
| 786 | |
| 787 ----- | |
| 788 | |
| 789 **Effort options**:: | |
| 790 | |
| 791 -D <int> | |
| 792 Up to `<int>` consecutive seed extension attempts can "fail" before Bowtie 2 | |
| 793 moves on, using the alignments found so far. A seed extension "fails" if it | |
| 794 does not yield a new best or a new second-best alignment. This limit is | |
| 795 automatically adjusted up when -k or -a are specified. Default: 15. | |
| 796 | |
| 797 -R <int> | |
| 798 `<int>` is the maximum number of times Bowtie 2 will "re-seed" reads with | |
| 799 repetitive seeds. When "re-seeding," Bowtie 2 simply chooses a new set of reads | |
| 800 (same length, same number of mismatches allowed) at different offsets and | |
| 801 searches for more alignments. A read is considered to have repetitive seeds if | |
| 802 the total number of seed hits divided by the number of seeds that aligned at | |
| 803 least once is greater than 300. Default: 2. | |
| 804 | |
| 805 ----- | |
| 806 | |
| 807 **Paired-end options**:: | |
| 0 | 808 |
| 2 | 809 -I/--minins <int> |
| 810 The minimum fragment length for valid paired-end alignments. E.g. if `-I 60` is | |
| 811 specified and a paired-end alignment consists of two 20-bp alignments in the | |
| 812 appropriate orientation with a 20-bp gap between them, that alignment is | |
| 813 considered valid (as long as `-X` is also satisfied). A 19-bp gap would not | |
| 814 be valid in that case. If trimming options `-3` or `-5` are also used, the | |
| 815 `-I` constraint is applied with respect to the untrimmed mates. | |
| 816 | |
| 817 The larger the difference between `-I` and `-X`, the slower Bowtie 2 will | |
| 818 run. This is because larger differences bewteen `-I` and `-X` require that | |
| 819 Bowtie 2 scan a larger window to determine if a concordant alignment exists. | |
| 820 For typical fragment length ranges (200 to 400 nucleotides), Bowtie 2 is very | |
| 821 efficient. | |
| 822 | |
| 823 Default: 0 (essentially imposing no minimum) | |
| 824 | |
| 825 -X/--maxins <int> | |
| 826 The maximum fragment length for valid paired-end alignments. E.g. if `-X 100` | |
| 827 is specified and a paired-end alignment consists of two 20-bp alignments in the | |
| 828 proper orientation with a 60-bp gap between them, that alignment is considered | |
| 829 valid (as long as `-I` is also satisfied). A 61-bp gap would not be valid in | |
| 830 that case. If trimming options `-3` or `-5` are also used, the `-X` | |
| 831 constraint is applied with respect to the untrimmed mates, not the trimmed | |
| 832 mates. | |
| 833 | |
| 834 The larger the difference between `-I` and `-X`, the slower Bowtie 2 will | |
| 835 run. This is because larger differences bewteen `-I` and `-X` require that | |
| 836 Bowtie 2 scan a larger window to determine if a concordant alignment exists. | |
| 837 For typical fragment length ranges (200 to 400 nucleotides), Bowtie 2 is very | |
| 838 efficient. | |
| 839 | |
| 840 Default: 500. | |
| 0 | 841 |
| 2 | 842 --fr/--rf/--ff |
| 843 The upstream/downstream mate orientations for a valid paired-end alignment | |
| 844 against the forward reference strand. E.g., if `--fr` is specified and there is | |
| 845 a candidate paired-end alignment where mate 1 appears upstream of the reverse | |
| 846 complement of mate 2 and the fragment length constraints (`-I` and `-X`) are | |
| 847 met, that alignment is valid. Also, if mate 2 appears upstream of the reverse | |
| 848 complement of mate 1 and all other constraints are met, that too is valid. | |
| 849 `--rf` likewise requires that an upstream mate1 be reverse-complemented and a | |
| 850 downstream mate2 be forward-oriented. ` --ff` requires both an upstream mate 1 | |
| 851 and a downstream mate 2 to be forward-oriented. Default: `--fr` (appropriate | |
| 852 for Illumina's Paired-end Sequencing Assay). | |
| 853 | |
| 854 --no-mixed | |
| 855 By default, when `bowtie2` cannot find a concordant or discordant alignment for | |
| 856 a pair, it then tries to find alignments for the individual mates. This option | |
| 857 disables that behavior. | |
| 0 | 858 |
| 2 | 859 --no-discordant |
| 860 By default, `bowtie2` looks for discordant alignments if it cannot find any | |
| 861 concordant alignments. A discordant alignment is an alignment where both mates | |
| 862 align uniquely, but that does not satisfy the paired-end constraints | |
| 863 (`--fr`/`--rf`/`--ff`, `-I`, `-X`). This option disables that behavior. | |
| 864 | |
| 865 --dovetail | |
| 866 If the mates "dovetail", that is if one mate alignment extends past the | |
| 867 beginning of the other such that the wrong mate begins upstream, consider that | |
| 3 | 868 to be concordant. Default: mates cannot dovetail in a concordant alignment. |
| 2 | 869 |
| 870 --no-contain | |
| 871 If one mate alignment contains the other, consider that to be non-concordant. | |
| 3 | 872 Default: a mate can contain the other in a concordant alignment. |
| 2 | 873 |
| 874 --no-overlap | |
| 875 If one mate alignment overlaps the other at all, consider that to be | |
| 3 | 876 non-concordant. Default: mates can overlap in a concordant alignment. |
| 2 | 877 |
| 0 | 878 ------ |
| 879 | |
| 2 | 880 **SAM options**:: |
| 0 | 881 |
| 2 | 882 --rg-id <text> |
| 883 Set the read group ID to `<text>`. This causes the SAM `@RG` header line to be | |
| 884 printed, with `<text>` as the value associated with the `ID:` tag. It also | |
| 885 causes the `RG:Z:` extra field to be attached to each SAM output record, with | |
| 886 value set to `<text>`. | |
| 0 | 887 |
| 2 | 888 --rg <text> |
| 889 Add `<text>` (usually of the form `TAG:VAL`, e.g. `SM:Pool1`) as a field on the | |
| 890 `@RG` header line. Note: in order for the `@RG` line to appear, `--rg-id` | |
| 3 | 891 must also be specified. This is because the `ID` tag is required by the SAM |
| 892 Specification. Specify `--rg` multiple times to set multiple fields. See the | |
| 893 SAM Specification for details about what fields are legal. | |
| 0 | 894 |
| 2 | 895 --omit-sec-seq |
| 896 When printing secondary alignments, Bowtie 2 by default will write out the `SEQ` | |
| 897 and `QUAL` strings. Specifying this option causes Bowtie 2 to print an asterix | |
| 898 in those fields instead. | |
| 899 | |
| 900 ----- | |
| 0 | 901 |
| 2 | 902 **Other options**:: |
| 0 | 903 |
| 2 | 904 --reorder |
| 905 Guarantees that output SAM records are printed in an order corresponding to the | |
| 906 order of the reads in the original input file, even when `-p` is set greater | |
| 907 than 1. Specifying `--reorder` and setting `-p` greater than 1 causes Bowtie | |
| 908 2 to run somewhat slower and use somewhat more memory then if `--reorder` were | |
| 909 not specified. Has no effect if `-p` is set to 1, since output order will | |
| 910 naturally correspond to input order in that case. | |
| 0 | 911 |
| 2 | 912 --seed <int> |
| 913 Use `<int>` as the seed for pseudo-random number generator. Default: 0. | |
| 0 | 914 |
| 2 | 915 --non-deterministic |
| 916 Normally, Bowtie 2 re-initializes its pseudo-random generator for each read. It | |
| 917 seeds the generator with a number derived from (a) the read name, (b) the | |
| 918 nucleotide sequence, (c) the quality sequence, (d) the value of the `--seed` | |
| 919 option. This means that if two reads are identical (same name, same | |
| 920 nucleotides, same qualities) Bowtie 2 will find and report the same alignment(s) | |
| 921 for both, even if there was ambiguity. When `--non-deterministic` is specified, | |
| 922 Bowtie 2 re-initializes its pseudo-random generator for each read using the | |
| 923 current time. This means that Bowtie 2 will not necessarily report the same | |
| 924 alignment for two identical reads. This is counter-intuitive for some users, | |
| 925 but might be more appropriate in situations where the input consists of many | |
| 926 identical reads. | |
| 0 | 927 |
| 928 </help> | |
| 2 | 929 <citations> |
| 930 <citation type="doi">10.1186/gb-2009-10-3-r25</citation> | |
| 931 <citation type="doi">10.1038/nmeth.1923</citation> | |
| 932 </citations> | |
| 0 | 933 </tool> |