eerandi/JBG060_ZHL_2026
Domain:
climateCreator:
eer
Host:
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 ` …