Repository to compare LBP intervention impact on HIV infections and pre-term births in South Africa
# HIV-VMB South Africa Model
Agent-based model integrating HIV transmission, bacterial vaginosis (BV) dynamics, and pregnancy outcomes for South Africa, with evaluation of lactobacillus-based probiotic (LBP) interventions.
## Project Overview
This repository contains an epidemiological model that simulates HIV acquisition and progression, BV infection characterized by community state types (CSTs), and pregnancy events including preterm birth risk. The model is calibrated to South African demographic and epidemiological data from 1990-2020.
The primary use case is evaluating the health impact of lactobacillus-based probiotics (LBP) as an intervention to prevent BV-associated adverse pregnancy outcomes. LBP treatment is modeled to stabilize CST composition and reduce preterm birth risk through responder dynamics that account for heterogeneous treatment response.
## License
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
## Repository Organization
```
hiv_vmb_southafrica/
├── run_lbp_valuation_population.py # Population-level LBP valuation
├── run_lbp_valuation_rct.py # RCT-based LBP valuation
├── lbp_valuation_population.qmd # Quarto analysis document
├── model.py # Simulation component factory
├── bv.py # Bacterial vaginosis model
├── pregnancy.py # Pregnancy demographics model
├── connectors.py # HIV-BV disease connector
├── interventions.py # Intervention definitions
├── analyzers.py # Custom result analyzers
├── data/ # Input data files
│ ├── age_dist_*.csv # Age distributions (1990-2020)
│ ├── asfr.csv # Age-specific fertility rates
│ ├── deaths.csv # Mortality data
│ ├── init_prev_hiv.csv # Initial HIV prevalence
│ ├── condom_use.csv # Condom usage data
│ ├ …