HIVEC-CM (HIV Epidemic Cameroon Model) is a sophisticated agent-based mathematical model for simulating HIV/AIDS epidemic dynamics in Cameroon from 1990-2100. The model incorporates evidence-based parameters, time-varying interventions, and policy scenarios to support public health decision-making and research.
# HIVEC-CM: HIV Epidemic Cameroon Model
## Overview
HIVEC-CM is an agent-based mathematical model simulating HIV/AIDS epidemic dynamics in Cameroon (1985-2100). The model supports public health policy analysis through detailed demographic tracking, disease progression modeling, and intervention impact assessment.
**Author**: Nkemngu Blake Afutendem
**Institution**: University of Dschang, Cameroon
**Version**: 4.0 (November 2025)
## Key Features
- Agent-based modeling with individual-level tracking
- HIV disease progression through acute, chronic, and AIDS stages
- Treatment and prevention interventions (ART, male circumcision, testing)
- Calibrated against World Bank and UNAIDS data (1990-2022)
- Regional analysis (12 Cameroon regions)
- Age-sex stratification (10 age groups × 2 sexes)
- Policy scenario analysis (9 pre-configured scenarios)
- Web-based visualization interface
## Quick Start
### Installation
```bash
# Clone repository
git clone
github.com
cd -HIVEC-CM-HIV-Epidemic-Cameroon-Model-
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
```
### Run a Simulation
```bash
# Single scenario
./scripts/run_simulation.py --mode single --scenario S0_baseline --population 25000
# All policy scenarios
./scripts/run_simulation.py --mode scenarios --population 50000 --output results/analysis
# Monte Carlo analysis
./scripts/run_simulation.py --mode montecarlo --runs 100 --population 10000
```
### Web Interface
```bash
# Local
streamlit run ui/app.py
# Docker UI (default)
docker-compose -f docker/docker-compose.yml up
# Access at
localhost
# Docker UI (live reload dev mode, mounts local repo)
docker-compose -f docker/docker-compose.yml up hivec-cm-dev
# Access at
localhost; code changes reload without rebuilding
# Docker CLI (example: validation)
do …