epi-epydemic-spread

What problem does it solve?

Biodefense researchers need an end-to-end workflow to simulate epidemic scenarios using an epydemic SIR model over a synthetic contact network, enabling testing and validation of outbreak parameters when weaponized pathogens are considered.

Core Features & Use Cases

• End-to-end SIR network simulations on Erdős–Rényi graphs with configurable transmission, recovery, and fatality rates.
• Validation against a minimum attack-rate target to ensure realistic epidemic behavior across scenarios.
• Ready-to-run templates and prompting resources to guide scenario design and exploration in educational and research settings.

Quick Start

Run the included simulate_spread.py with outbreak_scenarios.yaml to validate epidemic attack rates.