Learn R Programming

epiworldRcalibrate

epiworldRcalibrate: Fast and Effortless Calibration of Agent-Based Models using Machine Learning

From the DESCRIPTION:

The 'epiworldRcalibrate' package provides tools and pre-trained Machine Learning [ML] models for calibration of Agent-Based Models [ABMs] built with the R package 'epiworldR'. It implements methods described in Najafzadehkhoei, Vega Yon, Modenesi, and Meyer (2025) doi:10.48550/arXiv.2509.07013. Using 'epiworldRcalibrate', users can automatically calibrate ABMs in seconds with its pre-trained ML models, effectively focusing on simulation rather than calibration. This tool bridges a gap by allowing public health practitioners to run their own ABMs without the advanced technical expertise often required by calibration.

epiworldRcalibrate provides fast, data-driven calibration of SIR epidemic parameters using a pretrained Bidirectional LSTM (BiLSTM) model. Given a single incidence time series, the package estimates:

  • Transmission rate (ptran)
  • Contact rate (crate)
  • Basic reproduction number (R0)

The package is fully integrated with epiworldR and requires no external Python setup.


Copy Link

Version

Install

install.packages('epiworldRcalibrate')

Monthly Downloads

290

Version

0.1.4

License

MIT + file LICENSE

Issues

Pull Requests

Stars

Forks

Maintainer

Sima Najafzadehkhoei

Last Published

April 2nd, 2026

Functions in epiworldRcalibrate (0.1.4)

check_model_status

Check model status
.ensure_python_ready

Ensure Python + necessary modules are ready (no auto-install)
calibrate_sir

Calibrate SIR Parameters (one-step convenience wrapper)
cleanup_model

Unload the model from memory
abc_calibration_params

ABC calibration results for COVID-19 SIR model
.verify_python_imports

Verify module imports using reticulate's active Python
.resolve_python_target

Resolve the Python target used by package setup and diagnostics
.required_python_modules

Return required Python module names
.required_python_packages

Return required Python package names for installation
check_python_setup

Check Python and package installation status
estimate_sir_parameters

Estimate SIR Parameters from 61-day incidence
setup_python_deps

Set up Python dependencies for epiworldRcalibrate
init_bilstm_model

Initialize BiLSTM Model for SIR Parameter Estimation
epiworldRcalibrate-package

epiworldRcalibrate: Fast and Effortless Calibration of Agent-Based Models using Machine Learning
utah_covid_data

Utah COVID-19 epidemic trends