Summary
Phylogenetic trees are currently routinely reconstructed from an alignment of character sequences (usually nucleotide sequences). Bayesian tools, such as MrBayes, RevBayes and BEAST2, have gained much popularity over the last decade, as they allow joint estimation of the posterior distribution of the phylogenetic trees and the parameters of the underlying inference model. An important ingredient of these Bayesian approaches is the species tree prior. In principle, the Bayesian framework allows for comparing different tree priors, which may elucidate the macroevolutionary processes underlying the species tree. In practice, however, only macroevolutionary models that allow for fast computation of the prior probability are used. The question is how accurate the tree estimation is when the real macroevolutionary processes are substantially different from those assumed in the tree prior.
Here we present pirouette, a free and open-source R package that assesses the inference error made by Bayesian phylogenetics for a given macroevolutionary diversification model. pirouette makes use of BEAST2, but its philosophy applies to any Bayesian phylogenetic inference tool.
We describe pirouette’s usage providing full examples in which we interrogate a model for its power to describe another.
Last, we discuss the results obtained by the examples and their interpretation.
Competing Interest Statement
The authors have declared no competing interest.
Footnotes
Implemented feedback from reviewers, with much extra information and results in supplementary materials.