Home - iqtree/iqtree3 GitHub Wiki
layout: userdoc title: "Introduction" author: AUTHOR date: DATE docid: 0 icon: info-circle doctype: tutorial tags:
- tutorial
description: ""
sections:
- name: Why IQ-TREE? url: why-iq-tree
- name: Key features url: key-features
- name: Free web server url: free-web-server
- name: User support url: user-support
- name: Documentation url: documentation
- name: How to cite IQ-TREE? url: how-to-cite-iq-tree
- name: Development team url: development-team
- name: Credits and acknowledgements url: credits-and-acknowledgements
Thanks to the recent advent of next-generation sequencing techniques, the amount of phylogenomic/transcriptomic data have been rapidly accumulated. This extremely facilitates resolving many "deep phylogenetic" questions in the tree of life. At the same time it poses major computational challenges to analyze such big data, where most phylogenetic software cannot handle. Moreover, there is a need to develop more complex probabilistic models to adequately capture realistic aspects of genomic sequence evolution.
This trends motivated us to develop the IQ-TREE software with a strong emphasis on phylogenomic inference. Our goals are:
- Accuracy: Proposing novel computational methods that perform better than existing approaches.
- Speed: Allowing fast analysis on big data sets and utilizing high performance computing platforms.
- Flexibility: Facilitating the inclusion of new (phylogenomic) models and sequence data types.
- Versatility: Implementing a broad range of commonly-used maximum likelihood analyses.
IQ-TREE has been developed since 2011 and freely available at http://www.iqtree.org/ as open-source software under the GNU-GPL license version 2. It is actively maintained by the core development team (see below) and a number of collabrators.
The name IQ-TREE comes from the fact that it is the successor of IQPNNI and TREE-PUZZLE software.
- Efficient search algorithm: Fast and effective stochastic algorithm to reconstruct phylogenetic trees by maximum likelihood. IQ-TREE compares favorably to RAxML and PhyML in terms of likelihood while requiring similar amount of computing time (Nguyen et al., 2015).
- Ultrafast bootstrap: An ultrafast bootstrap approximation (UFBoot) to assess branch supports. UFBoot is 10 to 40 times faster than RAxML rapid bootstrap and obtains less biased support values (Minh et al., 2013; Hoang et al., 2018).
- Ultrafast model selection: An ultrafast and automatic model selection (ModelFinder) which is 10 to 100 times faster than jModelTest and ProtTest. ModelFinder also finds best-fit partitioning scheme like PartitionFinder (Kalyaanamoorthy et al., 2017).
- Simulating sequences: A fast sequence alignment simulator (AliSim) which is much more realistic than Seq-Gen and INDELible (Ly-Trong et al., 2023).
- Big Data Analysis: Supporting huge datasets with thousands of sequences or millions of alignment sites via checkpointing, safe numerical and low memory mode. Multicore CPUs and parallel MPI system are utilized to speedup analysis.
- Phylogenetic testing: Several fast branch tests like SH-aLRT and aBayes test (Anisimova et al., 2011) and tree topology tests like the approximately unbiased (AU) test (Shimodaira, 2002).
The strength of IQ-TREE is the availability of a wide variety of phylogenetic models:
- Common models: All common substitution models for DNA, protein, codon, binary and morphological data with rate heterogeneity among sites and ascertainment bias correction for e.g. SNP data.
- Partition models: Allowing individual models for different genomic loci (e.g. genes or codon positions), mixed data types, mixed rate heterogeneity types, linked or unlinked branch lengths between partitions.
- Mixture models: fully customizable mixture models and empirical protein mixture models and.
- Polymorphism-aware models: Accounting for incomplete lineage sorting to infer species tree from genome-wide population data (Schrempf et al., 2016).
For a quick start you can also try the IQ-TREE web server, which performs online computation using a dedicated computing cluster. It is very easy to use with as few as just 3 clicks! Try it out at
http://iqtree.cibiv.univie.ac.at
Please refer to the user documentation and frequently asked questions.
If you find a bug (e.g. when IQ-TREE prints a crash message) or want to request a new feature, please post an issue on GitHub: https://github.com/iqtree/iqtree3/issues. For other questions and feedback, please ask in GitHub discussions: https://github.com/iqtree/iqtree3/discussions
IQ-TREE has an extensive documentation with several tutorials and manual:
- Getting started guide: recommended for users who just downloaded IQ-TREE.
- Web Server Tutorial: A quick starting guide for the IQ-TREE Web Server.
- Beginner's tutorial: recommended for users starting to use IQ-TREE.
- Advanced tutorial: recommended for more experienced users who want to explore more features of IQ-TREE.
- Command Reference: Comprehensive documentation of command-line options available in IQ-TREE.
- Substitution Models: All common substitution models and usages.
- Complex Models: Complex models such as partition and mixture models.
- Polymorphism Aware Models: Polymorphism-aware phylogenetic Models (PoMo) related documentation.
- Compilation guide: for advanced users who wants to compile IQ-TREE from source code.
- Frequently asked questions (FAQ): recommended to have a look before you post a question in the IQ-TREE group.
To maintain IQ-TREE, support users and secure fundings, it is important for us that you cite the following papers, whenever the corresponding features were applied for your analysis.**
Example 1: We obtained branch supports with the ultrafast bootstrap (Hoang et al., 2018) implemented in the IQ-TREE 2 software (Minh et al., 2020).
Example 2: We used IQ-TREE 2 (Minh et al., 2020) to infer the maximum-likelihood tree using the edge-linked partition model (Chernomor et al., 2016).
General citation for IQ-TREE 3:
- Thomas K.F. Wong, Nhan Ly-Trong, Huaiyan Ren, Hector Banos, Andrew J. Roger, Edward Susko, Chris Bielow, Nicola De Maio, Nick Goldman, Matthew W. Hahn, Gavin Huttley, Robert Lanfear, Bui Quang Minh (2025) IQ-TREE 3: Phylogenomic Inference Software using Complex Evolutionary Models. Submitted. https://ecoevorxiv.org/repository/view/8916/
When using MixtureFinder please cite:
- Huaiyan Ren, Thomas KF Wong, Bui Quang Minh, Robert Lanfear (2025) MixtureFinder: Estimating DNA Mixture Models for Phylogenetic Analyses. Mol. Biol. Evol., 42:msae264. https://doi.org/10.1093/molbev/msae264
When using GTRpmix please cite:
- Hector Banos, Thomas KF Wong, Justin Daneau, Edward Susko, Bui Quang Minh, Robert Lanfear, Matthew W Brown, Laura Eme, Andrew J Roger (2025) GTRpmix: A linked general-time reversible model for profile mixture models. Mol. Biol. Evol., 92:msae174. https://doi.org/10.1093/molbev/msae174
When using CMAPLE please cite:
- Nhan Ly-Trong, Chris Bielow, Nicola De Maio, Bui Quang Minh (2024) CMAPLE: Efficient phylogenetic inference in the pandemic era. Mol. Biol. Evol., 41:msae134. https://doi.org/10.1093/molbev/msae134
When using the MAST model please cite:
- Thomas KF Wong, Caitlin Cherryh, Allen G Rodrigo, Matthew W Hahn, Bui Quang Minh, Robert Lanfear (2024) MAST: Phylogenetic Inference with Mixtures Across Sites and Trees. Syst. Biol., 73:375–391. https://doi.org/10.1093/sysbio/syae008
When using site/gene concordance factor please cite:
- Yu K Mo, Robert Lanfear, Matthew W Hahn, Bui Quang Minh (2023) Updated site concordance factors minimize effects of homoplasy and taxon sampling. Bioinformatics, 39:btac741. https://doi.org/10.1093/bioinformatics/btac741
When using AliSim please cite:
- Nhan Ly-Trong, Giuseppe MJ Barca, Bui Quang Minh (2023) AliSim-HPC: parallel sequence simulator for phylogenetics. Bioinformatics, 39:btad540. https://doi.org/10.1093/bioinformatics/btad540
When using QMaker for estimating protein Q matrix please cite:
- Bui Quang Minh, Cuong Cao Dang, Le Sy Vinh, Robert Lanfear (2021) QMaker: Fast and Accurate Method to Estimate Empirical Models of Protein Evolution. Syst. Biol., 70:1046–1060. https://doi.org/10.1093/sysbio/syab010
When using nQMaker for estimating non-reversible Q matrix please cite:
- Cuong Cao Dang, Bui Quang Minh, Hanon McShea, Joanna Masel, Jennifer E James, Le Sy Vinh, Robert Lanfear (2022) nQMaker: Estimating Time Nonreversible Amino Acid Substitution Models. Syst. Biol., 71:1110–1123. https://doi.org/10.1093/sysbio/syac007
When using Rootstrap please cite:
- Suha Naser-Khdour, Bui Quang Minh, Robert Lanfear (2022) Assessing Confidence in Root Placement on Phylogenies: An Empirical Study Using Nonreversible Models for Mammals. Syst. Biol., 71:959–972. https://doi.org/10.1093/sysbio/syab067
When using the GHOST "+H" model please cite:
- Stephen M Crotty, Bui Quang Minh, Nigel G Bean, Barbara R Holland, Jonathan Tuke, Lars S Jermiin, Arndt Von Haeseler (2020) GHOST: Recovering Historical Signal from Heterotachously Evolved Sequence Alignments. Syst. Biol., 69:249-264. https://doi.org/10.1093/sysbio/syz051
When using tests of symmetry please cite:
- Suha Naser-Khdour, Bui Quang Minh, Wenqi Zhang, Eric A Stone, Robert Lanfear (2019) The Prevalence and Impact of Model Violations in Phylogenetic Analysis. Genome Biol. Evol., 11:3341-3352. https://doi.org/10.1093/gbe/evz193
When using ModelFinder please cite:
- Subha Kalyaanamoorthy, Bui Quang Minh, Thomas KF Wong, Arndt von Haeseler, and Lars S Jermiin (2017) ModelFinder: Fast model selection for accurate phylogenetic estimates. Nat. Methods, 14:587–589. https://doi.org/10.1038/nmeth.4285
When using polymorphism-aware models please cite:
- Dominik Schrempf, Bui Quang Minh, Arndt von Haeseler, Carolin Kosiol (2019) Polymorphism-Aware Species Trees with Advanced Mutation Models, Bootstrap, and Rate Heterogeneity. Mol. Biol. Evol., 36:1294–1301. https://doi.org/10.1093/molbev/msz043
When using site-specific frequency model please cite:
- Huai-Chun Wang, Edward Susko, Bui Quang Minh, and Andrew J. Roger (2018) Modeling site heterogeneity with posterior mean site frequency profiles accelerates accurate phylogenomic estimation. Syst. Biol., 67:216–235. https://doi.org/10.1093/sysbio/syx068
When using ultrafast bootstrap (UFBoot) please cite:
- Diep Thi Hoang, Olga Chernomor, Arndt von Haeseler, Bui Quang Minh, and Le Sy Vinh (2018) UFBoot2: Improving the ultrafast bootstrap approximation. Mol. Biol. Evol., 35:518–522. https://doi.org/10.1093/molbev/msx281
When using partition models please cite:
- Olga Chernomor, Arndt von Haeseler, and Bui Quang Minh (2016) Terrace aware data structure for phylogenomic inference from supermatrices. Syst. Biol., 65:997-1008. https://doi.org/10.1093/sysbio/syw037
When using terrace analysis please cite:
- Biczok R, Bozsoky P, Eisenmann P, Ernst J, Ribizel T, Scholz F, Trefzer A, Weber F, Hamann M, Stamatakis A. (2018) Two C++ libraries for counting trees on a phylogenetic terrace. Bioinformatics, 34:3399–3401. https://doi.org/10.1093/bioinformatics/bty384
When using least square dating (LSD) please cite:
- Thu-Hien To, Matthieu Jung, Samantha Lycett, Olivier Gascuel (2016) Fast dating using least-squares criteria and algorithms. Syst. Biol., 65:82-97. https://doi.org/10.1093/sysbio/syv068
When using IQ-TREE web server please cite:
- J. Trifinopoulos, L.-T. Nguyen, A. von Haeseler, B.Q. Minh (2016) W-IQ-TREE: a fast online phylogenetic tool for maximum likelihood analysis. Nucleic Acids Res., 44:W232-W235. https://doi.org/10.1093/nar/gkw256
When using IQ-TREE 2 please cite:
- B.Q. Minh, H.A. Schmidt, O. Chernomor, D. Schrempf, M.D. Woodhams, A. von Haeseler, R. Lanfear (2020) IQ-TREE 2: New models and efficient methods for phylogenetic inference in the genomic era. Mol. Biol. Evol., 37:1530-1534. https://doi.org/10.1093/molbev/msaa015
When using IQ-TREE version 1 please cite:
- L. Nguyen, H.A. Schmidt, A. von Haeseler, B.Q. Minh (2015) IQ-TREE: A Fast and Effective Stochastic Algorithm for Estimating Maximum-Likelihood Phylogenies. Mol. Biol. Evol., 32:268-274. https://doi.org/10.1093/molbev/msu300
IQ-TREE is actively developed by:
Bui Quang Minh, Team leader, Designs and implements software core, tree search, ultrafast bootstrap, model selection.
Robert Lanfear, Co-leader, Co-leading various projects (incl. new model selection) and documentations, acting as a bridge with biologists.
Thomas Wong, Developer, Mixture models, model selection.
Nhan Ly-Trong, Developer, sequence simulator, pathogen phylogeny reconstruction.
Piyumal Demotte, time tree inference.
Olga Chernomor, Developer, Implements partition models.
Heiko A. Schmidt, Developer, Integrates TREE-PUZZLE features, user supports and documentations.
Dominik Schrempf, Developer, Implements polymorphism-aware models (PoMo).
Michael Woodhams, Developer, Implements Lie Markov models.
Diep Thi Hoang, Developer, Improves ultrafast bootstrap.
Arndt von Haeseler, Advisor.
Past members:
Lam Tung Nguyen, Developer, Implemented tree search algorithm.
Jana Trifinopoulos, Developer, Implemented web service.
James Barbetti, Developer, Code optimization.
Some parts of the code were taken from the following packages/libraries: Phylogenetic likelihood library, TREE-PUZZLE, BIONJ, Nexus Class Libary, Eigen library, SPRNG library, Zlib library, gzstream library, vectorclass library, GNU scientific library.
IQ-TREE was funded by the Austrian Science Fund (grant no. I760-B17 from 2012-2015 and I 2508-B29 from 2016-2017), the University of Vienna (Initiativkolleg I059-N from 2012-2015), the Australian National University (2018-onwards), Chan-Zuckerberg Initiative (2020).