How baran-oz/dam-flood-simulator works
Dam Flood Simulator is a browser-based exploration tool: users draw a dam axis on a map, choose terrain and dam settings, then receive an estimated flood extent, area, volume, depths, and leak status. App coordinates the interface and analysis; analysis loads terrain tiles, grows its grid as needed, and calls the reservoir engine. The map and side panel present the result, with an optional profile and explanatory dialog. Relationships for unsampled modules rely on the SOURCE INDEX or README; external terrain and basemap requests are documented, but their detailed runtime wiring was not sampled.
Main entry points: App.jsx App coordinator · SidePanel.jsx Settings and results · analysis.js Analysis orchestration · geotiffSources.js GeoTIFF providers
Components 19
User interface
- App coordinator
frontend/src/App.jsx - Error boundary
frontend/src/components/ErrorBoundary.jsx - Settings and results
frontend/src/components/SidePanel.jsx - Terrain picker
frontend/src/components/TerrainPicker.jsx - Dam profile
frontend/src/components/DamProfile.jsx - Method dialog
frontend/src/components/AboutDialog.jsx
Flood analysis
- Analysis orchestration
frontend/src/lib/analysis.js - Reservoir engine
frontend/src/lib/reservoir.js - Flood overlay renderer
frontend/src/lib/overlay.js - Web Mercator helpers
frontend/src/lib/geo.js
Terrain data
- Terrain source catalog
frontend/src/lib/sources.js - Raster tile loader
frontend/src/lib/terrain.js - GeoTIFF providers
frontend/src/lib/geotiffSources.js - Raster tile support
frontend/src/lib/rasterTiles.js
Map display
- Interactive map
frontend/src/components/MapView.jsx - Basemap providers
frontend/src/lib/basemaps.js
Other components
- Dam simulator user
- Terrain data services
- Basemap tile services
Connections 23
- Dam simulator user → App coordinator: sets simulation
README.md - App coordinator → Settings and results: renders controls
frontend/src/App.jsx - App coordinator → Interactive map: renders map
frontend/src/App.jsx - App coordinator → Method dialog: renders dialog
frontend/src/App.jsx - App coordinator → Analysis orchestration: runs analysis
frontend/src/App.jsx - App coordinator → Flood overlay renderer: renders flood overlay
frontend/src/App.jsx - Settings and results → Terrain picker: renders picker
frontend/src/components/SidePanel.jsx - Settings and results → Dam profile: renders profile
frontend/src/components/SidePanel.jsx - Settings and results → Web Mercator helpers: measures dam
frontend/src/components/SidePanel.jsx - Terrain picker → Terrain source catalog: selects source
frontend/src/components/TerrainPicker.jsx - Analysis orchestration → Reservoir engine: simulates flooding
frontend/src/lib/analysis.js - Analysis orchestration → Web Mercator helpers: converts coordinates
frontend/src/lib/analysis.js - Analysis orchestration → Terrain source catalog: uses tile loader
frontend/src/App.jsx - Terrain source catalog → Raster tile loader: creates RGB loaders
frontend/src/lib/sources.js - Terrain source catalog → GeoTIFF providers: creates DEM loaders
frontend/src/lib/sources.js - GeoTIFF providers → Raster tile support: uses raster support
frontend/src/lib/geotiffSources.js - GeoTIFF providers → Raster tile loader: uses terrain plumbing
frontend/src/lib/geotiffSources.js - Raster tile loader → Web Mercator helpers: uses tile size
frontend/src/lib/terrain.js - Raster tile loader → Terrain data services: fetches elevation data
README.md - GeoTIFF providers → Terrain data services: fetches elevation data
README.md - Interactive map → Basemap providers: creates basemap
frontend/src/components/MapView.jsx - Interactive map → Basemap tile services: displays map tiles
README.md - Error boundary → App coordinator: catches UI errors
frontend/src/main.jsx