How iqtree/iqtree3 works
IQ-TREE is maximum-likelihood phylogenomic software. Its principal workflow takes an alignment and analysis options, prepares sequence data and evolutionary models, searches and evaluates phylogenetic trees, then writes reports and Newick trees. The README also identifies model selection, branch and topology tests, partitioning, and AliSim as product capabilities. The source excerpts are partial, so links for some documented capabilities are shown from the CLI only where the index supports them; unsampled implementation details are not inferred.
Main entry points: main.cpp CLI orchestration · phylotree.cpp Tree likelihood search · modelmixture.cpp Substitution models · alignment.cpp Alignment data
Components 18
Input and setup
- CLI orchestration
main/main.cpp - Alignment data
alignment/alignment.cpp - Nexus parsing
ncl/nxscharactersblock.cpp
Evolutionary models
- Substitution models
model/modelmixture.cpp - Partition models
model/partitionmodel.cpp - Rate variation
model/rategamma.cpp
Tree inference
- Tree likelihood search
tree/phylotree.cpp - Tree structures
tree/mtree.cpp
Analysis features
- Branch support
main/phyloanalysis.cpp - Model selection
main/phylotesting.cpp - Tree tests
main/treetesting.cpp - Alignment simulation
simulator/alisimulator.cpp - Terrace analysis
terrace/terrace.cpp
Runtime support
- Analysis outputs
main/main.cpp - Checkpointing
utils/checkpoint.cpp - Distributed execution
utils/MPIHelper.cpp - Progress and timing
utils/progress.cpp
Other components
- Researcher
Connections 18
- Researcher → CLI orchestration: provides inputs
README.md - CLI orchestration → Alignment data: loads alignment
main/main.cpp - Alignment data → Nexus parsing: parses Nexus
alignment/alignment.cpp - CLI orchestration → Tree likelihood search: runs inference
main/main.cpp - Tree likelihood search → Substitution models: evaluates likelihood
tree/phylotree.cpp - Tree likelihood search → Tree structures: uses tree structures
- Substitution models → Partition models: supports partitions
README.md - Substitution models → Rate variation: supports rate variation
README.md - CLI orchestration → Model selection: selects models
README.md - CLI orchestration → Branch support: assesses support
README.md - CLI orchestration → Tree tests: tests topologies
README.md - CLI orchestration → Alignment simulation: runs AliSim
main/main.cpp - CLI orchestration → Terrace analysis: runs terrace analysis
main/main.cpp - CLI orchestration → Checkpointing: saves state
- CLI orchestration → Distributed execution: uses distributed execution
README.md - CLI orchestration → Progress and timing: reports progress
main/main.cpp - CLI orchestration → Analysis outputs: writes results
README.md - Tree likelihood search → Analysis outputs: produces tree result