This package is under active development. If you find bugs, or have any other feedback, please let us know (preferably through a GitHub Issue)!


This package allows automated creation of flow diagrams for compartmental simulation models using ggplot. Other types of flow charts are also supported.

Getting Started

For an introduction to the package, step-by-step instructions on getting started, and more information on the different ways you can use the package see the Quick Start tutorial (vignette).

Further information

We wrote several tutorials/vignettes that explain all features of flowdiagramr. Here they are listed for convenience.

Main tutorials/vignettes

You should go through them in this order

  1. Quick start guide
  2. Modifying diagrams I
  3. Modifying diagrams II
  4. Modifying the ggplot2 object or code

Additional tutorials/vignettes

Read them based on interest, in any order

The package website (if you are not already on it) is here. You can access all the tutorials from there, as well as some additional information.

Citation and Contributors

This R package was developed by Andrew Tredennick and Andreas Handel. It is maintained Andreas Handel. A full list of contributors and a Bibtex entry for the citation can be found here.

This project was/is partially supported by NIH grants R01 GM124280 and GM 12480-03S1.