mtk339900/water_scarcity_repo

Initial commit: Water Scarcity Analysis — Egypt & North Africa # 💧 Water Scarcity Analysis — Egypt & North Africa > A full-stack data science project that analyses groundwater depletion across Egypt and North Africa using NASA GRACE-FO satellite data, a high-performance C++ simulation engine, and machine-learning forecasting models — all wrapped in an interactive Streamlit dashboard. --- ## 📋 Table of Contents - Project Overview - Why This Problem? - Architecture - Project Structure - Quick Start - Phase Details - Results - Dashboard - Tech Stack - Contributing - License --- ## 🌍 Project Overview The Middle East and North Africa face one of the world's most severe water crises. Egypt and its neighbours draw on ancient underground aquifers — the Nubian Sandstone Aquifer System being the largest — that recharge at **5 mm per year** while being extracted at rates many times higher. This project builds a complete analysis pipeline in four phases: | Phase | Component | Key Output | |-------|-----------|------------| | 1 | **Data Layer** | 264-month GRACE-style dataset · 130-point spatial grid | | 2 | **C++ Engine** | Darcy groundwater flow simulator · 375× faster than Python | | 3 | **ML Models** | LSTM forecaster (MAE 8.5 mm) · Random Forest classifier (AUC 0.9998) | | 4 | **Dashboard** | Interactive Streamlit app · standalone HTML dashboard | --- ## ❓ Why This Problem? - **17** Arab countries suffer acute water scarcity - **80 %** of the region's water goes to agriculture — often inefficiently - The Nubian Basin loses an estimated **5 mm of water equivalent per year** (NASA GRACE-FO) - Existing monitoring tools are either proprietary, inaccessible, or not open-source This project demonstrates how open data + scientific computing + ML can produce actionable early-warning insights. --- ## 🏗️ Architecture ``` ┌─────────────────────────────────────────────────────────┐ │ Water Scarcity Monitor │ ├──────────┬──────────────┬────────────────┬──────────────┤ │ 📡 Data │ ⚙️ C++ │ …