HOME

PAML Wiki

PAML (for Phylogenetic Analysis by Maximum Likelihood) is a package of programs for phylogenetic analyses of DNA or protein sequences using maximum likelihood. It is maintained by Ziheng Yang and distributed under the GNU GPL v3.

Before running any of the programs included in the PAML software, please go through the different sections of this Wiki, where a detailed explanation of how to install and run the programs is given. One of the main problems users face is related to data formatting. In that way, please make sure that you go through the section Data formatting before running any PAML program and format your input and control files accordingly.

If you have any questions, please first read the FAQs document as they might be answered in this document. If not, please use the search tool in the PAML discussion group to check whether your question/s have already been asked by other PAML users. If you still cannot find an answer to your questions, please post them in the PAML discussion group.

Installation

ANSI C source codes and executable files are distributed for UNIX, Linux, and Mac OS X (see the latest stable release available on this GitHub repository). PAML is not good for tree making, although it may be used to estimate parameters and test hypotheses to study the evolutionary process once you have reconstructed trees using other programs such as RAxML-NG, IQ-TREE, PAUP*, PHYLIP, PhyML, etc.

To download and install PAML software, please follow the next links in the wiki:

• Downloading and installing PAML
  • PAML for UNIX/Linux
  • PAML for Windows 10 or later
  • Old compiled versions of PAML
    • PAML for MAC OS X
    • PAML for WINDOWS 9x/NT/2000/XP/Vista 7
  • Graphical user interface: PAML-X
  • Running PAML programs
  • Example datasets

Documentation

• Overview
  • PAML documentation
  • What PAML programs can do
  • What PAML programs cannot do
• Data file formats
  • Sequence data file format
    • Sequential and interleaved formats
      • Species/sequence names
      • Option G
      • Option G for codon sequences (codeml with seqtype = 1)
    • Site pattern counts
  • Tree file format and representations of tree topology
    • Parenthesis notation
    • Tree files produced by PAUP and MacClade
    • Branch or node labels
    • Divergence date symbol @
    • Branch representation of tree topology

Citing PAML

If you use PAML, please cite the following:

• Yang, Z (1997). PAML: a program package for phylogenetic analysis by maximum likelihood. Comput. Appl. Biosci. 13, 555-556.
• Yang, Z (2007). PAML 4: Phylogenetic Analysis by Maximum Likelihood. Mol. Biol. Evol. 24, 1586-1591.

In addition...

If you use the PAML program MCMCtree, please cite the following papers if you have used/run...

• ... the approximate likelihood calculation to speed up analyses with phylogenomic datasets (calculating Hessian and gradient):
  • dos Reis M and Yang Z (2011). Approximate likelihood calculation for Bayesian estimation of divergence times. Mol. Biol. Evol. 28, 2161-2172.
• ... Bayesian model selection analysis for relaxed-clock models:
  • dos Reis M, et al. (2018). Using phylogenomic data to explore the effects of relaxed clocks and calibration strategies on divergence time estimation: Primates as a test case. Syst. Biol. 67, 594–615. Also, please cite the mcmc3r R package if you use it (see tutorial here).
• ... the models for continuous morphological characters implemented in MCMCtree:
  • Álvarez-Carretero S, et al. (2019). Bayesian estimation of species divergence times using correlated quantitative characters. Syst. Biol. 68, 967–986. Also, please cite the mcmc3r R package if you use it (see tutorial).
• ... the protocol Bayesian Molecular Clock Dating Using Genome-Scale Datasets:
  • dos Reis M and Yang, Z (2019). Bayesian Molecular Clock Dating Using Genome-Scale Datasets. In: Anisimova, M. (eds) Evolutionary Genomics. Methods in Molecular Biology, vol 1910. Humana, New York, NY. You can also access this chapter and the code used throughout the protocol on the divtime GitHub repository maintained by Mario dos Reis.
• ... the protocol Environmental Microbial Evolution: Methods and Protocols:
  • dos Reis M (2022) In: Haiwei Luo (ed.) Environmental Microbial Evolution: Methods and Protocols. Methods in Molecular Biology, vol 2569. Humana, New York, NY. You can access the code used throughout the protocol on the microdiv GitHub repository maintained by Mario dos Reis.
• ... the sequential-subtree approach and/or fitting skew-t distributions to fossil calibrations:
  • Álvarez-Carretero S, et al. (2022) A species-level timeline of mammal evolution integrating phylogenomic data. Nature 602, 263–267. You can find the tutorial to reproduce these analyses on the mammals_dating GitHub repository maintained by Sandra Álvarez-Carretero.

If you use the PAML program CODEML, please cite the following papers if you have used/run...

• ... the protocol A Beginners guide to estimating the non-synonymous to synonymous rate ratio of all protein-coding genes in a genome:
  • Jeffares DC, Tomiczek B, Sojo V, dos Reis M (2015). A Beginners Guide to Estimating the Non-synonymous to Synonymous Rate Ratio of all Protein-Coding Genes in a Genome. In: Peacock, C. (eds) Parasite Genomics Protocols. Methods in Molecular Biology, vol 1201. Humana Press, New York, NY..
• ... the protocol Beginner's guide on the use of PAML to detect positive selection and/or the corresponding GitHub tutorial on the positive-selection repository:
  • Álvarez-Carretero S, Kapli P, Yang Z (2023). Beginner's guide on the use of PAML to detect positive selection, Mol Biol Evol, 40(4):msad041.. Remember to read the supplementary material where we discuss (i) analyses and checks you should carry out before running tests of positive selection with CODEML, (ii) gene tree VS species tree, and (iii) the usage of rooted and unrooted trees.

Additional information

Recent changes and bug fixes are documented in the file doc/pamlHistory.txt.

Please post your questions and comments at the google discussion site for PAML. Please only raise issues on this GitHub repository when you experience any technical problems.