|
8
|
1 <tool id="phyml" name="PhyML" version="3.1">
|
|
|
2 <description>Phylogeny software based on the maximum-likelihood</description>
|
|
|
3 <requirements>
|
|
|
4 <requirement type="package" version="3.1">phyml</requirement>
|
|
|
5 </requirements>
|
|
|
6 <version_command>
|
|
|
7 <![CDATA[ phyml --version ]]>
|
|
|
8 </version_command>
|
|
|
9 <stdio>
|
|
|
10 <regex match="*"
|
|
|
11 source="stdrr"
|
|
|
12 level="fatal"/>
|
|
|
13 </stdio>
|
|
12
|
14 <command>
|
|
|
15 <![CDATA[
|
|
8
|
16 ##PhyML outputs are based on input path and we need to create outputs in working_dir.
|
|
10
|
17 ln -sf $input '${input.name}';
|
|
12
|
18 #if ($usetree.inputTree == "true"):
|
|
|
19 ln -sf ${$usetree.userInputTree} ${$usetree.userInputTree.name};
|
|
|
20 #end if
|
|
|
21
|
|
10
|
22 phyml --input '${input.name}'
|
|
8
|
23 ${phylip_format}
|
|
|
24 --datatype ${seq.type_of_seq}
|
|
|
25 --multiple ${nb_data_set}
|
|
|
26
|
|
|
27 #if (str($support_condition.branchSupport) in ['0','-1','-2','-4','-5']):
|
|
|
28 --bootstrap ${support_condition.branchSupport}
|
|
|
29 #else:
|
|
|
30 --bootstrap ${support_condition.branchSupport.replicate}
|
|
|
31 #end if
|
|
|
32
|
|
|
33 #if ($seq.type_of_seq == "nt"):
|
|
|
34 -t ${seq.tstv}
|
|
|
35 #end if
|
|
|
36
|
|
|
37 --model ${seq.model}
|
|
|
38 -f ${equi_freq}
|
|
|
39 --pinv ${prop_invar}
|
|
|
40
|
|
|
41 --nclasses ${nbSubstCat}
|
|
|
42
|
|
|
43 #if (str($nbSubstCat) != "1"):
|
|
|
44 --alpha ${gamma}
|
|
|
45 #end if
|
|
|
46
|
|
|
47 --search ${move}
|
|
|
48 -o ${optimisationTopology}
|
|
|
49
|
|
|
50 #if ($usetree.inputTree == "true"):
|
|
12
|
51 --inputtree ${$usetree.userInputTree.name}
|
|
8
|
52 #end if
|
|
|
53
|
|
|
54 #if ($numStartSeed != "0"):
|
|
|
55 --r_seed ${numStartSeed}
|
|
|
56 #end if
|
|
|
57
|
|
12
|
58 --no_memory_check > ${output_stdout};
|
|
8
|
59 grep 'failed' ${output_stdout} >&2;
|
|
12
|
60 ]]>
|
|
8
|
61 </command>
|
|
|
62 <inputs>
|
|
|
63 <param name="input" type="data" format="phylip, phy" label="Alignment file" help="phylip format"/>
|
|
|
64 <param name="phylip_format" type="select" label="Changes interleaved format" display="radio">
|
|
|
65 <option value="">Interleaved</option>
|
|
|
66 <option value="--sequential">Sequential</option>
|
|
|
67 </param>
|
|
|
68 <param name="nb_data_set" type="integer" min="1" value="1" label="Number of data sets" />
|
|
|
69 <conditional name="seq">
|
|
|
70 <param name="type_of_seq" type="select" label="Data type" display="radio">
|
|
|
71 <option value="nt">Nucleic acids</option>
|
|
|
72 <option value="aa">Amino acids</option>
|
|
|
73 </param>
|
|
|
74 <when value="nt">
|
|
|
75 <param name="tstv" type="text" value="e" label="Transition/transversion ratio" help="Must be a positive integer, 'e' if you want PhyML to estimate it" />
|
|
|
76 <param name="model" type="select" label="Substitution model">
|
|
|
77 <option value="HKY85">HKY85</option>
|
|
|
78 <option value="JC69">JC69</option>
|
|
|
79 <option value="K80">K80</option>
|
|
|
80 <option value="F81">F81</option>
|
|
|
81 <option value="F84">F84</option>
|
|
|
82 <option value="TN93">TN93</option>
|
|
|
83 <option value="GTR">GTR</option>
|
|
|
84 </param>
|
|
|
85 </when>
|
|
|
86 <when value="aa">
|
|
|
87 <param name="model" type="select" label="Evolution model">
|
|
|
88 <option value="LG">LG</option>
|
|
|
89 <option value="WAG">WAG</option>
|
|
|
90 <option value="JTT">JTT</option>
|
|
|
91 <option value="MtREV">MtREV</option>
|
|
|
92 <option value="Dayhoff">Dayhoff</option>
|
|
|
93 <option value="DCMut">DCMut</option>
|
|
|
94 <option value="RtREV">RtREV</option>
|
|
|
95 <option value="CpREV">CpREV</option>
|
|
|
96 <option value="VT">VT</option>
|
|
|
97 <option value="Blosum62">Blosum62</option>
|
|
|
98 <option value="MtMam">MtMam</option>
|
|
|
99 <option value="MtArt">MtArt</option>
|
|
|
100 <option value="HIVw">HIVw</option>
|
|
|
101 <option value="HIVb">HIVb</option>
|
|
|
102 </param>
|
|
|
103 </when>
|
|
|
104 </conditional>
|
|
|
105 <param name="prop_invar" type="text" value="e" label="Proportion of invariant sites" help="Can be a fixed value in the [0,1] range or 'e' to get the maximum likelihood estimate, 0 to ignore this parameter"/>
|
|
|
106 <param name="equi_freq" type="select" label="Equilibrium frequencies" help="Empirical: frequencies are estimated by counting the occurences in the alignment. ML/Model: frequencies are estimated using ML for nucleotides or defined by the proteic substitution model.">
|
|
|
107 <option value="m">ML/Model</option>
|
|
|
108 <option value="e">Empirical</option>
|
|
|
109 </param>
|
|
|
110 <param name="nbSubstCat" type="integer" min="1" value="4" label="Number of categories for the discrete gamma model" help="1 means no gamma model" />
|
|
|
111 <param name="gamma" type="text" value="e" label="Parameter of the gamma model" help="'e' if you want PhyML to estimate it"/>
|
|
|
112 <param name="move" type="select" label="Tree topology search" display="radio">
|
|
|
113 <option value="NNI">NNI (Nearest Neighbor Interchange)</option>
|
|
|
114 <option value="SPR">SPR (Subtree Pruning and Regraphing)</option>
|
|
|
115 <option value="BEST">Best of NNI and SPR</option>
|
|
|
116 </param>
|
|
|
117 <param name="optimisationTopology" type="select" label="Optimise topology">
|
|
|
118 <option value="tlr">Tree topology, Branch length, Rate parameter</option>
|
|
|
119 <option value="tl">Tree topology, Branch length</option>
|
|
|
120 <option value="l">Branch length</option>
|
|
|
121 <option value="r">Rate parameter</option>
|
|
|
122 <option value="n">No parameter is optimized</option>
|
|
|
123 </param>
|
|
|
124 <conditional name="support_condition">
|
|
|
125 <param name="branchSupport" type="select" label="Statistical tests for branch support" help="Use aLRT or aBayes to save computing time">
|
|
|
126 <option value="0">No bootstrap</option>
|
|
|
127 <option value="1">Bootstrap</option>
|
|
|
128 <option value="-1">likelihood aLRT statistics</option>
|
|
|
129 <option value="-2">likelihood Chi2-based</option>
|
|
|
130 <option value="-4" selected='true'>SH-like</option>
|
|
|
131 <option value="-5">Approximate Bayes branch supports</option>
|
|
|
132 </param>
|
|
|
133 <when value="0"/>
|
|
|
134 <when value="-1"/>
|
|
|
135 <when value="-2"/>
|
|
|
136 <when value="-4"/>
|
|
|
137 <when value="-5"/>
|
|
|
138 <when value="1">
|
|
|
139 <param name="replicate" type="integer" min="1" value="100" label="Number of bootstrap replicates" help="Must be a positive integer" />
|
|
|
140 </when>
|
|
|
141 </conditional>
|
|
|
142 <param name="numStartSeed" type="integer" value="0" label="Number of seed used to initiate the random number generator" help="0 to random seed"/>
|
|
|
143 <conditional name="usetree">
|
|
|
144 <param name="inputTree" type="boolean" truevalue="true" falsevalue="false" checked="False" label="Use input tree guide" />
|
|
|
145 <when value="true">
|
|
|
146 <param name="userInputTree" type="data" label="Tree file" help="newick format"/>
|
|
|
147 </when>
|
|
|
148 <when value="false"/>
|
|
|
149 </conditional>
|
|
|
150 </inputs>
|
|
|
151 <outputs>
|
|
11
|
152 <data name="output_tree" format="txt" label="PhyML Newick tree: ${input.name}.nwk" from_work_dir="*_phyml_tree.txt" />
|
|
|
153 <data name="output_stats" format="txt" label="PhyML Statistic: ${input.name}.stats.txt" from_work_dir="*_phyml_stats.txt"/>
|
|
|
154 <data name="output_stdout" format="txt" label="PhyML Stdout: ${input.name}"/>
|
|
8
|
155 </outputs>
|
|
|
156 <tests>
|
|
|
157 <test>
|
|
|
158 <param name="input" value="phylip" />
|
|
|
159 <param name="prop_invar" value="0"/>
|
|
|
160 <param name="type_of_seq" value="nt" />
|
|
|
161 <param name="numStartSeed" value="1458308600" />
|
|
|
162 <output name="output_tree" file="phylip_phyml_tree.txt" />
|
|
|
163 <output name="output_stats" file="phylip_phyml_stats.txt" lines_diff="4"/>
|
|
|
164 </test>
|
|
|
165 </tests>
|
|
|
166 <help>
|
|
|
167 <![CDATA[
|
|
|
168 .. class:: infomark
|
|
|
169
|
|
|
170 **PhyML version 3.1, 2013**
|
|
|
171
|
|
|
172 -----
|
|
|
173
|
|
|
174 #########
|
|
|
175 PhyML 3.1
|
|
|
176 #########
|
|
|
177
|
|
|
178 A simple, fast, and accurate algorithm to estimate
|
|
|
179 large phylogenies by maximum likelihood''
|
|
|
180
|
|
|
181 ==========
|
|
|
182 Overview:
|
|
|
183 ==========
|
|
|
184
|
|
|
185 PhyML is a phylogeny software based on the maximum-likelihood principle. Early PhyML versions used a fast algorithm to perform Nearest Neighbor Interchanges (NNIs), in order to improve a reasonable starting tree topology. Since the original publication (Guindon and Gascuel 2003), PhyML has been widely used due to its simplicity and a fair accuracy/speed compromise. In the mean time research around PhyML has continued.
|
|
|
186
|
|
|
187 We designed an efficient algorithm to search the tree space using Subtree Pruning and Regrafting (SPR) topological moves (Hordijk and Gascuel 2005), and proposed a fast branch test based on an approximate likelihood ratio test (Anisimova and Gascuel 2006). However, these novelties were not included in the official version of PhyML, and we found that improvements were still needed in order to make them effective in some practical cases. PhyML 3.0 achieves this task.
|
|
|
188
|
|
|
189 It implements new algorithms to search the space of tree topologies with user-defined intensity. A non-parametric, Shimodaira-Hasegawa-like branch test is also available. The program provides a number of new evolutionary models and its interface was entirely re-designed. We tested PhyML 3.0 on a large collection of real data sets to ensure that the new version is stable, ready-to-use and still reasonably fast and accurate.
|
|
|
190
|
|
|
191 -----
|
|
|
192
|
|
|
193
|
|
|
194 For further informations, please visite the PhyML_ website.
|
|
|
195
|
|
|
196 .. _PhyML: http://www.atgc-montpellier.fr/phyml/
|
|
|
197
|
|
|
198 Please cite this paper if you use this software in your publications.
|
|
|
199
|
|
|
200
|
|
|
201 -----
|
|
|
202
|
|
|
203 OPTIONS
|
|
|
204 =======
|
|
|
205
|
|
|
206
|
|
|
207 -i, --input seq_file_name
|
|
|
208 seq_file_name is the name of the nucleotide or amino-acid sequence file in PHYLIP format.
|
|
|
209
|
|
|
210 -d, --datatype data_type
|
|
|
211 data_type is 'nt' for nucleotide (default), 'aa' for amino-acid sequences, or 'generic',
|
|
|
212 (use NEXUS file format and the 'symbols' parameter here).
|
|
|
213
|
|
|
214 -q, --sequential
|
|
|
215 Changes interleaved format (default) to sequential format.
|
|
|
216
|
|
|
217
|
|
|
218 -n, --multiple nb_data_sets
|
|
|
219 nb_data_sets is an integer corresponding to the number of data sets to analyse.
|
|
|
220
|
|
|
221 -p, --pars
|
|
|
222 Use a minimum parsimony starting tree. This option is taken into account when the '-u' option
|
|
|
223 is absent and when tree topology modifications are to be done.
|
|
|
224
|
|
|
225 -b, --bootstrap int
|
|
|
226
|
|
|
227 - *int > 0*: int is the number of bootstrap replicates.
|
|
|
228 - *int = 0*: neither approximate likelihood ratio test nor bootstrap values are computed.
|
|
|
229 - *int = -1*: approximate likelihood ratio test returning aLRT statistics.
|
|
|
230 - *int = -2*: approximate likelihood ratio test returning Chi2-based parametric branch supports.
|
|
|
231 - *int = -4*: (default) SH-like branch supports alone.
|
|
|
232 - *int = -5*: approximate Bayes branch supports.
|
|
|
233 -m, --model model
|
|
|
234 model : substitution model name.
|
|
|
235
|
|
|
236 - Nucleotide-based models : HKY85 (default) | JC69 | K80 | F81 | F84 | TN93 | GTR | custom(*)
|
|
|
237
|
|
|
238 (*) : *for the custom option, a string of six digits identifies the model. For instance, 00000 corresponds to F81, JC69 provided the distribution of nucleotide frequencies is uniform). 012345 corresponds to GTR. This option can be used for encoding any model that is a nested within GTR.*
|
|
|
239
|
|
|
240 * Amino-acid based models : LG (default) | WAG | JTT | MtREV | Dayhoff | DCMut | RtREV | CpREV | VT
|
|
|
241 Blosum62 | MtMam | MtArt | HIVw | HIVb | custom(**)
|
|
|
242
|
|
|
243 (**) **--aa_rate_file** *filename* file that provides the amino acid substitution rate matrix in PAML format.
|
|
|
244 It is compulsory to use this option when analysing amino acid sequences with the "custom" model.
|
|
|
245
|
|
|
246 -f frequency
|
|
|
247 - *"e"*: the character frequencies are determined as follows :
|
|
|
248 - Nucleotide sequences: (Empirical) the equilibrium base frequencies are estimated by counting the occurence of the different bases in the alignment.
|
|
|
249 - Amino-acid sequences: (Empirical) the equilibrium amino-acid frequencies are estimated by counting the occurence of the different amino-acids in the alignment.
|
|
|
250 - *"m"* : the character frequencies are determined as follows :
|
|
|
251 - Nucleotide sequences: (ML) the equilibrium base frequencies are estimated using maximum likelihood
|
|
|
252 - Amino-acid sequences: (Model) the equilibrium amino-acid frequencies are estimated using the frequencies defined by the substitution model.
|
|
|
253 - *"fA,fC,fG,fT"*: only valid for nucleotide-based models. fA, fC, fG and fT are floating numbers that correspond to the frequencies of A, C, G and T respectively *(WARNING: do not use any blank space between your values of nucleotide frequencies, only commas!)*.
|
|
|
254
|
|
|
255 -t ts_tv_ratio
|
|
|
256 ts_tv_ratio : transition/transversion ratio. DNA sequences only.
|
|
|
257 Can be a fixed positive value (ex:4.0) or e to get the maximum likelihood estimate.
|
|
|
258
|
|
|
259 -v, --pinv prop_invar
|
|
|
260 prop_invar : proportion of invariable sites.
|
|
|
261 Can be a fixed value in the [0,1] range or e to get the maximum likelihood estimate.
|
|
|
262
|
|
|
263 -c, --nclasses nb_subst_cat
|
|
|
264 nb_subst_cat : number of relative substitution rate categories. Default : nb_subst_cat=4.
|
|
|
265 Must be a positive integer.
|
|
|
266
|
|
|
267 -a, --alpha gamma
|
|
|
268 gamma : distribution of the gamma distribution shape parameter.
|
|
|
269 Can be a fixed positive value or e to get the maximum likelihood estimate.
|
|
|
270
|
|
|
271 -s, --search move
|
|
|
272 Tree topology search operation option.
|
|
|
273 Can be either NNI (default, fast) or SPR (a bit slower than NNI) or BEST (best of NNI and SPR search).
|
|
|
274
|
|
|
275 -u, --inputtree user_tree_file
|
|
|
276 user_tree_file : starting tree filename. The tree must be in Newick format.
|
|
|
277
|
|
|
278 -o params
|
|
|
279 This option focuses on specific parameter optimisation.
|
|
|
280
|
|
|
281 - *tlr* : tree topology (t), branch length (l) and rate parameters (r) are optimised.
|
|
|
282 - *tl* : tree topology and branch length are optimised.
|
|
|
283 - *r* : branch length and rate parameters are optimised.
|
|
|
284 - *l* : branch length are optimised.
|
|
|
285 - *r* : rate parameters are optimised.
|
|
|
286 - *n* : no parameter is optimised.
|
|
|
287 --rand_start This option sets the initial tree to random.
|
|
|
288 It is only valid if SPR searches are to be performed.
|
|
|
289 --n_rand_starts integer
|
|
|
290 Number of initial random trees to be used.
|
|
|
291 It is only valid if SPR searches are to be performed.
|
|
|
292 --r_seed integer
|
|
|
293 Number of the seed used to initiate the random number generator.
|
|
|
294 --print_site_lnl
|
|
|
295 Print the likelihood for each site in file *\*_phyml_lk.txt*
|
|
|
296 --print_trace
|
|
|
297 Print each phylogeny explored during the tree search process in file *\*_phyml_trace.txt*.
|
|
|
298 --run_id ID_string
|
|
|
299 Append the string ID_string at the end of each PhyML output file.
|
|
|
300 This option may be useful when running simulations involving PhyML.
|
|
|
301 --quiet
|
|
|
302 No interactive question (for running in batch mode) and quiet output.
|
|
|
303 --no_memory_check
|
|
|
304 No interactive question for memory usage (for running in batch mode). Normal ouput otherwise.
|
|
|
305 --alias_subpatt
|
|
|
306 Site aliasing is generalized at the subtree level. Sometimes lead to faster calculations.
|
|
|
307 See Kosakovsky Pond SL, Muse SV, Sytematic Biology (2004) for an example.
|
|
|
308 --boot_progress_display num (default=20)
|
|
|
309 num is the frequency at which the bootstrap progress bar will be updated.
|
|
|
310 Must be an integer.
|
|
|
311 ]]>
|
|
|
312 </help>
|
|
|
313 <citations>
|
|
|
314 <citation type="doi">10.1093/sysbio/syq010</citation>
|
|
|
315 </citations>
|
|
|
316 </tool>
|
