HYDRA2DGPU
CUDA-accelerated shallow-water equation solver inside QGIS
v0.3.0
MIT License
Linux / Windows
HYDRA2DGPU is a QGIS plugin for 2D shallow water equation (SWE) modeling with a CUDA-accelerated finite-volume solver. It brings real-time 2D flood simulation into the QGIS map canvas — coupling surface hydrodynamics with 1D urban drainage networks, hydraulic structures, and rainfall/infiltration, with no external tools needed.
Features
- GPU-accelerated solver — CUDA finite-volume with graph caching
- Unstructured mesh FVM — triangles, quads, polygons (Gmsh or built-in)
- Multiple spatial schemes — first-order, MUSCL, WENO5
- Multiple temporal schemes — Euler, RK2, RK4
- Boundary conditions — wall, inflow, stage, open, hydrograph
- 1D drainage coupling — SWMM-style pipes, culverts, weirs, gates, bridges, pumps
- Rainfall & infiltration — rain-on-grid with SCS Curve Number
- Results export — GeoPackage, UGRID NetCDF, GeoTIFF, CSV
- Headless CLI + batch simulation for parameter sweeps
Gallery
Requirements & Install
Requirements
| Component | Requirement |
|---|---|
| QGIS | 3.28+ |
| Python | 3.12+ |
| GPU | NVIDIA, Compute Capability ≥ 7.5 (no CPU fallback) |
| OS | Linux (x86_64) or Windows (x86_64) |
Install
- Download the plugin zip from GitHub Releases.
- In QGIS, install it via Plugins → Manage and Install Plugins → Install from ZIP.
- On first launch, HYDRA2DGPU downloads and installs the matching backend wheel for your platform automatically.
AI & Automation
Agent-assisted modeling
HYDRA2DGPU ships with a built-in MCP server that lets AI assistants drive the full workflow inside QGIS — build models, run parameter sweeps, inspect results, and control the Studio GUI. A headless CLI enables batch simulation for parameter sweeps.
This builds on the same automation research as my automated culvert characterization study for MoDOT.