Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
inst Update CITATION file Apr 9, 2018
man 💥 Bump version/date Apr 20, 2018
README.md Update README.md Jul 2, 2018



Version Build Status Methods

Tools for simulating mathematical models of infectious disease dynamics. Epidemic model classes include deterministic compartmental models, stochastic agent-based models, and stochastic network models. Network models use the robust statistical methods of exponential-family random graph models (ERGMs) from the Statnet suite of software packages in R. Standard templates for epidemic modeling include SI, SIR, and SIS disease types. EpiModel features an easy API for extending these templates to address novel scientific research aims.


The current release version can be found on CRAN and installed with:

install.packages("EpiModel", dependencies = TRUE)

To install this development version, use the devtools package:

if (!require("devtools")) install.packages("devtools")

Lead Authors

Samuel M. Jenness Department of Epidemiology Emory University
Steven M. Goodreau Department of Anthropology University of Washington
Martina Morris Departments of Statistics and Sociology University of Washington


The main website for EpiModel, with tutorials and other supporting files is http://epimodel.org/. Users are encouraged to join the email list for EpiModel as a place to ask questions, report bugs, and tell us about your research using these tools.


A good place to start learning about EpiModel is the main methods paper published in the Journal of Statistical Software. It is available at http://doi.org/10.18637/jss.v084.i08.


If using EpiModel for teaching or research, please include a citation:

Jenness SM, Goodreau SM and Morris M. EpiModel: An R Package for Mathematical Modeling of Infectious Disease over Networks. Journal of Statistical Software. 2018; 84(8): 1-47. doi: 10.18637/jss.v084.i08

Please also send us an email if you have used EpiModel in your work so we can add the citation below.

Applied Uses of EpiModel in the Scientific Literature

EpiModel has been used in the following scientific journal articles.

HIV and Other Sexually Transmitted Infections

  1. Delaney KP, Rosenberg ES, Kramer MR, Waller LA, Sullivan PS. Optimizing Human Immunodeficiency Virus Testing Interventions for Men Who Have Sex With Men in the United States: A Modeling Study. Open Forum Infect Dis. 2015;2(4): ofv153. [LINK]

  2. Jenness SM, Goodreau SM, Morris M, Cassels S. Effectiveness of Combination Packages for HIV-1 Prevention in Sub-Saharan Africa Depends on Partnership Network Structure. Sexually Transmitted Infections. 2016; 92(8): 619-624. [LINK]

  3. Jenness SM, Goodreau SM, Rosenberg E, Beylerian EN, Hoover KW, Smith DK, Sullivan P. Impact of CDC’s HIV Preexposure Prophylaxis Guidelines among MSM in the United States. Journal of Infectious Diseases. 2016; 214(12): 1800-1807. [LINK]

  4. Jenness SM, Sharma A, Goodreau SM, Rosenberg ES, Weiss KM, Hoover KW, Smith DK, Sullivan P. Individual HIV Risk versus Population Impact of Risk Compensation after HIV Preexposure Prophylaxis Initiation among Men Who Have Sex with Men. PLoS One. 2017; 12(1): e0169484. [LINK]

  5. Goodreau SM, Rosenberg ES, Jenness SM, Luisi N, Stansfield SE, Millett G, Sullivan P. Sources of Racial Disparities in HIV Prevalence among Men Who Have Sex with Men in Atlanta, GA: A Modeling Study. Lancet HIV. 2017; 4(7):e311-e320. [LINK]

  6. Jenness SM, Weiss KM, Goodreau SM, Rosenberg E, Gift T, Chesson H, Hoover KW, Smith DK, Liu AY, Sullivan P. Incidence of Gonorrhea and Chlamydia Following HIV Preexposure Prophylaxis among Men Who Have Sex with Men: A Modeling Study. Clinical Infectious Diseases. 2017; 65(5): 712-718. [LINK]

  7. Vandormael A, Dobra A, Bärnighausen T, de Oliveira T, Tanser F. Incidence rate estimation, periodic testing and the limitations of the mid-point imputation approach. International Journal of Epidemiology. Epub 2017 Aug 9. [LINK]

  8. Goodreau SM, Hamilton DT, Jenness SM, Sullivan PS, Valencia RK, Wang LY, Dunville RL, Barrios LC, Rosenberg ES. Targeting Human Immunodeficiency Virus Pre-Exposure Prophylaxis to Adolescent Sexual Minority Males in Higher Prevalence Areas of the United States: A Modeling Study. J Adolesc Health. Epub 2017. [LINK]

  9. Herbeck JT, Peebles K, Edlefsen PT, Rolland M, Murphy JT, Gottlieb GS, Abernethy N, Mullins JI, Mittler JE, Goodreau SM. HIV population-level adaptation can rapidly diminish the impact of a partially effective vaccine. Vaccine. 2018;36(4): 514-520. [LINK]

  10. Luo W, Katz DA, Hamilton DT, McKenney J, Jenness SM, Goodreau SM, Stekler JD, Rosenberg ES, Sullivan P, Cassels S. Development of an Agent-Based Model to Investigate the Impact of HIV Self-Testing Programs for Men Who Have Sex with Men in Atlanta and Seattle. Journal of Medical Internet Research Public Health Surveillance. 2018; 4(2): e58. [LINK]


  1. Ezenwa VO, Archie EA, Craft ME, Hawley DM, Martin LB, Moore J, White L. Host behaviour-parasite feedback: an essential link between animal behaviour and disease ecology. Proc Biol Sci. 2016; 283(1828). [LINK]

  2. Goldstein ND, Eppes SC, Mackley A, Tuttle D, Paul DA. A Network Model of Hand Hygiene: How Good Is Good Enough to Stop the Spread of MRSA? Infect Control Hosp Epidemiol. 2017:1-8. [LINK]

  3. White LA, Forester JD, Craft ME. Covariation between the physiological and behavioral components of pathogen transmission: Host heterogeneity determines epidemic outcomes. Oikos. Epub 2017 November. [LINK].

  4. Haeussler K, Hout AV, Baio G. A dynamic Bayesian Markov model for health economic evaluations of interventions against infectious diseases. arXiv. arXiv:1512.06881. [LINK].

  5. Webber QM, Brigham RM, Park AD, Gillam EH, O’Shea TJ, Willis CK. Social network characteristics and predicted pathogen transmission in summer colonies of female big brown bats (Eptesicus fuscus). Behavioral Ecology and Sociobiology. 2016;70(5): 701-12. [LINK].

  6. Robinson SJ, Barbieri MM, Murphy S, Baker JD, Harting AL, Craft ME, Littnan CL. Model recommendations meet management reality: implementation and evaluation of a network-informed vaccination effort for endangered Hawaiian monk seals. Proceeding of the Royal Society B. 2018; DOI: 10.1098/rspb.2017.1899. [LINK].

  7. Goldstein ND, Jenness SM, Tuttle D, Power M, Paul DA, Eppes SC. Evaluating a neonatal intensive care unit HRSA surveillance programme using agent-based network modeling. Journal of Hospital Infection. EPUB AHEAD OF PRINT. DOI: 10.1016/j.jhin.2018.05.002. [LINK]


Development of this software has been supported by the following grants from the National Institutes of Health (NIH) and Centers for Disease Control and Prevention (CDC):

  • NIH R01HD68395: Statistical Methods for Network Epidemiology (PI: Martina Morris)
  • NIH R21HD075662: Using Sexual Network Transmission Models to Explain HIV Disparities Between Black and White MSM (PI: Steven Goodreau)
  • NIH R01AI108490: Integrated Bio-Social Models for HIV Epidemiology (MPIs: Steven Goodreau, Joshua Herbeck, and John Mittler)
  • NIH R21MH112449: Modeling Antiretroviral-Based Prevention among MSM in the US (PI: Samuel Jenness)
  • NIH P30AI050409: Center for AIDS Research at Emory University (MPIs: Carlos del Rio and James Curran)
  • NIH P30AI027757: Center for AIDS Research at the University of Washington (PI: King Holmes)
  • CDC U38PS004646: Enhancing Models of HIV, Viral Hepatitis, STIs, and Tuberculosis to Inform and Improve Public Health Impact (PI: Patrick Sullivan)
  • NIH P30DA027828: Center for Prevention Implementation Methodology for Drug Abuse and HIV (Ce-PIM) (PI: Henricks Brown and Brian Mustanski)


These materials are distributed under the GPL-3 license, with the following copyright and attribution requirements listed here.