/ggmuller

Create Muller Plots of Evolutionary Dynamics

Primary LanguageROtherNOASSERTION

CRAN_Status_Badge

ggmuller

Create Muller Plots of Evolutionary Dynamics

Installation

To install the CRAN version:

install.packages("ggmuller")
library(ggmuller)

To install the github version using devtools:

install.packages("devtools")
library(devtools)
  
install_github("robjohnnoble/ggmuller")
library(ggmuller)

Basic usage

The main functions in ggmuller are get_Muller_df and Muller_plot, which we can run on some data included in the package:

# reformat data ready for plotting:
Muller_df <- get_Muller_df(example_edges, example_pop_df)

# generate the plot:
Muller_plot(Muller_df)

How-to guides

The best place to start is the CRAN vignette, which includes an overview of features and some worked examples.

An older, slightly different set of instructions can be found in a blog post on Visualizing evolutionary dynamics with ggmuller.

Version history

0.6.0: Use a much faster depth-first search algorithm.

0.5.6: Avoid loading or importing ape package, to avoid namespace conflict between ape and dplyr.

0.5.5: Optional removal of rare types is now much more efficient for large data sets.

0.5.4: Fix a rare bug; add tip labels to trees.

0.5.3: get_Muller_df now fills all columns when adding missing rows (issue #10); polygon edges now aren't drawn by default.

0.5.2: Can cope with the special case of only one genotype.

0.5.1: Can use brewer palettes.

0.5: Smoother plots from sparse data; time column can now be called "Time" instead of "Generation"; replace missing population sizes with zeroes.

0.4: Smoother plotting by default when genotypes suddenly grow from zero to large frequencies; new "start_positions" parameter can be used to override this default.

0.3: Bug fixes; in particular, the "threshold" option is replaced by "cutoff" (genotypes whose abundance never exceeds "cutoff" are removed, whereas previously genotypes whose abundance never exceeded twice "threshold" were removed).

0.2.2: Bug fixes and deprecation of superfluous options.

0.2.1: Correct mistake in calculating population sizes for Muller_pop_plot.

0.2.0: New function Muller_pop_plot shows variation in population size as well as frequency (also known as a fish plot).

0.1.3: Compatibility with dplyr version 0.7.2; add option for smoother plotting of genotype emergence points.

0.1.2: Better plotting of the points at which genotypes emerge.

0.1.1: Essential update for compatibility with ggplot2 version 2.2.0.

0.1.0: First release.

Citation

To cite ggmuller in publications please use

Robert Noble (2019). ggmuller: Create Muller Plots of Evolutionary Dynamics. R package version 0.5.3. doi:10.5281/zenodo.591304 https://CRAN.R-project.org/package=ggmuller

A BibTeX entry for LaTeX users is

@Manual{,
title = {ggmuller: Create Muller Plots of Evolutionary Dynamics},
author = {Robert Noble},
year = {2019},
note = {R package version 0.5.3},
url = {https://CRAN.R-project.org/package=ggmuller},
doi = 10.5281/zenodo.591304
}

Please amend the version number as appropriate.