TAMARAW is our Philippines dengue modeling project. It couples a climate-forced vector-host transmission model with lightweight ETL so dengue risk can be monitored weekly at the city or barangay level and exported to dashboards or reports. The initial release provides a single-node SEI-SEIR demonstration driven by temperature and rainfall; the framework is designed to expand into a metapopulation with mobility, interventions, and observation models. The current demo implements temperature-dependent biting and extrinsic incubation, rainfall-driven adult recruitment, and a simple post-week-40 reduction in biting to mimic repellents or community action. All components are pure Python and run in seconds, making it easy to iterate with field teams.
Humans follow a susceptible–exposed–infectious–recovered (SEIR) progression: \( S_h \to E_h \to I_h \to R_h \), while mosquitoes follow a susceptible–exposed–infectious (SEI) progression \( S_m \to E_m \to I_m \).
The temperature-dependent biting \( a(T) \), mosquito-to-human ratio \( m \), and the infectious fraction \( I_m / N_m \) together determine the force of infection from mosquitoes to humans. Rainfall enters through \( \Lambda_m(R) \), which modulates adult mosquito recruitment and thus scales the available vector population. Temperature also modifies extrinsic incubation \( \sigma_m(T) \) and mortality \( \mu_m(T,R) \), so the overall transmission potential reflects the combined, multiplicative influence of biting, recruitment, and survival. Lag times can be added as needed (e.g., 1–8 weeks for rainfall) to capture delayed effects.
| Symbol | Description | Units / Typical Range |
|---|---|---|
| \( \beta \) | Transmission probability per bite | – (dimensionless, often 0.2–0.5) |
| \( a(T) \) | Temperature-dependent biting rate of mosquitoes | bites·mosquito⁻¹·day⁻¹ (≈0.2–0.5) |
| \( m = N_m / N_h \) | Mosquito-to-human population ratio | – (typically 1–10) |
| \( N_m, N_h \) | Total mosquito and human populations | individuals |
| \( \sigma_h \) | Rate of progression from exposed to infectious (humans) | day⁻¹ (≈1/5–1/7) |
| \( \gamma_h \) | Recovery rate of humans | day⁻¹ (≈1/5–1/10) |
| \( \Lambda_m(R) \) | Rainfall-dependent adult mosquito recruitment rate | mosquitoes·day⁻¹ |
| \( \sigma_m(T) \) | Temperature-dependent extrinsic incubation rate | day⁻¹ (≈1/5–1/10) |
| \( \mu_m(T,R) \) | Temperature- and rainfall-dependent mosquito mortality rate | day⁻¹ (≈0.05–0.2) |
| \( c \) | Transmission probability from human to mosquito per bite | – (≈0.3–0.7) |
Start with daily T/R, aggregate to weekly means/sums, and create lagged features. Observation models (e.g., negative binomial with reporting fraction) plug in later.
dengue_model.py, run_ph_dengue_demo.py).