RevGadgets

CRAN downloads R-CMD-check DOI

Postprocessing gadgets for output generated by RevBayes

Through user-friendly data pipelines, RevGadgets guides users through importing RevBayes output into R, processing the output, and producing figures or other summaries of the results. RevGadgets provide paired processing and plotting functions built around commonly implemented analyses, such as tree building and divergence-time estimation, diversification-rate estimation, ancestral-state reconstruction and biogeographic range reconstruction, and posterior predictive simulations.

To install:

First, make sure that you have a recent version of R installed. RevGadgets requires R version 4.0 or greater.

Then, install the devtools R-package:

install.packages("devtools")

Install RevGadgets directly from GitHub:

devtools::install_github("revbayes/RevGadgets")

Note about magick dependency:

A few RevGadgets dependencies require magick, which may require you to install the imagemagick software external to R.

On a mac, you can do this with homebrew on terminal:

brew install imagemagick

Tutorial:

For an introduction to using RevGadgets, check out the tutorial on the RevBayes website.

Legacy:

Some old RevBayes tutorials reference a legacy version of RevGadgets. To reproduce those tutorials, or the results of papers published using the legacy version, you’ll need to install the legacy version of RevGadgets. To use this code, install the package using devtools, specifying the legacy branch:

devtools::install_github("revbayes/RevGadgets@legacy")

Gists:

Here’s a list of useful R scripts for working with RevBayes/RevGadgets, but separate from core RevGadgets functionality. This is a growing list: please let us know if you want to contribute your own!

Contributing:

If you’d like to contribute to RevGadgets, please have a look at our developer guide! For minor changes to existing code, make changes to development. To develop new code or make more substantial changes, create a new feature branch from development and then submit a pull request to merge back with development when the code is ready. No changes should happen directly on the master branch.