epiworldR

0.14.0.0

Fast Agent-Based Epi Models

3packages depend

7.2Kdownloads / year

71.1%test coverage

13/13checks pass

Overview

About

Maintained by George Vega YonFirst published 2023-06-0918 releasesCRAN page ↗GitHub ↗

A flexible framework for Agent-Based Models (ABM), the 'epiworldR' package provides methods for prototyping disease outbreaks and transmission models using a 'C++' backend, making it very fast. It supports multiple epidemiological models, including the Susceptible-Infected-Susceptible (SIS), Susceptible-Infected-Removed (SIR), Susceptible-Exposed-Infected-Removed (SEIR), and others, involving arbitrary mitigation policies and multiple-disease models. Users can specify infectiousness/susceptibility rates as a function of agents' features, providing great complexity for the model dynamics. Furthermore, 'epiworldR' is ideal for simulation studies featuring large populations.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("epiworldR", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("UofUEpiBio/epiworldR")

Development version from UofUEpiBio/epiworldR. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-epiworldr

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-epiworldR

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-epiworldR

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 6.9 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.00

71.1%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-04-25
12 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-03-10
11 OK · 3 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 1,119 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 93%
Return-value docs: 97%
References docs: 0%

Downloads

7.2K

CRAN downloads in the past year

Rank #5,219 · ~20/day · ~598/mo

Releases R versions

Daily download trend is not available in this view yet.

39030 days

1.7K90 days

7.2K1 year

Compare downloads with other packages →

Also on625 r2u35 autocran

Repository

GitHub ↗ uofuepibio/epiworldr

14Stars

3Forks

26Open issues

2Open PRs

13Releases

419Commits

8Contributors

abmagent-based-modelingrpackrpkgsimulationcovid-19epidemicsepidemiology

419 commits · Last activity 2026-07-27 · +7.7% stars, 30d

Stars over time

2025-05-27 · 112026-07-13 · 14

Repository practices

Upstream repositoryBeta

8 development-tooling and community-health practices detected across 7 families in the upstream repository

Checks run against github.com/uofuepibio/epiworldr on 2026-07-26.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (2)

MakefileDev Container

Docs source (1)

README.qmd

Research and citation (1)

JOSS paper

Show all practices

Automation and maintenance (1)

pre-commit

Lint, format, editor (1)

RStudio project

Git structural (1)

.gitattributes

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

7 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1.0

Imports (3)

utilsparallelmethods

LinkingTo (1)

cpp11

Suggests (6)

quarto tinytest netplot igraph data.table DiagrammeR

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

3direct

0indirect

measles epiworldRShiny measles epiworldRcalibrate

Code & Tests

People & History

People (7)

Maintainer (1)

George Vega Yon

Author, Maintainer

Authors (3)

George Vega Yon

Author, Maintainer

Derek Meyer

Author

Andrew Pulsipher

Author · added in 0.6.0.0

Funders (1)

Centers for Disease Control and Prevention

Funder

Reviewers (3)

Carinogurjao

Reviewer · added in 0.0-3

Susan Holmes

Reviewer · added in 0.0-3

Abinash Satapathy

Reviewer · added in 0.0-3

Package Timeline

18 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
0.14.0.0Latest
2026-03-28 · current release · diff ↗
0.13.0.0
2026-03-13 · diff ↗
0.12.0.0
2026-02-21 · diff ↗
0.11.2.0
2026-02-03 · diff ↗
0.11.0.1
2026-01-14 · diff ↗
0.11.0.0
2025-12-22 · diff ↗
0.10.0.0
2025-11-14 · diff ↗
0.8.3.0
2025-06-13 · diff ↗
0.8.2.0
2025-05-13 · diff ↗
0.8.1.0
2025-04-23 · diff ↗
R
R 4.5.0 released · 2025-04-11
0.6.1.0
2025-01-29 · diff ↗
0.6.0.0
2025-01-16 · diff ↗
0.3-2
2024-10-08 · diff ↗
R
R 4.4.0 released · 2024-04-24

Show 8 earlier events

0.1-0
2024-04-08 · diff ↗
0.0-4
2024-02-09 · diff ↗
unarchivedReturned to CRAN
2024-02-09
archivedRemoved from CRAN
2024-01-12
issues were not corrected despite reminders
0.0-3
2023-09-08 · diff ↗
0.0-2
2023-06-22 · diff ↗
0.0-1
2023-06-09
R
R 4.3.0 released · 2023-04-21

Package metadata

First published: 2023-06-09
Total releases: 18 / 3 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: 2.1 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Epidemiology

Report a problem with this page →