Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



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.


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

Additional contributors to the EpiModel package include Emily Beylerian, Skye Bender-deMoll, and Kevin Weiss.


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")

Documentation and Support

Website. The main website for EpiModel, with tutorials and other supporting files is http://epimodel.org/.

Methods Paper. 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.

Summer Course. Network Modeling for Epidemics is our annual 5-day course at the University of Washington where we teach the statistical theory, software tools, and applied modeling methods using EpiModel. Our course materials [LINK] are fully open-source and updated annually around the time of the course.

Email listserv. 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.

The EpiModel Gallery

We recently started a new EpiModel Gallery that contains templates of extensions to EpiModel, for now focused on network-based mathematical models. We will be continuing to add new examples the gallery, and encourage users to either file requests for new examples or contribute them following our guidelines.


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 (samuel.m.jenness@emory.edu) if you have used EpiModel in your work so we can add the citation below.


The primary support for the development of these software tools and statistical methods has been by two National Institutes of Health (NIH) grants:

  • NIH R01 AI138783: EpiModel 2.0: Integrated Network Models for HIV/STI Prevention Science.
  • NIH R01 HD68395: Statistical Methods for Network Epidemiology (PI: Martina Morris)

Our applied research projects using EpiModel have received funding from the NIH and Centers for Disease Control and Prevention (CDC):

  • NIH R21 MH112449: Modeling Antiretroviral-Based Prevention among MSM in the US (PI: Samuel Jenness)
  • NIH R21 HD075662: Using Sexual Network Transmission Models to Explain HIV Disparities Between Black and White MSM (PI: Steven Goodreau)
  • NIH R01 AI108490: Integrated Bio-Social Models for HIV Epidemiology (MPIs: Steven Goodreau, Joshua Herbeck, and John Mittler)
  • CDC U38 PS004646: Enhancing Models of HIV, Viral Hepatitis, STIs, and Tuberculosis to Inform and Improve Public Health Impact (PI: Patrick Sullivan)

Our team also receives institutional support through the following center-level NIH grants:

  • NIH P30 AI050409: Center for AIDS Research at Emory University (MPIs: Carlos del Rio and James Curran)
  • NIH P30 AI027757: Center for AIDS Research at the University of Washington (PI: King Holmes)
  • NIH P30 DA027828: Center for Prevention Implementation Methodology for Drug Abuse and HIV (Ce-PIM) (PI: Henricks Brown and Brian Mustanski)

Uses of EpiModel in the Scientific Literature

EpiModel and its extension packages have been used in the following scientific journal articles. (If you are aware of others, send us an email at samuel.m.jenness@emory.edu to be included in this list.)

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. 2018; 47(1): 236-245. [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. 2018; 62(3): 311-319. [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. 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].

  3. 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]

  4. White LA, Forester JD, Craft ME. Covariation between the physiological and behavioral components of pathogen transmission: Host heterogeneity determines epidemic outcomes. Oikos. 2018; 127(4): 538-52. [LINK].

  5. 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; 285(1870): 20171899. [LINK].

  6. 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. 2018. Epub DOI: 10.1016/j.jhin.2018.05.002. [LINK]

  7. 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].

  8. Amirpour Haredasht S, Tavornpanich S, Jansen MD, Lyngstad TM, Yatabe T, Brun E, Martínez-López B. A stochastic network-based model to simulate the spread of pancreas disease (PD) in the Norwegian salmon industry based on the observed vessel movements and seaway distance between marine farms. Prev Vet Med. 2018. Epub DOI: 10.1016/j.prevetmed.2018.05.019. [LINK]


These materials are distributed under the GPL-3 license, with the following copyright and attribution requirements listed in the LICENSE document above.