Tutorials

The emodpy-hiv tutorials introduce you to the key components of configuring, running, and analyzing EMOD-HIV simulations with Python. Each tutorial builds on the previous one, starting from a simple working example and progressively adding features.

Tutorial	Description
Tutorial 1: Run a simulation	Run a baseline Zambia simulation using the built-in country model
Tutorial 2: Add reports and plot results	Add output reports, download results, and plot simulation data
Tutorial 3: Customize with build functions	Write your own build functions to modify the baseline country model
Tutorial 4: Override the cascade of care	Subclass a country model to customize the HIV cascade of care

Before running the tutorials, see Setup to prepare your environment. If you are new to EMOD, read EMOD input files for a brief overview of the configuration, demographics, campaign, and report concepts used throughout the tutorials.

emodpy-workflow

An alternative method for running EMOD-HIV is via the emodpy-workflow tools, which are built on top of emodpy-hiv. emodpy-workflow also has a tutorial so you can compare which approach works better for you.