SIACalendarProcess#

class SIACalendarProcess(model, verbose=False, params=None)[source]#

Bases: BasePhase

Phase for implementing Supplementary Immunization Activities (SIAs) based on a calendar schedule.

This component: 1. Groups nodes by geographic level using the same aggregation schema as CaseSurveillanceTracker 2. Implements SIAs at scheduled times by vaccinating individual agents 3. Uses the model’s current_date to determine when to implement SIAs 4. Applies vaccination with configurable efficacy rate to individual agents

Parameters:

  • model (ABMModel) – The ABM simulation model containing agents, patches, and parameters

  • verbose (bool) – Whether to print verbose output during simulation

  • params (SIACalendarParams | None) – Component-specific parameters. If None, will use default parameters

Notes

  • SIA efficacy determines the fraction of susceptibles that get vaccinated

  • Individual agents are randomly selected for vaccination based on efficacy

  • SIAs are implemented when the model’s current_date has passed the scheduled date

  • Vaccination moves agents from susceptible (S=0) to recovered (R=3) state

  • Both individual agent states and patch-level state aggregations are updated

  • Each SIA is implemented exactly once

Initialize the component.

Parameters:

  • model (ABMModel) – The model instance this component belongs to.

  • verbose (bool) – Whether to enable verbose output. Defaults to False.

__call__(model, tick)[source]#

Execute component logic for a given simulation tick.

Parameters:

  • model (ABMModel) – The model instance.

  • tick (int) – The current simulation tick.

Return type:

None

get_sia_schedule()[source]#

Get the SIA schedule.

Returns:

DataFrame with columns: - {group_column}: Group identifier - {date_column}: Scheduled date for SIA

Return type:

DataFrame