Dynamical Systems Approach to Immune Response Modeling


DSAIRM is an R package containing a set of simulation modelss (apps) that teach within-host infection dynamics and immune response modeling from a dynamical system perspective.

All models can be explored through a graphical user interface, no reading or writing code is required. Each app comes with documentation and instructions which teach important concepts of within-host and immune response modeling, and how to use simulation models to understand such concepts.

It is also possible to go beyond the graphical interface and directly access and modify all simulations to adapt them to your needs.

Getting Started

While the main idea is to install the R package and use it locally, if you want to get a quick glimpse at the package to see if this package is for you, you can give it a quick try online, without having to install it. If you like what you see, you can install it and start using it with these 3 commands:


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 Get Started tutorial (vignette).

Further information

  • The package tutorial (vignette) contains detailed instructions on the different ways the package can be used.
  • I published a paper describing the package. The package has since been updated and changed, but the paper still describes the overall idea and context well.
  • I teach an annual workshop with my colleague Paul Thomas at SISMID where we cover some of the topics you can learn about in DSAIRM (and we use the package). Workshop materials are freely available online.
  • If you want to take a deeper look at the package, see this Markdown file which provides further information on the details of the package structure. I’d be excited to receive any contributions from individuals who want to help improve the package. If you plan to develop new apps, or make other substantial contributions, it might be best to get in touch with me first.
  • A ‘companion’ package to this one, called Dynamical Systems Approaches to Infectious Disease Epidemiology (DSAIDE), focuses on models at the population level. It has the same structure as DSAIRM. See the DSAIDE site for more information.

Citation and Contributors

If the package does in any way help you with your work such that it warrants citing it, please cite the DSAIRM publication in BMC Immunology.

This R package is developed and maintained by 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 U19AI117891, U01AI150747, R25AI147391 and R25GM089694.