|
0
|
1 <tool id="iqtree" name="IQ-TREE" version="@TOOL_VERSION@" >
|
|
|
2 <description>Phylogenetic tree construction from multiple sequences and analyses via maximum likelihood</description>
|
|
|
3 <macros>
|
|
|
4 <import>iqtree_macros.xml</import>
|
|
|
5 </macros>
|
|
|
6 <expand macro="requirements" />
|
|
|
7 <command detect_errors='exit_code' ><![CDATA[
|
|
|
8 iqtree
|
|
|
9 -pre PREF
|
|
|
10 -nt \${GALAXY_SLOTS:-10}
|
|
|
11 -redo
|
|
|
12
|
|
|
13 ## file
|
|
|
14 #if $general_options.s
|
|
|
15 -s '$general_options.s'
|
|
|
16 #end if
|
|
|
17
|
|
|
18 ## file
|
|
|
19 #if $general_options.t
|
|
|
20 -t '$general_options.t'
|
|
|
21 $tree_parameters.constructing_consensus.con
|
|
|
22 $tree_parameters.constructing_consensus.net
|
|
|
23 #if str($tree_parameters.constructing_consensus.bi) != ''
|
|
|
24 -bi '$tree_parameters.constructing_consensus.bi'
|
|
|
25 #end if
|
|
|
26
|
|
|
27 ## file
|
|
|
28 #if $tree_parameters.constructing_consensus.sup
|
|
|
29 -sup '$tree_parameters.constructing_consensus.sup'
|
|
|
30 #end if
|
|
|
31
|
|
|
32 #if str($tree_parameters.constructing_consensus.suptag) != ''
|
|
|
33 -suptag '$tree_parameters.constructing_consensus.suptag'
|
|
|
34 #end if
|
|
|
35
|
|
|
36 ## file
|
|
|
37 #if $tree_parameters.computing_robinson_foulds.rf
|
|
|
38 -rf '$tree_parameters.computing_robinson_foulds.rf'
|
|
|
39 $tree_parameters.computing_robinson_foulds.rf_all
|
|
|
40 $tree_parameters.computing_robinson_foulds.rf_adj
|
|
|
41 #end if
|
|
|
42 #end if
|
|
|
43
|
|
|
44 ## file
|
|
|
45 #if $general_options.te
|
|
|
46 -te '$general_options.te'
|
|
|
47 #end if
|
|
|
48
|
|
|
49 #if str($general_options.st) != ''
|
|
|
50 -st '$general_options.st'
|
|
|
51 #end if
|
|
|
52
|
|
|
53 #if str($general_options.seed) != ''
|
|
|
54 -seed '$general_options.seed'
|
|
|
55 #end if
|
|
|
56
|
|
|
57 $general_options.keep_ident
|
|
|
58 $general_options.safe
|
|
|
59
|
|
|
60 #if str($likelihood_mapping.lmap) != ''
|
|
|
61 -lmap '$likelihood_mapping.lmap'
|
|
|
62 #end if
|
|
|
63
|
|
|
64 ## file
|
|
|
65 #if $likelihood_mapping.lmclust
|
|
|
66 -lmclust '$likelihood_mapping.lmclust'
|
|
|
67 #end if
|
|
|
68
|
|
|
69 $likelihood_mapping.wql
|
|
|
70
|
|
|
71 #if str($modelling_parameters.automatic_model.cond_model.m) != ''
|
|
|
72 -m '$modelling_parameters.automatic_model.cond_model.m'
|
|
|
73 #end if
|
|
|
74
|
|
|
75 #if str($modelling_parameters.automatic_model.rcluster) != ''
|
|
|
76 -rcluster '$modelling_parameters.automatic_model.rcluster'
|
|
|
77 #end if
|
|
|
78
|
|
|
79 #if str($modelling_parameters.automatic_model.mset) != ''
|
|
|
80 -mset '$modelling_parameters.automatic_model.mset'
|
|
|
81 #end if
|
|
|
82
|
|
|
83 #if str($modelling_parameters.automatic_model.msub) != ''
|
|
|
84 -msub '$modelling_parameters.automatic_model.msub'
|
|
|
85 #end if
|
|
|
86
|
|
|
87 #if str($modelling_parameters.automatic_model.mfreq) != ''
|
|
|
88 -mfreq '$modelling_parameters.automatic_model.mfreq'
|
|
|
89 #end if
|
|
|
90
|
|
|
91 #if str($modelling_parameters.automatic_model.mrate) != ''
|
|
|
92 -mrate '$modelling_parameters.automatic_model.mrate'
|
|
|
93 #end if
|
|
|
94
|
|
|
95 #if str($modelling_parameters.automatic_model.cmin) != ''
|
|
|
96 -cmin '$modelling_parameters.automatic_model.cmin'
|
|
|
97 #end if
|
|
|
98
|
|
|
99 #if str($modelling_parameters.automatic_model.cmax) != ''
|
|
|
100 -cmax '$modelling_parameters.automatic_model.cmax'
|
|
|
101 #end if
|
|
|
102
|
|
|
103 #if str($modelling_parameters.automatic_model.merit) != ''
|
|
|
104 -merit '$modelling_parameters.automatic_model.merit'
|
|
|
105 #end if
|
|
|
106
|
|
|
107 $modelling_parameters.automatic_model.mtree
|
|
|
108
|
|
|
109 #if str($modelling_parameters.automatic_model.madd) != ''
|
|
|
110 -madd '$modelling_parameters.automatic_model.madd'
|
|
|
111 #end if
|
|
|
112
|
|
|
113 ## file
|
|
|
114 #if $modelling_parameters.automatic_model.mdef
|
|
|
115 -mdef '$modelling_parameters.automatic_model.mdef'
|
|
|
116 #end if
|
|
|
117
|
|
|
118 $modelling_parameters.specifying_substitution.mwopt
|
|
|
119
|
|
|
120 #if str($modelling_parameters.rate_heterogeneity.a) != ''
|
|
|
121 -a '$modelling_parameters.rate_heterogeneity.a'
|
|
|
122 #end if
|
|
|
123
|
|
|
124 $modelling_parameters.rate_heterogeneity.gmedian
|
|
|
125
|
|
|
126 #if str($modelling_parameters.rate_heterogeneity.i) != ''
|
|
|
127 -i '$modelling_parameters.rate_heterogeneity.i'
|
|
|
128 #end if
|
|
|
129
|
|
|
130 $modelling_parameters.rate_heterogeneity.opt_gamma_inv
|
|
|
131 $modelling_parameters.rate_heterogeneity.wsr
|
|
|
132
|
|
|
133 ## file
|
|
|
134 #if $modelling_parameters.partition_model.q
|
|
|
135 -q '$modelling_parameters.partition_model.q'
|
|
|
136 #end if
|
|
|
137
|
|
|
138 $modelling_parameters.partition_model.spp
|
|
|
139
|
|
|
140 ## file
|
|
|
141 #if $modelling_parameters.partition_model.sp
|
|
|
142 -sp '$modelling_parameters.partition_model.sp'
|
|
|
143 #end if
|
|
|
144
|
|
|
145 ## file
|
|
|
146 #if $modelling_parameters.site_specific_frequency.ft
|
|
|
147 -ft '$modelling_parameters.site_specific_frequency.ft'
|
|
|
148 #end if
|
|
|
149
|
|
|
150 #if str($modelling_parameters.site_specific_frequency.fs) != ''
|
|
|
151 -fs '$modelling_parameters.site_specific_frequency.fs'
|
|
|
152 #end if
|
|
|
153
|
|
|
154 $modelling_parameters.site_specific_frequency.fmax
|
|
|
155
|
|
|
156 #if str($tree_parameters.tree_search.ninit) != ''
|
|
|
157 -ninit '$tree_parameters.tree_search.ninit'
|
|
|
158 #end if
|
|
|
159
|
|
|
160 #if str($tree_parameters.tree_search.ntop) != ''
|
|
|
161 -ntop '$tree_parameters.tree_search.ntop'
|
|
|
162 #end if
|
|
|
163
|
|
|
164 #if str($tree_parameters.tree_search.nbest) != ''
|
|
|
165 -nbest '$tree_parameters.tree_search.nbest'
|
|
|
166 #end if
|
|
|
167
|
|
|
168 #if str($tree_parameters.tree_search.nstop) != ''
|
|
|
169 -nstop '$tree_parameters.tree_search.nstop'
|
|
|
170 #end if
|
|
|
171
|
|
|
172 #if str($tree_parameters.tree_search.n) != ''
|
|
|
173 -n '$tree_parameters.tree_search.n'
|
|
|
174 #end if
|
|
|
175
|
|
|
176 #if str($tree_parameters.tree_search.sprrad) != ''
|
|
|
177 -sprrad '$tree_parameters.tree_search.sprrad'
|
|
|
178 #end if
|
|
|
179
|
|
|
180 #if str($tree_parameters.tree_search.pers) != ''
|
|
|
181 -pers '$tree_parameters.tree_search.pers'
|
|
|
182 #end if
|
|
|
183
|
|
|
184 $tree_parameters.tree_search.allnni
|
|
|
185 $tree_parameters.tree_search.djc
|
|
|
186
|
|
|
187 ## file
|
|
|
188 #if $tree_parameters.tree_search.g
|
|
|
189 -g '$tree_parameters.tree_search.g'
|
|
|
190 #end if
|
|
|
191
|
|
|
192 #if str($tree_parameters.single_branch.alrt) != ''
|
|
|
193 -alrt '$tree_parameters.single_branch.alrt'
|
|
|
194 #end if
|
|
|
195
|
|
|
196 $tree_parameters.single_branch.abayes
|
|
|
197
|
|
|
198 #if str($tree_parameters.single_branch.lbp) != ''
|
|
|
199 -lbp '$tree_parameters.single_branch.lbp'
|
|
|
200 #end if
|
|
|
201
|
|
|
202 ## file
|
|
|
203 #if $tree_parameters.tree_topology.z
|
|
|
204 -z '$tree_parameters.tree_topology.z'
|
|
|
205 #end if
|
|
|
206
|
|
|
207 #if str($tree_parameters.tree_topology.zb) != ''
|
|
|
208 -zb '$tree_parameters.tree_topology.zb'
|
|
|
209 #end if
|
|
|
210
|
|
|
211 $tree_parameters.tree_topology.zw
|
|
|
212 $tree_parameters.tree_topology.au
|
|
|
213
|
|
|
214 #if str($tree_parameters.constructing_consensus.minsup) != ''
|
|
|
215 -minsup '$tree_parameters.constructing_consensus.minsup'
|
|
|
216 #end if
|
|
|
217
|
|
|
218
|
|
|
219 #if str($tree_parameters.generating_random.r) != ''
|
|
|
220 -r '$tree_parameters.generating_random.r'
|
|
|
221 #end if
|
|
|
222
|
|
|
223 $tree_parameters.generating_random.ru
|
|
|
224 $tree_parameters.generating_random.rcat
|
|
|
225 $tree_parameters.generating_random.rbal
|
|
|
226 $tree_parameters.generating_random.rcsg
|
|
|
227
|
|
|
228 #if str($tree_parameters.generating_random.rlen) != ''
|
|
|
229 -rlen '$tree_parameters.generating_random.rlen'
|
|
|
230 #end if
|
|
|
231
|
|
|
232 #if str($bootstrap_parameters.ultrafast_bootstrap.bb) != ''
|
|
|
233 -bb '$bootstrap_parameters.ultrafast_bootstrap.bb'
|
|
|
234 #end if
|
|
|
235
|
|
|
236 $bootstrap_parameters.ultrafast_bootstrap.wbt
|
|
|
237 $bootstrap_parameters.ultrafast_bootstrap.wbtl
|
|
|
238
|
|
|
239 #if str($bootstrap_parameters.ultrafast_bootstrap.nm) != ''
|
|
|
240 -nm '$bootstrap_parameters.ultrafast_bootstrap.nm'
|
|
|
241 #end if
|
|
|
242
|
|
|
243 #if str($bootstrap_parameters.ultrafast_bootstrap.bcor) != ''
|
|
|
244 -bcor '$bootstrap_parameters.ultrafast_bootstrap.bcor'
|
|
|
245 #end if
|
|
|
246
|
|
|
247 #if str($bootstrap_parameters.ultrafast_bootstrap.nstep) != ''
|
|
|
248 -nstep '$bootstrap_parameters.ultrafast_bootstrap.nstep'
|
|
|
249 #end if
|
|
|
250
|
|
|
251 #if str($bootstrap_parameters.ultrafast_bootstrap.beps) != ''
|
|
|
252 -beps '$bootstrap_parameters.ultrafast_bootstrap.beps'
|
|
|
253 #end if
|
|
|
254
|
|
|
255 #if str($bootstrap_parameters.ultrafast_bootstrap.bspec) != ''
|
|
|
256 -bspec '$bootstrap_parameters.ultrafast_bootstrap.bspec'
|
|
|
257 #end if
|
|
|
258
|
|
|
259 $bootstrap_parameters.ultrafast_bootstrap.bnni
|
|
|
260
|
|
|
261 #if str($bootstrap_parameters.nonparametric_bootstrap.b) != ''
|
|
|
262 -b '$bootstrap_parameters.nonparametric_bootstrap.b'
|
|
|
263 #end if
|
|
|
264
|
|
|
265 $bootstrap_parameters.nonparametric_bootstrap.bc
|
|
|
266 $bootstrap_parameters.nonparametric_bootstrap.bo
|
|
|
267
|
|
|
268 #if str($miscellaneous_options.fconst) != ''
|
|
|
269 -fconst '$miscellaneous_options.fconst'
|
|
|
270 #end if
|
|
|
271
|
|
|
272 ]]>
|
|
|
273 </command>
|
|
|
274 <inputs>
|
|
|
275 <section name="general_options" expanded="True" title="General options">
|
|
|
276 <param argument="-s" type="data" format="txt" optional="true" label="Specify input alignment file in PHYLIP, FASTA, NEXUS, CLUSTAL or MSF format."/>
|
|
|
277 <param argument="-st" type="select" label="Specify sequence type as either of DNA, AA, BIN, MORPH, CODON or NT2AA for DNA, amino-acid, binary, morphological, codon or DNA-to-AA-translated sequences">
|
|
|
278 <help><![CDATA[
|
|
|
279 Note that -st CODON is always necessary when using codon models and you also need to specify a genetic code like this if differed from the standard genetic code.
|
|
|
280 <br/><i>-st</i> NT2AA tells IQ-TREE to translate protein-coding DNA into AA sequences and then subsequent analysis will work on the AA sequences. You can also use a genetic code like -st NT2AA5 for the Invertebrate Mitochondrial Code (see genetic code table).]]>
|
|
|
281 </help>
|
|
|
282 <option value="DNA">DNA</option>
|
|
|
283 <option value="AA">AA</option>
|
|
|
284 <option value="BIN">BIN</option>
|
|
|
285 <option value="MORPH">MORPH</option>
|
|
|
286 <option value="CODON">CODON</option>
|
|
|
287 <option value="NT2AA">NT2AA</option>
|
|
|
288 </param>
|
|
|
289 <param argument="-t" type="data" format="nhx" optional="true" label="Specify a file containing starting tree for tree search"/>
|
|
|
290 <param argument="-te" type="data" format="nhx" optional="true" label="Like -t but fixing user tree" help="That means, no tree search is performed and IQ-TREE computes the log-likelihood of the fixed user tree."/>
|
|
|
291 <param argument="-seed" type="integer" optional="true" label="Specify a random number seed to reproduce a previous run (leave blank to randomize)"/>
|
|
|
292 <param argument="-keep_ident" type="boolean" truevalue="-keep-ident" falsevalue="" checked="false" label="Keep identical sequences in the alignment" help="By default: IQ-TREE will remove them during the analysis and add them in the end."/>
|
|
|
293 <param argument="-safe" type="boolean" truevalue="-safe" falsevalue="" checked="false" label="Turn on safe numerical mode to avoid numerical underflow for large data sets with many sequences (typically in the order of thousands)" help="This mode is automatically turned on when having more than 2000 sequences."/>
|
|
|
294 </section>
|
|
|
295 <section name="likelihood_mapping" expanded="False" title="Likelihood mapping analysis">
|
|
|
296 <param argument="-lmap" type="integer" optional="true" label="Specify the number of quartets to be randomly drawn" help="If you specify -lmap ALL, all unique quartets will be drawn, instead."/>
|
|
|
297 <param argument="-lmclust" type="data" format="txt" optional="true" label="Specify a NEXUS file containing taxon clusters (see below for example) for quartet mapping analysis."/>
|
|
|
298 <param argument="-wql" type="boolean" truevalue="-wql" falsevalue="" checked="false" label="Write quartet log-likelihoods into .lmap.quartetlh file (typically not needed)."/>
|
|
|
299 </section>
|
|
|
300 <section name="modelling_parameters" title="Modelling Parameters">
|
|
|
301 <section name="automatic_model" expanded="False" title="Automatic model selection">
|
|
|
302 <conditional name="cond_model" >
|
|
|
303 <param name="opt_custommodel" type="boolean" checked="false" label="Use Custom Model" help="See http://www.iqtree.org/doc/Substitution-Models"/>
|
|
|
304 <when value="true">
|
|
|
305 <param argument="-m" type="text" label="Model">
|
|
|
306 <sanitizer>
|
|
|
307 <valid initial="string.ascii_uppercase,+" />
|
|
|
308 </sanitizer>
|
|
|
309 </param>
|
|
|
310 </when>
|
|
|
311 <when value="false">
|
|
|
312 <param argument="-m" type="select" label="Perform standard model selection like jModelTest (for DNA) and ProtTest (for protein)" >
|
|
|
313 <help><![CDATA[
|
|
|
314 <b>Note:</b> Only <code>TEST</code> and custom models that do not rely on <code>MF</code> can be used in conjunction with bootstrap parameters (-b)<br/><br/>
|
|
|
315 IQ-TREE also works for codon, binary and morphogical data.
|
|
|
316 <table>
|
|
|
317 <tr>
|
|
|
318 <td><i>TESTONLY</i></td>
|
|
|
319 <td>Perform standard model selection like jModelTest (for DNA) and ProtTest (for protein). Moreover, IQ-TREE also works for codon, binary and morphogical data.</td>
|
|
|
320 </tr>
|
|
|
321 <tr>
|
|
|
322 <td><i>TEST</i></td>
|
|
|
323 <td>Like -m TESTONLY but immediately followed by tree reconstruction using the best-fit model found. So this performs both model selection and tree inference within a single run.</td>
|
|
|
324 </tr>
|
|
|
325 <tr>
|
|
|
326 <td><i>TESTNEWONLY</i></td>
|
|
|
327 <td>Perform an extended model selection that additionally includes FreeRate model compared with -m TESTONLY. Recommended as replacement for -m TESTONLY. Note that LG4X is a FreeRate model, but by default is not included because it is also a protein mixture model. To include it, use -madd option (see table below).</td>
|
|
|
328 </tr>
|
|
|
329 <tr>
|
|
|
330 <td><i>TESTNEW</i></td>
|
|
|
331 <td>Like -m MF but immediately followed by tree reconstruction using the best-fit model found.</td>
|
|
|
332 </tr>
|
|
|
333 <tr>
|
|
|
334 <td><i>TESTMERGEONLY</i></td>
|
|
|
335 <td>Select best-fit partitioning scheme like PartitionFinder.</td>
|
|
|
336 </tr>
|
|
|
337 <tr>
|
|
|
338 <td><i>TESTMERGE</i></td>
|
|
|
339 <td>Like -m TESTMERGEONLY but immediately followed by tree reconstruction using the best partitioning scheme found.</td>
|
|
|
340 </tr>
|
|
|
341 <tr>
|
|
|
342 <td><i>TESTNEWMERGEONLY</i></td>
|
|
|
343 <td>Like -m TESTMERGEONLY but additionally includes FreeRate model.</td>
|
|
|
344 </tr>
|
|
|
345 <tr>
|
|
|
346 <td><i>TESTNEWMERGE</i></td>
|
|
|
347 <td>Like -m MF+MERGE but immediately followed by tree reconstruction using the best partitioning scheme found.</td>
|
|
|
348 </tr>
|
|
|
349 </table>
|
|
|
350 ]]>
|
|
|
351 </help>
|
|
|
352 <option value="" selected="true">(None)</option>
|
|
|
353 <option value="TESTONLY">TESTONLY</option>
|
|
|
354 <option value="TEST">TEST</option>
|
|
|
355 <option value="TESTNEWONLY">TESTNEWONLY</option>
|
|
|
356 <option value="TESTNEW">TESTNEW</option>
|
|
|
357 <option value="TESTMERGEONLY">TESTMERGEONLY</option>
|
|
|
358 <option value="TESTMERGE">TESTMERGE</option>
|
|
|
359 <option value="TESTNEWMERGEONLY">TESTNEWMERGEONLY</option>
|
|
|
360 <option value="TESTNEWMERGE">TESTNEWMERGE</option>
|
|
|
361 </param>
|
|
|
362 </when>
|
|
|
363 </conditional>
|
|
|
364 <param argument="-rcluster" type="integer" optional="true" label="Specify the percentage for the relaxed clustering algorithm (Lanfear et al., 2014)" help="This is similar to --rcluster-percent option of PartitionFinder. For example, with -rcluster 10 only the top 10% partition schemes are considered to save computations." />
|
|
|
365 <param argument="-mset" type="text" optional="true" label="Specify the name of a program (raxml, phyml or mrbayes) to restrict to only those models supported by the specified program" help="Alternatively, one can specify a comma-separated list of base models. For example, -mset WAG,LG,JTT will restrict model selection to WAG, LG, and JTT instead of all 18 AA models to save computations.">
|
|
|
366 <expand macro="sanitize_query"
|
|
|
367 validinitial="string.ascii_uppercase,string.punctuation" />
|
|
|
368 </param>
|
|
|
369 <param argument="-msub" type="select" label="Specify either nuclear, mitochondrial, chloroplast or viral to restrict to those AA models designed for specified source." help="">
|
|
|
370 <option value="nuclear">nuclear</option>
|
|
|
371 <option value="mitochondrial">mitochondrial</option>
|
|
|
372 <option value="chloroplast">chloroplast</option>
|
|
|
373 <option value="viral">viral</option>
|
|
|
374 </param>
|
|
|
375 <param argument="-mfreq" type="text" optional="true" label="Specify a comma-separated list of frequency types for model selection" >
|
|
|
376 <expand macro="sanitize_query"
|
|
|
377 validinitial="string.ascii_uppercase,string.digits,x,string.punctuation" />
|
|
|
378 </param>
|
|
|
379 <param argument="-mrate" type="text" optional="true" label="Specify a comma-separated list of rate heterogeneity types for model selection">
|
|
|
380 <expand macro="sanitize_query"
|
|
|
381 validinitial="string.ascii_uppercase,string.punctuation" />
|
|
|
382 </param>
|
|
|
383 <param argument="-cmin" type="integer" value="2" optional="true" label="Specify minimum number of categories for FreeRate model"/>
|
|
|
384 <param argument="-cmax" type="integer" value="10" optional="true" label="Specify maximum number of categories for FreeRate model"/>
|
|
|
385 <param argument="-merit" type="select" label="Specify either AIC, AICc or BIC for the optimality criterion to apply for new procedure" help="">
|
|
|
386 <option value="AIC">AIC</option>
|
|
|
387 <option value="AICc">AICc</option>
|
|
|
388 <option value="BIC">BIC</option>
|
|
|
389 </param>
|
|
|
390 <param argument="-mtree" type="boolean" truevalue="-mtree" falsevalue="" checked="false" label="Turn on full tree search for each model considered, to obtain more accurate result"/>
|
|
|
391 <param argument="-madd" type="text" optional="true" label="Specify a comma-separated list of mixture models to additionally consider for model selection" help="For example, -madd LG4M,LG4X to additionally include these two protein mixture models.">
|
|
|
392 <expand macro="sanitize_query"
|
|
|
393 validinitial="string.ascii_uppercase,string.digits,string.punctuation" />
|
|
|
394 </param>
|
|
|
395 <param argument="-mdef" type="data" format="txt" optional="true" label="Specify a NEXUS model file to define new models."/>
|
|
|
396 </section>
|
|
|
397 <section name="specifying_substitution" expanded="False" title="Specifying substitution models">
|
|
|
398 <param argument="-mwopt" type="boolean" truevalue="-mwopt" falsevalue="" checked="false" label="Turn on optimizing weights of mixture models" help="Note that for models like LG+C20+F+G this mode is automatically turned on, but not for LG+C20+G."/>
|
|
|
399 </section>
|
|
|
400 <section name="rate_heterogeneity" expanded="False" title="Rate heterogeneity">
|
|
|
401 <param argument="-a" type="text" optional="true" label="Specify the Gamma shape parameter (default: estimate)">
|
|
|
402 <expand macro="sanitize_query" />
|
|
|
403 </param>
|
|
|
404 <param argument="-gmedian" type="boolean" truevalue="-gmedian" falsevalue="" checked="false" label="Perform the median approximation for Gamma rate heterogeneity instead of the default mean approximation (Yang, 1994)"/>
|
|
|
405 <param argument="-i" type="text" optional="true" label="Specify the proportion of invariable sites (default: estimate)">
|
|
|
406 <expand macro="sanitize_query" />
|
|
|
407 </param>
|
|
|
408 <param argument="--opt_gamma_inv" type="boolean" truevalue="--opt-gamma-inv" falsevalue="" checked="false" label="Perform more thorough estimation for +I+G model parameters"/>
|
|
|
409 <param argument="-wsr" type="boolean" truevalue="-wsr" falsevalue="" checked="false" label="Write per-site rates to .rate file"/>
|
|
|
410 </section>
|
|
|
411 <section name="partition_model" expanded="False" title="Partition model options">
|
|
|
412 <param argument="-q" type="data" format="txt" optional="true" label="Specify partition file for edge-equal partition model" help="That means, all partitions share the same set of branch lengths (like -q option of RAxML)."/>
|
|
|
413 <param argument="-spp" type="boolean" truevalue="-spp" falsevalue="" checked="false" label="Like -q but allowing partitions to have different evolutionary speeds (edge-proportional partition model)."/>
|
|
|
414 <param argument="-sp" type="data" format="txt" optional="true" label="Specify partition file for edge-unlinked partition model" help="That means, each partition has its own set of branch lengths (like -M option of RAxML). This is the most parameter-rich partition model to accomodate heterotachy."/>
|
|
|
415 </section>
|
|
|
416 <section name="site_specific_frequency" expanded="False" title="Site-specific frequency model options">
|
|
|
417 <param argument="-ft" type="data" format="nhx" optional="true" label="Specify a guide tree to infer site frequency profiles."/>
|
|
|
418 <param argument="-fs" type="float" optional="true" label="Specify a site frequency file, e.g" help="the .sitefreq file obtained from -ft run. This will save memory used for the first phase of the analysis."/>
|
|
|
419 <param argument="-fmax" type="boolean" truevalue="-fmax" falsevalue="" checked="false" label="Switch to posterior maximum mode for obtaining site-specific profiles" help="Default: posterior mean."/>
|
|
|
420 </section>
|
|
|
421 </section>
|
|
|
422 <section name="tree_parameters" title="Tree Parameters">
|
|
|
423 <section name="tree_search" expanded="False" title="Tree search parameters">
|
|
|
424 <param argument="-n" type="integer" optional="true" label="Skip subsequent tree search (n = 0), useful when you only want to assess the phylogenetic information of the alignment. Otherwise specify number of iterations to stop (this option overrides -nstop criterion)." />
|
|
|
425 <param argument="-ninit" type="integer" value="100" optional="true" label="Specify number of initial parsimony trees"/>
|
|
|
426 <param argument="-ntop" type="integer" value="20" optional="true" label="Specify number of top initial parsimony trees to optimize with ML nearest neighbor interchange (NNI) search to initialize the candidate set"/>
|
|
|
427 <param argument="-nbest" type="integer" value="5" optional="true" label="Specify number of trees in the candidate set to maintain during ML tree search"/>
|
|
|
428 <param argument="-nstop" type="integer" value="100" optional="true" label="Specify number of unsuccessful iterations to stop"/>
|
|
|
429 <param argument="-sprrad" type="integer" value="6" optional="true" label="Specify SPR radius for the initial parsimony tree search"/>
|
|
|
430 <param argument="-pers" type="float" value="0.5" optional="true" label="Specify perturbation strength (between 0 and 1) for randomized NNI"/>
|
|
|
431 <param argument="-allnni" type="boolean" truevalue="-allnni" falsevalue="" checked="false" label="Turn on more thorough and slower NNI search"/>
|
|
|
432 <param argument="-djc" type="boolean" truevalue="-djc" falsevalue="" checked="false" label="Avoid computing ML pairwise distances and BIONJ tree."/>
|
|
|
433 <param argument="-g" type="data" format="txt" optional="true" label="Specify a topological constraint tree file in NEWICK format" help="The constraint tree can be a multifurcating tree and need not to include all taxa."/>
|
|
|
434 </section>
|
|
|
435 <section name="single_branch" expanded="False" title="Single branch tests">
|
|
|
436 <param argument="-alrt" type="integer" optional="true" label="Specify number of replicates (>=1000) to perform SH-like approximate likelihood ratio test (SH-aLRT) (Guindon et al., 2010)" help="If number of replicates is set to 0 (-alrt 0), then the parametric aLRT test (Anisimova and Gascuel 2006) is performed, instead of SH-aLRT."/>
|
|
|
437 <param argument="-abayes" type="boolean" truevalue="-abayes" falsevalue="" checked="false" label="Perform approximate Bayes test (Anisimova et al., 2011)."/>
|
|
|
438 <param argument="-lbp" type="integer" optional="true" label="Specify number of replicates (>=1000) to perform fast local bootstrap probability method (Adachi and Hasegawa, 1996)."/>
|
|
|
439 </section>
|
|
|
440 <section name="tree_topology" expanded="False" title="Tree topology tests">
|
|
|
441 <param argument="-z" type="data" format="txt" optional="true" label="Specify a file containing a set of trees" help="IQ-TREE will compute the log-likelihoods of all trees."/>
|
|
|
442 <param argument="-zb" type="integer" optional="true" label="Specify the number of RELL (Kishino et al., 1990) replicates (>=1000) to perform several tree topology tests for all trees passed via -z" help="The tests include bootstrap proportion (BP), KH test (Kishino and Hasegawa, 1989), SH test (Shimodaira and Hasegawa, 1999) and expected likelihood weights (ELW) (Strimmer and Rambaut, 2002)."/>
|
|
|
443 <param argument="-zw" type="boolean" truevalue="-zw" falsevalue="" checked="false" label="Used together with -zb to additionally perform the weighted-KH and weighted-SH tests."/>
|
|
|
444 <param argument="-au" type="boolean" truevalue="-au" falsevalue="" checked="false" label="Used together with -zb to additionally perform the approximately unbiased (AU) test (Shimodaira, 2002)" help="Note that you have to specify the number of replicates for the AU test via -zb."/>
|
|
|
445 </section>
|
|
|
446 <section name="constructing_consensus" expanded="False" title="Constructing consensus tree">
|
|
|
447 <param argument="-con" type="boolean" truevalue="-con" falsevalue="" checked="false" label="Compute consensus tree of the trees passed via -t" help="Resulting consensus tree is written to .contree file."/>
|
|
|
448 <param argument="-net" type="boolean" truevalue="-net" falsevalue="" checked="false" label="Compute consensus network of the trees passed via -t" help="Resulting consensus network is written to .nex file."/>
|
|
|
449 <param argument="-minsup" type="float" value="0.0" optional="true" label="Specify a minimum threshold (between 0 and 1) to keep branches in the consensus tree"/>
|
|
|
450 <param argument="-bi" type="integer" optional="true" label="Specify a burn-in, which is the number of beginning trees passed via -t to discard before consensus construction" help="This is useful e.g. when summarizing trees from MrBayes analysis."/>
|
|
|
451 <param argument="-sup" type="data" format="nhx" optional="true" label="Specify an input “target” tree file" help="That means, support values are first extracted from the trees passed via -t, and then mapped onto the target tree. Resulting tree with assigned support values is written to .suptree file. This option is useful to map and compare support values from different approaches onto a single tree."/>
|
|
|
452 <param argument="-suptag" type="text" optional="true" label="Specify name of a node in -sup target tree" help="The corresponding node of .suptree will then be assigned with IDs of trees where this node appears. Special option -suptag ALL will assign such IDs for all nodes of the target tree."/>
|
|
|
453 </section>
|
|
|
454 <section name="computing_robinson_foulds" expanded="False" title="Computing Robinson-Foulds distance">
|
|
|
455 <param argument="-rf" type="data" format="nhx" optional="true" label="Specify a second set of trees" help="IQ-TREE computes all pairwise RF distances between two tree sets passed via -t and -rf"/>
|
|
|
456 <param argument="-rf_all" type="boolean" truevalue="-rf_all" falsevalue="" checked="false" label="Compute all-to-all RF distances between all trees passed via -t"/>
|
|
|
457 <param argument="-rf_adj" type="boolean" truevalue="-rf_adj" falsevalue="" checked="false" label="Compute RF distances between adjacent trees passed via -t"/>
|
|
|
458 </section>
|
|
|
459 <section name="generating_random" expanded="False" title="Generating random trees">
|
|
|
460 <param argument="-r" type="integer" optional="true" label="Specify number of taxa" help="IQ-TREE will create a random tree under Yule-Harding model with specified number of taxa"/>
|
|
|
461 <param argument="-ru" type="boolean" truevalue="-ru" falsevalue="" checked="false" label="Like -r, but a random tree is created under uniform model."/>
|
|
|
462 <param argument="-rcat" type="boolean" truevalue="-rcat" falsevalue="" checked="false" label="Like -r, but a random caterpillar tree is created."/>
|
|
|
463 <param argument="-rbal" type="boolean" truevalue="-rbal" falsevalue="" checked="false" label="Like -r, but a random balanced tree is created."/>
|
|
|
464 <param argument="-rcsg" type="boolean" truevalue="-rcsg" falsevalue="" checked="false" label="Like -r, bur a random circular split network is created."/>
|
|
|
465 <param argument="-rlen" type="text" optional="true" label="Specify three numbers: minimum, mean and maximum branch lengths of the random tree">
|
|
|
466 <sanitizer>
|
|
|
467 <valid initial="string.digits,string.whitespace" />
|
|
|
468 </sanitizer>
|
|
|
469 </param>
|
|
|
470 </section>
|
|
|
471 </section>
|
|
|
472 <section name="bootstrap_parameters" title="Bootstrap Parameters">
|
|
|
473 <section name="ultrafast_bootstrap" expanded="False" title="Ultrafast bootstrap parameters">
|
|
|
474 <param argument="-bb" type="integer" optional="true" label="Specify number of bootstrap replicates (>=1000)."/>
|
|
|
475 <param argument="-wbt" type="boolean" truevalue="-wbt" falsevalue="" checked="false" label="Turn on writing bootstrap trees to .ufboot file"/>
|
|
|
476 <param argument="-wbtl" type="boolean" truevalue="-wbtl" falsevalue="" checked="false" label="Like -wbt but bootstrap trees written with branch lengths"/>
|
|
|
477 <param argument="-nm" type="integer" value="1000" optional="true" label="Specify maximum number of iterations to stop"/>
|
|
|
478 <param argument="-bcor" type="float" value="0.99" optional="true" label="Specify minimum correlation coefficient for UFBoot convergence criterion"/>
|
|
|
479 <param argument="-nstep" type="integer" value="100" optional="true" label="Specify iteration interval checking for UFBoot convergence"/>
|
|
|
480 <param argument="-beps" type="float" value="0.5" optional="true" label="Specify a small epsilon to break tie in RELL evaluation for bootstrap trees"/>
|
|
|
481 <param argument="-bspec" type="text" optional="true" label="Specify the resampling strategies for partitioned analysis" help="By default, IQ-TREE resamples alignment sites within partitions. With -bspec GENE IQ-TREE will resample partitions. With -bspec GENESITE IQ-TREE will resample partitions and then resample sites within resampled partitions (Gadagkar et al., 2005).">
|
|
|
482 <sanitizer>
|
|
|
483 <valid initial="string.ascii_uppercase" />
|
|
|
484 </sanitizer>
|
|
|
485 </param>
|
|
|
486 <param argument="-bnni" type="boolean" truevalue="-bnni" falsevalue="" checked="false" label="Perform an additional step to further optimize UFBoot trees by nearest neighbor interchange (NNI) based directly on bootstrap alignments" help="This option is recommended in the presence of severe model violations. It increases computing time by 2-fold but reduces the risk of overestimating branch supports due to severe model violations. Introduced in IQ-TREE 1.6."/>
|
|
|
487 </section>
|
|
|
488 <section name="nonparametric_bootstrap" expanded="False" title="Nonparametric bootstrap">
|
|
|
489 <param argument="-b" type="integer" optional="true" label="Specify number of bootstrap replicates (recommended >=100)" help="This will perform both bootstrap and analysis on original alignment and provide a consensus tree."/>
|
|
|
490 <param argument="-bc" type="boolean" truevalue="-bc" falsevalue="" checked="false" label="Like -b but omit analysis on original alignment."/>
|
|
|
491 <param argument="-bo" type="boolean" truevalue="-bo" falsevalue="" checked="false" label="Like -b but only perform bootstrap analysis (no analysis on original alignment and no consensus tree)."/>
|
|
|
492 </section>
|
|
|
493 </section>
|
|
|
494 <section name="miscellaneous_options" expanded="False" title="Miscellaneous options">
|
|
|
495 <param argument="-fconst" type="text" optional="true" label="Specify a list of comma-separated integer numbers" help="The number of entries should be equal to the number of states in the model (e.g. 4 for DNA and 20 for protein). IQ-TREE will then add a number of constant sites accordingly. For example, -fconst 10,20,15,40 will add 10 constant sites of all A, 20 constant sites of all C, 15 constant sites of all G and 40 constant sites of all T into the alignment.">
|
|
|
496 <expand macro="sanitize_query"
|
|
|
497 validinitial="string.digits,string.punctuation" />
|
|
|
498 </param>
|
|
|
499 </section>
|
|
|
500 </inputs>
|
|
|
501 <outputs>
|
|
|
502 <data name='bionj' format='nhx' from_work_dir="*.bionj" label="${tool.name} on ${on_string}: BIONJ Tree" />
|
|
|
503 <data name='treefile' format='nhx' from_work_dir="*.treefile" label="${tool.name} on ${on_string}: MaxLikelihood Tree" />
|
|
|
504 <data name='contree' format='nhx' from_work_dir="*.contree" label="${tool.name} on ${on_string}: Consensus Tree" />
|
|
|
505 <data name='mldist' format='mldist' from_work_dir="*.mldist" label="${tool.name} on ${on_string}: MaxLikelihood Distance Matrix"/>
|
|
|
506 <data name='splits.nex' format='nex' from_work_dir="*.splits.nex" label="${tool.name} on ${on_string}: Occurence Frequencies in Bootstrap Trees" />
|
|
|
507 <data name='iqtree' format='iqtree' from_work_dir="*.iqtree" label="${tool.name} on ${on_string}: Report and Final Tree" />
|
|
|
508 </outputs>
|
|
|
509 <tests>
|
|
|
510 <test>
|
|
|
511 <param name="seed" value="1257" />
|
|
|
512 <param name="st" value="AA" />
|
|
|
513 <param name="s" value="example.phy" />
|
|
|
514 <param name="m" value="TESTNEW" />
|
|
|
515 <param name="msub" value="nuclear" />
|
|
|
516 <param name="madd" value="LG4M,LG4X" />
|
|
|
517 <param name="merit" value="AICc" />
|
|
|
518 <param name="bb" value="1000" />
|
|
|
519 <output name='bionj'>
|
|
|
520 <assert_contents>
|
|
|
521 <has_text_matching expression=".*Human.*Whale.*" />
|
|
|
522 </assert_contents>
|
|
|
523 </output>
|
|
|
524 <output name='iqtree'>
|
|
|
525 <assert_contents>
|
|
|
526 <has_text_matching expression="VT\+F\+R3(\s+((-|\d|\.)+))+" />
|
|
|
527 </assert_contents>
|
|
|
528 </output>
|
|
|
529 <output name='mldist'>
|
|
|
530 <assert_contents>
|
|
|
531 <has_line_matching expression="^Frog(\s+((\d|\.)+))+\s+$" />
|
|
|
532 <has_line_matching expression="^Whale(\s+((\d|\.)+))+\s+$" />
|
|
|
533 <has_line_matching expression="^Cow(\s+((\d|\.)+))+\s+$" />
|
|
|
534 </assert_contents>
|
|
|
535 </output>
|
|
|
536 <output name='treefile'>
|
|
|
537 <assert_contents>
|
|
|
538 <has_line_matching expression="\(LngfishAu:(\d|\..)+,\(LngfishSA:(\d.)+,.*" />
|
|
|
539 </assert_contents>
|
|
|
540 </output>
|
|
|
541 <output name='contree' >
|
|
|
542 <assert_contents>
|
|
|
543 <has_line_matching
|
|
|
544 expression="\(LngfishAu:(\d|\..)+,\(LngfishSA:(\d.)+,.*\)\d+:(\d|\.)+,.*" />
|
|
|
545 </assert_contents>
|
|
|
546 </output>
|
|
|
547 <output name='splits.nex'>
|
|
|
548 <assert_contents>
|
|
|
549 <has_line line="BEGIN Splits;" />
|
|
|
550 <has_line line="END; [Splits]" />
|
|
|
551 </assert_contents>
|
|
|
552 </output>
|
|
|
553 </test>
|
|
|
554 <test>
|
|
|
555 <!-- bootstrap sans model -->
|
|
|
556 <param name="seed" value="1257" />
|
|
|
557 <param name="st" value="AA" />
|
|
|
558 <param name="s" value="example.phy" />
|
|
|
559 <!-- <param name="m" value="TESTONLY" /> -->
|
|
|
560 <param name="msub" value="nuclear" />
|
|
|
561 <param name="cmin" value="2" />
|
|
|
562 <param name="cmax" value="10" />
|
|
|
563 <param name="merit" value="AICc" />
|
|
|
564 <param name="madd" value="LG4M,LG4X" />
|
|
|
565 <param name="ninit" value="100" />
|
|
|
566 <param name="ntop" value="20" />
|
|
|
567 <param name="nbest" value="5" />
|
|
|
568 <param name="nstop" value="100" />
|
|
|
569 <param name="sprrad" value="6" />
|
|
|
570 <param name="pers" value="0.5" />
|
|
|
571 <param name="minsup" value="0.0" />
|
|
|
572 <param name="nm" value="1000" />
|
|
|
573 <param name="bcor" value="0.99" />
|
|
|
574 <param name="nstep" value="100" />
|
|
|
575 <param name="beps" value="0.5" />
|
|
|
576 <param name="b" value="2" />
|
|
|
577 <output name='iqtree'>
|
|
|
578 <assert_contents>
|
|
|
579 <has_text_matching expression="VT\+F\+I(\s+((-|\d|\.)+))+" />
|
|
|
580 </assert_contents>
|
|
|
581 </output>
|
|
|
582 <output name='treefile'>
|
|
|
583 <assert_contents>
|
|
|
584 <has_line_matching expression="\(LngfishAu:(\d|\..)+,\(LngfishSA:(\d.)+,.*" />
|
|
|
585 </assert_contents>
|
|
|
586 </output>
|
|
|
587 </test>
|
|
|
588 <test>
|
|
|
589 <!-- model sans bootstrap -->
|
|
|
590 <param name="seed" value="1257" />
|
|
|
591 <param name="st" value="AA" />
|
|
|
592 <param name="s" value="example.phy" />
|
|
|
593 <param name="m" value="TESTONLY" />
|
|
|
594 <param name="msub" value="nuclear" />
|
|
|
595 <param name="cmin" value="2" />
|
|
|
596 <param name="cmax" value="10" />
|
|
|
597 <param name="merit" value="AICc" />
|
|
|
598 <param name="madd" value="LG4M,LG4X" />
|
|
|
599 <param name="ninit" value="100" />
|
|
|
600 <param name="ntop" value="20" />
|
|
|
601 <param name="nbest" value="5" />
|
|
|
602 <param name="nstop" value="100" />
|
|
|
603 <param name="sprrad" value="6" />
|
|
|
604 <param name="pers" value="0.5" />
|
|
|
605 <param name="minsup" value="0.0" />
|
|
|
606 <param name="nm" value="1000" />
|
|
|
607 <param name="bcor" value="0.99" />
|
|
|
608 <param name="nstep" value="100" />
|
|
|
609 <param name="beps" value="0.5" />
|
|
|
610 <!-- <param name="b" value="100" /> -->
|
|
|
611 <output name='iqtree'>
|
|
|
612 <assert_contents>
|
|
|
613 <has_text_matching expression="VT\+F\+I(\s+((-|\d|\.)+))+" />
|
|
|
614 </assert_contents>
|
|
|
615 </output>
|
|
|
616 <output name='treefile'>
|
|
|
617 <assert_contents>
|
|
|
618 <has_line_matching expression="\(LngfishAu:(\d|\..)+,\(LngfishSA:(\d.)+,.*" />
|
|
|
619 </assert_contents>
|
|
|
620 </output>
|
|
|
621 </test>
|
|
|
622 <test>
|
|
|
623 <param name='s' value='example.phy' />
|
|
|
624 <output name='iqtree'>
|
|
|
625 <assert_contents>
|
|
|
626 <has_text_matching expression=".*Human.*Whale.*" />
|
|
|
627 </assert_contents>
|
|
|
628 </output>
|
|
|
629 <output name='treefile'>
|
|
|
630 <assert_contents>
|
|
|
631 <has_text_matching expression="\(LngfishAu:(\d|\..)+,\(LngfishSA:(\d.)+,.*" />
|
|
|
632 </assert_contents>
|
|
|
633 </output>
|
|
|
634 </test>
|
|
|
635 </tests>
|
|
|
636 <help><![CDATA[
|
|
|
637 IQ-TREE
|
|
|
638 =======
|
|
|
639
|
|
|
640 The full documentation can be found here_.
|
|
|
641
|
|
|
642 .. _here : http://www.iqtree.org/doc/
|
|
|
643
|
|
|
644 General Tutorial
|
|
|
645 ===================
|
|
|
646
|
|
|
647 Input data
|
|
|
648 ----------
|
|
|
649
|
|
|
650 IQ-TREE takes as input a *multiple sequence alignment* and will reconstruct an evolutionary tree that is best explained by the input data. The input alignment can be in various common formats. For example the PHYLIP_ format which may look like:
|
|
|
651
|
|
|
652 .. _PHYLIP: http://evolution.genetics.washington.edu/phylip/doc/sequence.html
|
|
|
653
|
|
|
654 ::
|
|
|
655
|
|
|
656 7 28
|
|
|
657 Frog AAATTTGGTCCTGTGATTCAGCAGTGAT
|
|
|
658 Turtle CTTCCACACCCCAGGACTCAGCAGTGAT
|
|
|
659 Bird CTACCACACCCCAGGACTCAGCAGTAAT
|
|
|
660 Human CTACCACACCCCAGGAAACAGCAGTGAT
|
|
|
661 Cow CTACCACACCCCAGGAAACAGCAGTGAC
|
|
|
662 Whale CTACCACGCCCCAGGACACAGCAGTGAT
|
|
|
663 Mouse CTACCACACCCCAGGACTCAGCAGTGAT
|
|
|
664
|
|
|
665 This tiny alignment contains 7 DNA sequences from several animals with the sequence length of 28 nucleotides. IQ-TREE also supports other file formats such as FASTA, NEXUS, CLUSTALW. The FASTA file for the above example may look like this:
|
|
|
666
|
|
|
667 ::
|
|
|
668
|
|
|
669 >Frog
|
|
|
670 AAATTTGGTCCTGTGATTCAGCAGTGAT
|
|
|
671 >Turtle
|
|
|
672 CTTCCACACCCCAGGACTCAGCAGTGAT
|
|
|
673 >Bird
|
|
|
674 CTACCACACCCCAGGACTCAGCAGTAAT
|
|
|
675 >Human
|
|
|
676 CTACCACACCCCAGGAAACAGCAGTGAT
|
|
|
677 >Cow
|
|
|
678 CTACCACACCCCAGGAAACAGCAGTGAC
|
|
|
679 >Whale
|
|
|
680 CTACCACGCCCCAGGACACAGCAGTGAT
|
|
|
681 >Mouse
|
|
|
682 CTACCACACCCCAGGACTCAGCAGTGAT
|
|
|
683
|
|
|
684 **NOTE**: If you have raw sequences, you need to first apply alignment programs like MAFFT_ or ClustalW_ to align the sequences, before feeding them into IQ-TREE.
|
|
|
685
|
|
|
686 .. _MAFFT: http://mafft.cbrc.jp/alignment/software/
|
|
|
687 .. _ClustalW: http://www.clustal.org
|
|
|
688
|
|
|
689
|
|
|
690 Running example
|
|
|
691 ---------------------
|
|
|
692
|
|
|
693 From the download_ there is an example alignment called `example.phy`
|
|
|
694 in PHYLIP format. This example contains parts of the mitochondrial DNA sequences of several animals (Source: `Phylogenetic Handbook`_)
|
|
|
695
|
|
|
696 .. _`Phylogenetic Handbook` : http://www.kuleuven.be/aidslab/phylogenybook/home.html)).
|
|
|
697 .. _download: http://www.iqtree.org/#download
|
|
|
698
|
|
|
699 You can now start to reconstruct a maximum-likelihood tree
|
|
|
700 from this alignment by entering (assuming that you are now in the same folder with `example.phy`):
|
|
|
701
|
|
|
702 ::iqtree -s example.phy -st AA -seed 9999 -m TESTNEW -msub nuclear -madd LG4M,LG4x -merit AICc -bb 2000
|
|
|
703
|
|
|
704 * **-s** is the option to specify the name of the alignment file
|
|
|
705
|
|
|
706 * **-st** specifies the sequence type as amino-acid
|
|
|
707
|
|
|
708 * **-seed** ensures that the output files remain the same for subsequent runs
|
|
|
709
|
|
|
710 * **-m** sets the modelling parameter for standard model selection
|
|
|
711
|
|
|
712 * **-msub** determines the type sub-modelling
|
|
|
713
|
|
|
714 * **-madd** provides an additional selection mixed models
|
|
|
715
|
|
|
716 * **-merit** asserts the type of optimality criterion
|
|
|
717
|
|
|
718 * **-bb** defines the number of replicates
|
|
|
719
|
|
|
720
|
|
|
721 Each of these parameters are available under the relevant sub-sections in the main tool interface.
|
|
|
722
|
|
|
723 At the end of the run IQ-TREE will write several output files including:
|
|
|
724
|
|
|
725 * **example.phy.iqtree**: the main report file that is self-readable. You should look at this file to see the computational results. It also contains a textual representation of the final tree (see below).
|
|
|
726
|
|
|
727 * **example.phy.treefile**: the ML tree in NEWICK format, which can be visualized by any supported tree viewer programs like FigTree or iTOL.
|
|
|
728
|
|
|
729 **NOTE**: Starting with version 1.5.4, with this simple command IQ-TREE will by default perform ModelFinder to find the best-fit substitution model and then infer a phylogenetic tree using the selected model.
|
|
|
730
|
|
|
731 For this example data the resulting maximum-likelihood tree may look like this (extracted from **.iqtree** file):
|
|
|
732
|
|
|
733 **NOTE**: Tree is UNROOTED although outgroup taxon 'LngfishAu' is drawn at root
|
|
|
734
|
|
|
735 ::
|
|
|
736
|
|
|
737 +--------------LngfishAu
|
|
|
738 |
|
|
|
739 | +--------------LngfishSA
|
|
|
740 +--------|
|
|
|
741 | +--------------LngfishAf
|
|
|
742 |
|
|
|
743 | +-------------------Frog
|
|
|
744 +------|
|
|
|
745 | +-----------------Turtle
|
|
|
746 | +-----|
|
|
|
747 | | | +-----------------------Sphenodon
|
|
|
748 | | | +--|
|
|
|
749 | | | | +--------------------------Lizard
|
|
|
750 | | +---|
|
|
|
751 | | | +---------------------Crocodile
|
|
|
752 | | +------|
|
|
|
753 | | +------------------Bird
|
|
|
754 +---------|
|
|
|
755 | +----------------Human
|
|
|
756 | +--|
|
|
|
757 | | | +--------Seal
|
|
|
758 | | +--|
|
|
|
759 | | | +-------Cow
|
|
|
760 | | +---|
|
|
|
761 | | +---------Whale
|
|
|
762 | +----|
|
|
|
763 | | | +------Mouse
|
|
|
764 | | +---------|
|
|
|
765 | | +--------Rat
|
|
|
766 +----------|
|
|
|
767 | +----------------Platypus
|
|
|
768 +---|
|
|
|
769 +-------------Opossum
|
|
|
770
|
|
|
771
|
|
|
772 This makes sense as the mammals (**Human** to **Opossum**) form a clade, whereas the reptiles **Turtle** to **Crocodile**) and **Bird** form a separate sister clade. Here the tree is drawn at the *outgroup* Lungfish which is more accient than other species in this example. However, please note that IQ-TREE always produces an **unrooted tree** as it knows nothing about this biological background; IQ-TREE simply draws the tree this way as **LngfishAu** is the first sequence occuring in the alignment.
|
|
|
773
|
|
|
774 Choosing the right substitution model
|
|
|
775 -------------------------------------
|
|
|
776
|
|
|
777 IQ-TREE will choose the best model for you automatically if specify any of the TEST models, but valid custom models can also be specified that conform to those found in Models_ page.
|
|
|
778
|
|
|
779 .. _Models: http://www.iqtree.org/doc/Substitution-Models#binary-and-morphological-models
|
|
|
780
|
|
|
781
|
|
|
782 ------------------------------
|
|
|
783
|
|
|
784 Advanced Parameter Selection
|
|
|
785 ============================
|
|
|
786
|
|
|
787 Using codon models
|
|
|
788 ------------------
|
|
|
789
|
|
|
790 IQ-TREE supports a number of codon models. You need to input a protein-coding DNA alignment and specify codon data by option **-st CODON** (Otherwise, IQ-TREE applies DNA model because it detects that your alignment has DNA sequences):
|
|
|
791
|
|
|
792 ::
|
|
|
793
|
|
|
794 iqtree -s coding_gene.phy -st CODON
|
|
|
795
|
|
|
796 If your alignment length is not divisible by 3, IQ-TREE will stop with an error message. IQ-TREE will group sites 1,2,3 into codon site 1; sites 4,5,6 to codon site 2; etc. Moreover, any codon, which has at least one gap/unknown/ambiguous nucleotide, will be treated as unknown codon character.
|
|
|
797
|
|
|
798 Note that the above command assumes the standard genetic code. If your sequences follow 'The Invertebrate Mitochondrial Code', then run:
|
|
|
799
|
|
|
800 ::
|
|
|
801
|
|
|
802 iqtree -s coding_gene.phy -st CODON5
|
|
|
803
|
|
|
804 Note that ModelFinder works for codon alignments. IQ-TREE version >= 1.5.4 will automatically invokes ModelFinder to find the best-fit codon model.
|
|
|
805
|
|
|
806
|
|
|
807 Assessing branch supports with ultrafast bootstrap approximation
|
|
|
808 ----------------------------------------------------------------
|
|
|
809
|
|
|
810 To overcome the computational burden required by the nonparametric bootstrap, IQ-TREE introduces an ultrafast bootstrap approximation (UFBoot) ([Minh et al., 2013]) that is orders of magnitude faster than the standard procedure and provides relatively unbiased branch support values. Citation for UFBoot:
|
|
|
811
|
|
|
812 B.Q. Minh, M.A.T. Nguyen, and A. von Haeseler (2013) Ultrafast approximation for phylogenetic bootstrap. _Mol. Biol. Evol., 30:1188-1195.
|
|
|
813
|
|
|
814 ::
|
|
|
815
|
|
|
816 iqtree -s example.phy -m TIM2+I+G -bb 1000
|
|
|
817
|
|
|
818 **-bb** specifies the number of bootstrap replicates where 1000 is the minimum number recommended. The section **MAXIMUM LIKELIHOOD TREE** in **example.phy.iqtree** shows a textual representation of the maximum likelihood tree with branch support values in percentage. The NEWICK format of the tree is printed to the file **example.phy.treefile**. In addition, IQ-TREE writes the following files:
|
|
|
819
|
|
|
820 * **example.phy.contree**: the consensus tree with assigned branch supports where branch lengths are optimized on the original alignment.
|
|
|
821
|
|
|
822 * **example.phy.splits**: support values in percentage for all splits (bipartitions), computed as the occurence frequencies in the bootstrap trees. This file is in "star-dot" format.
|
|
|
823
|
|
|
824 * **example.phy.splits.nex**: has the same information as **example.phy.splits** but in NEXUS format, which can be viewed with the program SplitsTree_ to explore the conflicting signals in the data. So it is more informative than consensus tree, e.g. you can see how highly supported the second best conflicting split is, which had no chance to enter the consensus tree.
|
|
|
825
|
|
|
826 .. _SplitsTree: http://www.splitstree.org
|
|
|
827
|
|
|
828
|
|
|
829 Reducing impact of severe model violations with UFBoot
|
|
|
830 ------------------------------------------------------
|
|
|
831
|
|
|
832 Starting with IQ-TREE version 1.6 we provide a new option **-bnni** to reduce the risk of overestimating branch supports with UFBoot due to severe model violations. With this option UFBoot will further optimize each bootstrap tree using a hill-climbing nearest neighbor interchange (NNI) search based directly on the corresponding bootstrap alignment.
|
|
|
833
|
|
|
834 Thus, if severe model violations are present in the data set at hand, users are advised to append **-bnni** to the regular UFBoot command:
|
|
|
835
|
|
|
836 iqtree -s example.phy -m TIM2+I+G -bb 1000 -bnni
|
|
|
837
|
|
|
838 For more details see:
|
|
|
839
|
|
|
840 D.T. Hoang, O. Chernomor, A. von Haeseler, B.Q. Minh, L.S. Vinh (2017) UFBoot2: Improving the ultrafast bootstrap approximation.
|
|
|
841
|
|
|
842
|
|
|
843 Assessing branch supports with standard nonparametric bootstrap
|
|
|
844 ----------------------------------------------------------------
|
|
|
845
|
|
|
846 The standard nonparametric bootstrap is invoked by the **-b** option:
|
|
|
847
|
|
|
848 iqtree -s example.phy -m TIM2+I+G -b 100
|
|
|
849
|
|
|
850 **-b** specifies the number of bootstrap replicates where 100
|
|
|
851 is the minimum recommended number. The output files are similar to those produced by the UFBoot procedure.
|
|
|
852
|
|
|
853
|
|
|
854
|
|
|
855 Assessing branch supports with single branch tests
|
|
|
856 --------------------------------------------------
|
|
|
857
|
|
|
858 IQ-TREE provides an implementation of the SH-like approximate likelihood ratio test ([Guindon et al., 2010]). To perform this test, run:
|
|
|
859
|
|
|
860 ::
|
|
|
861
|
|
|
862 iqtree -s example.phy -m TIM2+I+G -alrt 1000
|
|
|
863
|
|
|
864 **-alrt** specifies the number of bootstrap replicates for SH-aLRT where 1000 is the minimum number recommended.
|
|
|
865
|
|
|
866 IQ-TREE also supports other tests such as the aBayes test (Anisimova et al., 2011) and the local bootstrap test (Adachi and Hasegawa, 1996).
|
|
|
867
|
|
|
868 You can also perform both SH-aLRT and the ultrafast bootstrap within one single run:
|
|
|
869
|
|
|
870 ::
|
|
|
871
|
|
|
872 iqtree -s example.phy -m TIM2+I+G -alrt 1000 -bb 1000
|
|
|
873
|
|
|
874 The branches of the resulting **.treefile** will be assigned with both SH-aLRT and UFBoot support values, which are readable by any tree viewer program like FigTree, Dendroscope or ETE. You can also look at the textual tree figure in **.iqtree** file:
|
|
|
875
|
|
|
876 **NOTE**: Tree is UNROOTED although outgroup taxon 'LngfishAu' is drawn at root
|
|
|
877 Numbers in parentheses are SH-aLRT support (%) / ultrafast bootstrap support (%)
|
|
|
878
|
|
|
879 ::
|
|
|
880
|
|
|
881 +-------------LngfishAu
|
|
|
882 |
|
|
|
883 | +--------------LngfishSA
|
|
|
884 +-------| (100/100)
|
|
|
885 | +------------LngfishAf
|
|
|
886 |
|
|
|
887 | +--------------------Frog
|
|
|
888 +------| (99.8/100)
|
|
|
889 | +-----------------Turtle
|
|
|
890 | +--| (85/72)
|
|
|
891 | | | +------------------------Crocodile
|
|
|
892 | | +----| (96.5/97)
|
|
|
893 | | +------------------Bird
|
|
|
894 | +--| (39/51)
|
|
|
895 | | +---------------------------Sphenodon
|
|
|
896 | +-----| (98.2/99)
|
|
|
897 | | +-------------------------------Lizard
|
|
|
898 +---------| (100/100)
|
|
|
899 | +--------------Human
|
|
|
900 | +--| (92.3/93)
|
|
|
901 | | | +------Seal
|
|
|
902 | | +--| (68.3/75)
|
|
|
903 | | | +-----Cow
|
|
|
904 | | +--| (99.7/100)
|
|
|
905 | | +-------Whale
|
|
|
906 | +----| (99.1/100)
|
|
|
907 | | | +---Mouse
|
|
|
908 | | +---------| (100/100)
|
|
|
909 | | +------Rat
|
|
|
910 +-----------| (100/100)
|
|
|
911 | +--------------Platypus
|
|
|
912 +--| (93/98)
|
|
|
913 +-----------Opossum
|
|
|
914
|
|
|
915
|
|
|
916 From this figure, the branching patterns within reptiles are poorly supported (e.g. **Sphenodon** with SH-aLRT: 39%, UFBoot: 51% and **Turtle** with SH-aLRT: 85%, UFBoot: 72%) as well as the phylogenetic position of **Seal** within mammals (SH-aLRT: 68.3%, UFBoot: 75%). Other branches appear to be well supported.
|
|
|
917 ]]></help>
|
|
|
918 <citations>
|
|
|
919 <citation type="doi">10.1093/molbev/msu300</citation>
|
|
|
920 <citation type="doi">10.1093/molbev/mst024</citation>
|
|
|
921 </citations>
|
|
|
922 </tool>
|
