This page is intended to guide users in assembling a set of tutorials that will help them learn
how to use RevBayes for a given analysis. Each module lists the tutorials that focus on a particular
topic, as well as those that will provide prerequisite knowledge or resources for deeper learning.
We encourage users with no RevBayes experience to start with the RevBayes fundamentals module.
To see all available tutorials, including the ones for which modules are not currently written, go to the full tutorials page.
RevBayes fundamentals
This module is for users who have no experience with RevBayes. The tutorials contained here walk the user through the basics of installing and using RevBayes, and some of the theory behind RevBayes analyses.
- Pre-requisites: Basic knowledge on Bayesian statistics.
- Getting started with RevBayes. This tutorial includes getting RevBayes working on your machine, and learning about the fundamentals of setting up models in the software.
- MCMC fundamentals. Three tutorials lay out the basics of Markov Chain Monte Carlo analysis in RevBayes, using three different examples: Airline fatalities, coin flips, and archery. It is recommended that absolute beginners go through all three.
By the end of this module, you should be able to build RevBayes, write simple Rev code, and build simple models on which to run MCMC analyses. From here, you can select the module(s) below that best represent your interests and intended analyses.
MCMC assessment
This module is for users looking to debug or analyze their MCMC results deeper. The tutorials will walk the user through best practices when analyzing posterior samples, and tips on how to improve your analyses if your analysis has not converged.
- Pre-requisites: RevBayes fundamentals, and results from some analysis (e.g. from completion of one of the modules below).
- Assessing convergence of your MCMC results: Convergence assessment. This tutorial will walk you through theory and examples on how to assess the convergence of your MCMC chain.
- Practical exercises on assessing convergence: Debugging your MCMC. This tutorial contains more exercises on assessing convergence, and provides tips on how to improve convergence in your analysis.
- Introduction to RevGadgets walks you through the use of RevGadgets, an R package that is an optional but convenient tool for postprocessing of RevBayes results.
Molecular phylogenetic inference
This module is intended for users looking to infer a phylogenetic tree using molecular (DNA) data. Users will learn how to set up basic molecular evolution model, and be presented with more advanced tutorials to tailor their learning to their desired analyses.
- Pre-requisites: RevBayes fundamentals.
- Theoretical background: Understanding continuous-time Markov models. This tutorial will get you up to speed with the theory behind molecular evolution models.
- Basic molecular phylogenetic inference: Nucleotide substitution models. This tutorial will walk you through a simple example of molecular phylogeny inference.
- If interested in partitioning molecular data: Partitioned data analysis.
- If interested in choosing between models of molecular evolution:
By the end of this module, you should be able to infer a phylogenetic tree with a simple molecular evolution model. Depending on your interests, you will also have learned about how to set up partitioned models, and choose the best models for your dataset.
Polymorphism-aware molecular phylogenetics
This module is intended for users looking to infer a phylogenetic tree using molecular data including polymorphisms. Users will learn how to modify their molecular evolution models to account for the presence of polymorphisms in the dataset, including, if desired, balanced selection. Note that the tutorials in this module use code on a separate RevBayes branch, requiring users to run
git checkout dev_PoMo_SNP
within their local RevBayes repo before running analyses.
- Pre-requisites: RevBayes fundamentals, Molecular phylogenetic inference.
- Polymorphism-aware phylogenetic models.
- If interested in including balancing selection in your model: Polymorphism-aware phylogenetic models with balancing selection.
Morphological phylogenetic inference
This module is intended for users looking to infer a phylogenetic tree using morphological data. Users will learn how to set up basic morphological evolution models, including for characters with more than two states.
- Pre-requisites: RevBayes fundamentals.
- Theoretical background: Understanding continuous-time Markov models. This tutorial will get you up to speed with the theory behind morphological evolution models.
- Morphological phylogenetics with binary traits: Tree inference with discrete morphology. This tutorial will walk you through a simple example of morphological phylogeny inference, using only binary (i.e. two-state) characters.
- Expanding your dataset: Multistate characters. This tutorial will teach you how to accommodate characters with more than two states in your morphological phylogenetics analyses.
Dating a phylogeny
This module is intended for users looking to date a time-calibrated phylogenetic tree. Users will learn how to set up analyses using both molecular clocks and fossil data for node dating.
- Pre-requisites: RevBayes fundamentals, and either Molecular phylogenetic inference or Morphological phylogenetic inference. Note that while the tutorials below use molecular models, it is straightforward to adapt the clock model to a morphological analysis.
- Master dating tutorial: Dating trees. This tutorial includes:
- Global molecular clocks: The basics of molecular clocks.
- Uncorrelated relaxed clocks: More complex (and biologically realistic) molecular clocks.
- Node dating with fossils: Including fossil data for node dating. The master dating tutorial also links to a more advanced tip-dating tutorial (see the Total-evidence analysis with tip-dating module).
- Bringing it all together: Relaxed clocks & time trees. This tutorial walks the user through a full analysis, including performing model selection between multiple clock models.
- If interested in enforcing the relative order of nodes in your analysis: Dating with relative constraints.
Estimating diversification rates
This module is intended for users looking to infer rates of speciation and extinction. Users will learn how to set up analyses using models in the birth-death model family, including the use of fossil data. While most of the tutorials here assume a fixed phylogenetic tree, some recommendations are made to point the user towards the direction of joint estimation as well.
- Pre-requisites: RevBayes fundamentals.
- Theoretical background: Introduction to diversification rate estimation. This tutorial will walk you through the theory behind the birth-death models used in the following tutorials.
- Constant-rate models: Simple diversification-rate estimation. This tutorial will walk you through the basics of setting up a birth-death model for estimating rates of speciation and extinction from a fixed phylogenetic tree.
The following tutorials are to be picked based on your intended analyses, as they lay out different hypotheses regarding diversification dynamics and how to set up a BD model to test those.
- If interested in time-heterogeneous (or environmentally-dependent) diversification dynamics: Episodic diversification rate estimation, Environmental-dependent speciation and extinction rates.
- If interested in mass-extinction estimation, including fossil taxa: Mass-extinction estimation.
- If interested in jointly estimating topology and diversification rates: Relaxed clocks & time-trees (consider completing the Molecular phylogenetic inference and Dating a phylogeny modules).
Total-evidence analysis with tip-dating
This module is intended for users looking to infer a time-calibrated phylogenetic tree with both molecular and fossil data, and fossil ages.
- Pre-requisites: Dating a phylogeny (and both Molecular phylogenetic inference and Morphological phylogenetic inference), and Estimating diversification rates.
- The fossilized birth-death model. This tutorial will push you to put together the skills learned in many previous tutorials, including setting up molecular and morphological evolution, clock, and birth-death models.
- If interested in more complex diversification dynamics, explore the advanced tutorials in Estimating diversification rates. Note that
dnFBDP
should be used instead ofdnBDP
/dnEBDP
.
State-dependent diversification-rate estimation
This module is intended for users looking to infer trait-dependent diversification rates using the state-dependent speciation and extinction (SSE) model family. As with Estimating diversification rates, the tutorials assume a fixed tree, but tips are included for joint estimation.
- Pre-requisites: RevBayes fundamentals, and Estimating diversification rates.
- Theoretical background: Background on state-dependent diversification-rate estimation. This tutorial will introduce you to the theory behind the SSE model family, building from the fundamentals on BD models you learned on the Estimating diversification rates module.
- Testing the effects of discrete traits on diversification: State-dependent diversification with BiSSE and MuSSE. This tutorial will walk you through the setup of the simplest SSE models: binary and multiple SSE (BiSSE and MuSSE), which are used to test the effects of binary and multiple state discrete traits on diversification, respectively.
- If interested in testing whether unobserved effects might impact diversification for your data: State-dependent diversification with hidden SSE (HiSSE).
- If interested in the presence of cladogenetic state transitions: State-dependent diversification with cladogenetic SSE (ClaSSE).
- If interested in the effect of chromosome number on diversification: Chromosome evolution.
- If interested in jointly estimating topology and state-dependent diversification rates, adapt Relaxed clocks & time-trees to use
dnCDBDP
ordnGLHBDSP
instead ofdnBDP
(consider completing the Molecular phylogenetic inference and Dating a phylogeny modules).