calibrate_sir

Optionally initializes the BiLSTM model and then calls
<code>estimate_sir_parameters</code> on the provided data.

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

Sima Najafzadehkhoei

epiworldRcalibrate

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

calibrate_sir function

<dl><dt>daily_cases</dt>
<dd>Numeric vector of length 61 containing daily incidence
counts (day 0 to day 60).</dd>
<dt>population_size</dt>
<dd>Single numeric value giving the total population size.</dd>
<dt>recovery_rate</dt>
<dd>Single numeric value giving the recovery rate parameter.</dd>
<dt>model_dir</dt>
<dd>Optional path to the directory containing the trained
BiLSTM model and scaler files. If <code>NULL</code>, the package's bundled
assets are used.</dd>
<dt>auto_init</dt>
<dd>Logical; if <code>TRUE</code> (default), automatically calls
<code>init_bilstm_model</code> when the model is not yet loaded.</dd></dl>

Arguments

Calibrate SIR Parameters (one-step convenience wrapper) — calibrate_sir

<dl>

<dt>daily_cases</dt>
<dd>Numeric vector of length 61 containing daily incidence
counts (day 0 to day 60).</dd>


<dt>population_size</dt>
<dd>Single numeric value giving the total population size.</dd>


<dt>recovery_rate</dt>
<dd>Single numeric value giving the recovery rate parameter.</dd>


<dt>model_dir</dt>
<dd>Optional path to the directory containing the trained
BiLSTM model and scaler files. If <code>NULL</code>, the package's bundled
assets are used.</dd>


<dt>auto_init</dt>
<dd>Logical; if <code>TRUE</code> (default), automatically calls
<code>init_bilstm_model</code> when the model is not yet loaded.</dd>

</dl>

calibrate_sir: Calibrate SIR Parameters (one-step convenience wrapper)

Description

Usage

Value

Arguments