---
title: Inunda Flood Portfolio
emoji: 🌊
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 8501
pinned: false
short_description: Interactive 3D viewer for GPU flood sims vs USGS gages
---

# Inunda — Flood Validation Portfolio

Interactive **3D viewer** for [Inunda](https://github.com/chrimerss/Inunda) GPU
shallow-water (local-inertial) flood simulations, validated against USGS
streamgages.

- **3D terrain basemap** — deck.gl `TerrainLayer` (AWS Terrarium elevation +
  Esri World Imagery), drag to orbit.
- **Animated flood depth** — per-hour modeled water depth draped on the terrain,
  with a play / pause / scrub timeline (canonical cyan→magenta depth palette, cm).
- **Stream gages** — click a gage marker for its **simulated-vs-observed**
  hydrograph (event water-surface rise above the pre-event baseline) plus NSE,
  rising-limb NSE, peak error and peak-timing metrics.
- **Case switcher** — pick a study region in the sidebar; the map re-centres on it.

Cases: **Brays Bayou / Hurricane Harvey (Aug 2017)** and **Guadalupe River above
Hunt / Kerr County flood (Jul 2025)**.

### How it works
Each case is pre-rendered (`build/preprocess.py`) from the simulation Zarr store
into a compact `src/assets/<case>.json`: transparent depth-frame PNGs georeferenced
by the store's own CRS + GeoTransform (reprojected to a lon/lat quad for deck.gl),
plus per-gage hydrographs from the canonical
[`chrimerss/inunda-portfolio`](https://huggingface.co/datasets/chrimerss/inunda-portfolio)
dataset. The Space ships only those light assets — no Zarr at runtime.