Skip to content

Welcome to emodpy-malaria

Anopheles mosquito

This documentation set describes how to use EMOD for simulating malaria transmission and interventions and how to use emodpy-malaria for creating model configuration files, submitting simulation jobs to a compute cluster, and more.

Epidemiological MODeling software (EMOD)

EMOD is a stochastic, agent-based model (ABM), developed by the Institute for Disease Modeling (IDM), that simulates the spread of infectious diseases. It models individual humans and mosquitoes and their interactions, making it well-suited for evaluating malaria control strategies across a wide range of transmission settings. See the Malaria Overview for a full description of the model.

If you encounter any issues while using the software, please visit our discussion board.

Upgrading from 5.x

Version 6.0 is a major overhaul of emodpy-malaria. Import paths, API patterns, and the dependency stack have all changed significantly. Projects using emodpy-malaria 5.x or earlier will require substantial restructuring.

  • Migration guide — step-by-step upgrade instructions with before/after code examples
  • Changelog — complete inventory of every file, module, and API change

emodpy-malaria

emodpy-malaria is the primary interface for working with EMOD. It provides the tools to configure the model, define interventions, set up simulation runs, and analyze results — everything a researcher needs to go from a scientific question to a completed simulation.