epiworldRShiny
A 'shiny' Wrapper of the R Package 'epiworldR'
R 'shiny' web apps for epidemiological Agent-Based Models. It provides a user-friendly interface to the Agent-Based Modeling (ABM) R package 'epiworldR' (Meyer et al., 2023)
epiworldRShiny: A ‘shiny’ Wrapper of the R Package ‘epiworldR’
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")
Running the ShinyApp
To run the app with only built-in models, use:
epiworldRShiny::run_app()
To add additional custom models, use:
epiworldRShiny::run_app(custom_models_path = "path/to/custom/models")
Note that custom models must follow the guidelines given in inst/models/README.md.
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 #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 #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.