eerandi/JBG060_ZHL_2026

Repository for the course JBG060 in collaboration with ZHL in 2026, investigating flood dynamics in South Sudan # JBG060-2026: Flood Dynamics in South Sudan ## Introduction and overview This repository supports the 2026 JBG060 course project on flood dynamics in South Sudan. Its current scope is data loading and preprocessing: it brings hydrometeorological hazard data together with exposure and impact data so that they can be used in later flood-risk analyses. The repository currently provides utilities for: - river discharge, lake levels, rainfall, runoff, evapotranspiration, and flood masks; - administrative boundaries, population, roads, health facilities, cattle, cropland, rangeland, GDP, and food-insecurity data; - spatial subsetting by coordinate or bounding box; and - converting selected raw inputs into pandas, GeoPandas, Xarray, or NetworkX objects. This is not yet an end-to-end flood model or a complete reproducible analysis pipeline. The two Python files contain loader functions and executable demonstrations. ## Repository structure ```text JBG060-2026/ |-- processing_data/ | |-- loading.py # Hydrometeorological data loaders | `-- loading_impact_data.py # Exposure and impact data loaders |-- literature/ # Supporting papers and data documentation |-- raw_data/ # External download; ignored by Git |-- requirements.txt # Pinned Python dependencies |-- .gitignore `-- README.md ``` Running the evapotranspiration processor creates `processing_data/evapotranspiration/`. Both that generated directory and `raw_data/` are excluded from Git. ## Requirements and installation - Git - Python 3.12 or newer All Python dependencies and their versions are listed in `requirements.txt`. ### 1. Fork and clone the repository First, open the course repository on GitHub. Select **Fork** in the top-right corner, choose your GitHub account as the owner, and create the fork. This gives you your own copy of the course repository where you can commit and push your work. Then clone **your fork** (replace ` …