JMODELTEST

NAME

jmodeltest - HPC selection of models of nucleotide substitution

SYNOPSIS

jmodeltest -d sequenceFileName [-getPhylip] [-ckp checkpointFileName.ckp] [-n executionName] [-t fixed|BIONJ|ML] [-u userTreeFileName] [-o outputFileName] [-S NNI|SPR|BEST] [-AIC] [-AICc] [-BIC] [-DT] [-c confidenceInterval] [-s 3|5|7|11|203] [-f] [-i] [-g numberOfCategories] [-uLNL] [-dLRT] [-h confidenceInterval] [-hLRT] [-O {ftvwxgp}] [-a] [-z] [-p] [-v] [-w] [-tr numberOfThreads] [-machinesfile machinesFileName]

DESCRIPTION

jModelTest is a tool to carry out statistical selection of best-fit models of nucleotide substitution. It implements five different model selection strategies: hierarchical and dynamical likelihood ratio tests (hLRT and dLRT), Akaike and Bayesian information criteria (AIC and BIC), and a decision theory method (DT). It also provides estimates of model selection uncertainty, parameter importances and model-averaged parameter estimates, including model-averaged tree topologies. jModelTest 2 includes High Performance Computing (HPC) capabilities and additional features like new strategies for tree optimization, model- averaged phylogenetic trees (both topology and branch length), heuristic filtering and automatic logging of user activity.

OPTIONS

-a

estimate model-averaged phylogeny for each active criterion (e.g., -a) (default is false)

-AIC

calculate the Akaike Information Criterion (e.g., -AIC) (default is false)

-AICc

calculate the corrected Akaike Information Criterion (e.g., -AICc) (default is false)

-BIC

calculate the Bayesian Information Criterion (e.g., -BIC) (default is false)

-DT

calculate the decision theory criterion (e.g., -DT) (default is false)

-c confidenceInterval

confidence interval (e.g., -c 90) (default is 100)

-ckp checkpointFileName

Loads a checkpointing file

-d sequenceFileName

input data file (e.g., -d data.phy)

-dLRT

do dynamical likelihood ratio tests (e.g., -dLRT)(default is false)

-f

include models with unequals base frecuencies (e.g., -f) (default is false)

-g numberOfCategories

include models with rate variation among sites and number of categories (e.g., -g 8) (default is false & 4 categories)

-G threshold

heuristic search. Requires a threshold > 0 (e.g., -G 0.1)

-getPhylip

converts the input file into phylip format

-h confidenceInterval

confidence level for the hLRTs (e.g., -a0.002) (default is 0.01)

-H informationCriterion

information criterion for clustering search (AIC, AICc, BIC). (default is BIC) this argument applies only for 203 substitution schemes (e.g., -s 203 -H AIC)

-help

displays this help message

-hLRT

do hierarchical likelihood ratio tests (default is false) hypothesis testing order can be specified with -O argument

-i

include models with a proportion invariable sites (e.g., -i) (default is false)

-machinesfile manchinesFileName

gets the processors per host from a machines file

-n executionName

execution name for appending to the log filenames (default: current time yyyyMMddhhmmss)

-o outputFileName

set output file (e.g., -o jmodeltest.out)

-O hypothesisOrder

hypothesis order for the hLRTs (e.g., -hLRT -O gpftv) (default is ftvwxgp)

f=freq, t=titvi, v=2ti4tv(subst=3)/2ti(subst>3), w=2tv, x=4tv, g=gamma, p=pinv this argument is used only if -hLRT argument is set ’f’,’t’,’v’,’g’,’p’ are mandatory in any order. ’w’ is optional, and ’x’ requires ’w’ to be present thus, length should be 5, 6 *including ’w’) or 7 (including both ’w’ and ’x’) e.g., -hLRT -O gpfvwxt

-p

calculate parameter importances (e.g., -p) (default is false)

-r

backward selection for the hLRT (e.g., -r) (default is forward)

-s numberOfSubstitutionSchemes

number of substitution schemes (e.g., -s 11) (it has to be 3,5,7,11,203; default is 3)

--set-local-config localConfigurationFile

set a local configuration file in replacement of conf/jmodeltest.conf

--set-property propertyName=propertyValue

set a new value for a property contained in the configuration file (conf/jmodeltest.conf)

-S NNI|SPR|BEST

tree topology search operation option (NNI (fast), SPR (a bit slower), BEST (best of NNI and SPR)) (default is BEST)

-t fixed|BIONJ|ML

base tree for likelihood calculations (e.g., -t BIONJ)

fixed (common BIONJ-JC topology)

BIONJ (Neighbor-Joining topology)

ML (Maximum Likelihood topology) (default)

-tr numberOfThreads

number of threads to execute (default is 4)

-u treeFileName

user tree for likelihood calculations

(e.g., -u data.tre)

-uLnL

calculate delta AIC,AICc,BIC against unconstrained likelihood (e.g., -uLnL)

(default is false if the input alignment has gaps or ambiguous characters)

-v

do model averaging and parameter importances (e.g., -v) (default is false)

-w

write PAUP block (e.g., -w) (default is false)

-z

strict consensus type for model-averaged phylogeny (e.g., -z) (default is majority rule)

EXAMPLE

jmodeltest -d sequenceFileName -i -f -g 4 -BIC -AIC -AICc -DT -v -a -w

AUTHOR

This manpage was written by Andreas Tille for the Debian distribution and can be used for any other usage of the program.