Josephnyingi/stunting-risk-dashboard

Childhood stunting risk screening for Rwanda — calibrated logistic regression on 2,500 synthetic NISR-style households, Streamlit choropleth dashboard, counterfactual What-If simulator, and bilingual A4 PDFs with QR codes for offline community health workers. # S2.T1.2 · Stunting Risk Heatmap Dashboard **AIMS KTT Hackathon · Tier 1 · HealthTech / Geospatial / Data Viz** **Author: Joseph Nyingi Wambua** --- ## 🚀 Live Demo & Model | | Link | |---|---| | **▶ Interactive Dashboard** | **huggingface.co | | **Model (scorer.pkl + card)** | huggingface.co | | **4-minute video** | youtu.be | --- ## ✨ Three Innovations (beyond baseline) > These features are live in the interactive dashboard and in the PDF outputs in `printable/`. ### 1 · Counterfactual What-If Simulator (Tab 5 of the dashboard) Policy planners can run four interventions — **piped water for all**, **improved sanitation for all**, **income uplift for high-risk**, **extra daily meal for high-risk** — and instantly see how many households graduate out of high-risk: | Intervention | Cost/HH | Simulated effect (example — Kibilizi) | | --- | --- | --- | | 💧 Provide piped water to all | $150 | −16 pp high-risk rate | | 🚽 Upgrade sanitation to improved | $80 | −12 pp high-risk rate | | 💰 Income support (+1 band, high-risk only) | $50 | −6 pp high-risk rate | | 🍽 Nutrition: +1 meal/day (high-risk only) | $30 | −4 pp high-risk rate | The simulator modifies the raw household feature DataFrame, passes it back through the loaded logistic-regression model (`scorer.pkl`), and displays a **before/after bar chart**, a **KPI row** (households graduated, risk reduction), and a **graduation table** of households that cross the 0.50 threshold. Counterfactual rescoring is live — no pre-computed lookup table. ### 2 · QR Codes on Printable A4 Sector PDFs Every sector PDF (`printable/sector_ .pdf`) now embeds a QR code linking directly to the live dashboard filtered to that sector: ``` huggingface.co ``` A village chief without a laptop can hand the sheet to any smartphone user and immediately open the in …