Skip to content

UofUEpiBio/epiworldRShiny

Repository files navigation

epiworldRShiny: A ‘shiny’ Wrapper of the R Package ‘epiworldR’

R-CMD-check CRAN status

This R package provides a user-friendly application for epiworldR, a wrapper of the C++ library epiworld. It provides a general framework for modeling disease transmission using agent-based models. Some of the main features include:

  • Fast simulation with an average of 30 million agents/day per second.
  • 9 different epidemiological models to choose from.
  • Built-in capability for user-defined interventions.
  • Built-in capability to define population and disease parameters.
  • Informative visualizations and tables after running each simulation.

You can find more examples on the package’s website: https://uofuepibio.github.io/epiworldRShiny/

Installation

You can install the development version of epiworldRShiny from GitHub with:

devtools::install_github("UofUEpiBio/epiworldRShiny")

Or from CRAN

install.packages("epiworldRShiny")

To run this ShinyApp, you need to type the following:

epiworldRShiny::run_app()

Examples

Example #1

This first example demonstrates how to run the Shiny app, run a simulation, and observe results. Notice the sidebar contains many disease and model parameters that can be altered. Changing these parameters will affect the spread of the infectious disease in the simulated population. After running the simulation, a plot of the distribution of states over time, a plot of the disease’s reproductive number, a model summary, and a table of counts over time are displayed.

This example features: - SEIR network model for COVID-19
The day of peak infections occurs on day 12, maxing at about 18,000 infections.

  • The disease spreads rapidly at the simulation’s beginning, drastically decreasing over the first ten days.
  • Model summary
  • State counts table
example 1 GIF example 1 GIF

Example #2

This example features the implementation of the vaccine and school closure interventions to curb disease spread. All model output can be interpreted using the same logic from example #1.

Key features: - SEIRD network model for COVID-19

  • Vaccine prevalence = 70%
  • School closure prevalence = 50%
  • Day of school closure implementation = 7
  • Significantly decreased number of infections and deaths.
  • The majority of the population recovered or was susceptible by day 30.
example 2 GIF example 2 GIF

Example #3

The last example features the SEIR equity model. This model is unique because it accounts for demographic diversity in a population, such as race, gender, and age. This allows for comparing disease spread among different demographics, unlike the previous two examples.

Key features: - SEIR equity model for COVID-19 - 30% hispanic population, 70% non-hispanic - 52% female population - 30% of population younger than 20 years old - 30% of population between 20 and 60 years old - 40% of population older than 60.

example 3 GIF example 3 GIF