Skip to content

README.md

Latest commit

 

History

History
77 lines (66 loc) · 2.38 KB

README.md

File metadata and controls

77 lines (66 loc) · 2.38 KB
Raw

Wflow-ML-Flood-Forecasting

Overview

A physics-informed hydrological forecasting system for the Upper Niger Basin, integrating Wflow SBM with Machine Learning for flood prediction.

Project Structure

Wflow-ML-Flood-Forecasting/
├── data/
│   ├── static/              # DEM, flow direction, slope (from SRTM)
│   └── processed/           # ERA5 daily forcing
├── notebooks/
│   ├── 00_static_data_acquisition.ipynb  # Download SRTM, derive LDD
│   ├── 01_data_acquisition.ipynb         # ERA5-Land forcing
│   └── 02_wflow_model_build.ipynb        # Model inspection
├── models/wflow_sbm/wflow_niger/
│   ├── staticmaps.nc        # Static model parameters
│   ├── inmaps.nc            # ERA5 forcing (precip, temp, PET)
│   ├── cyclic_lai.nc        # Monthly LAI climatology
│   └── wflow_sbm.toml       # Wflow configuration
├── scripts/
│   ├── create_model_files.py
│   └── verify_model.py
└── requirements.txt

Model Domain

  • Region: Upper Niger Basin (Guinea/Mali)
  • Bbox: [-10.5°, 9.5°, -6.5°, 13.0°]
  • Resolution: 0.1° (~10 km)
  • Period: 2019-01-01 to 2020-02-29

Data Sources

Dataset Source Resolution
DEM CGIAR SRTM 90m 90m
Flow Direction Derived (pyflwdir) 0.1°
Forcing ERA5-Land 0.1° daily
LAI Synthetic climatology Monthly

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Download Static Data

Run notebooks/00_static_data_acquisition.ipynb or:

python scripts/create_model_files.py

3. Run Wflow Simulation

Requires Julia + Wflow.jl:

cd models/wflow_sbm/wflow_niger
julia -e "using Wflow; Wflow.run(\"wflow_sbm.toml\")"

Notebooks

# Notebook Description
00 00_static_data_acquisition Download SRTM, derive flow direction
01 01_data_acquisition ERA5-Land forcing download
02 02_wflow_model_build Model inspection and visualization

Model Configuration

  • Type: Wflow SBM (Soil-Bucket Model)
  • Routing: Kinematic wave
  • Timestep: Daily (86400 s)
  • Snow: Disabled (tropical region)

Output Variables

  • q_river: River discharge (m³/s)
  • satwaterdepth: Saturated zone depth
  • ustorelayerdepth: Unsaturated storage