Welcome to emodpy-hiv

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

Epidemiological MODeling software (EMOD)

EMOD has been used to evaluate the impact of HIV programs — including antiretroviral therapy scale-up, voluntary male circumcision, and pre-exposure prophylaxis — before large-scale investment. It has informed national HIV strategies across sub-Saharan Africa and guided resource allocation decisions by governments and global health organizations.

For researchers and modelers, EMOD is a stochastic, agent-based model (ABM) developed by the Institute for Disease Modeling (IDM) that simulates sexual and vertical HIV transmission at the individual level. It is used to evaluate the cost and impact of treatment and control programs across national-level epidemics. See HIV Overview for a full description of the model.

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

emodpy-hiv

emodpy-hiv 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.

emodpy-workflow

emodpy-workflow is built on top of emodpy-hiv and provides an alternative approach for working with EMOD. It is a collection of commands and interfaces intended to support data-driven scientific computing workflows. Its core standardizes the process of creating, calibrating, running, and obtaining output from EMOD-HIV model scenarios, making it easier for teams to collaborate and work with each other's projects. Users who previously ran EMOD-HIV using DtkTools will find emodpy-workflow's approach more familiar.