How alpinistpanda/flood-twin-lab works
This repository is a teaching flood-twin web application: a browser presents replayed Tambaram sensor readings, alerts and maps, alongside static 100-year flood-scenario layers. The principal workflow is sensor data → API replay → shared browser feed and level classification → table or interactive map; map users can also inspect sensor history and explore flood exposure over time. The API, map, sensor classification and flood-layer behavior are evidenced in sampled source. Feed internals and some UI wiring were not sampled, so those connections are omitted or marked unverified.
Main entry points: +page.svelte Map page route · MapLibreMap.svelte MapLibre view · scenario.js Flood layer logic · feed.svelte.js Shared live feed
Components 17
Sensor replay API
- Sensor API
api/main.py - Sensor readings
data
Web app and feed
- App shell
app/src/routes/+layout.svelte - Shared live feed
app/src/lib/feed.svelte.js - Level classification
app/src/lib/sensors.js - Sensor table
app/src/routes/sensors/+page.svelte
Map and flood views
- Map page route
app/src/routes/maplibre/+page.svelte - Map layout
app/src/lib/MapPage.svelte - MapLibre view
app/src/lib/MapLibreMap.svelte - Layer selection
app/src/lib/layers.svelte.js - Sensor detail popup
app/src/lib/SensorDetail.svelte - History charts
app/src/lib/SensorChart.svelte - Flood time slider
app/src/lib/FloodTimeBar.svelte
Flood scenario data
- Flood layer logic
app/src/lib/scenario.js - Flood model files
app/static/layers
Other components
- App user
- Basemap tiles
Connections 18
- App user → App shell: opens app
README.md - Sensor API → Sensor readings: loads readings
api/main.py - App shell → Shared live feed: starts feed
app/src/routes/+layout.svelte - Shared live feed → Sensor API: fetches feed
README.md - Sensor table → Shared live feed: reads shared state
app/src/routes/sensors/+page.svelte - Sensor table → Level classification: uses levels
app/src/routes/sensors/+page.svelte - Map page route → Map layout: renders
app/src/routes/maplibre/+page.svelte - Map page route → MapLibre view: renders
app/src/routes/maplibre/+page.svelte - Map page route → Shared live feed: passes sensor data
app/src/routes/maplibre/+page.svelte - Map page route → Layer selection: passes layer state
app/src/routes/maplibre/+page.svelte - Map page route → Flood time slider: shows when enabled
app/src/routes/maplibre/+page.svelte - MapLibre view → Sensor detail popup: mounts on click
app/src/lib/MapLibreMap.svelte - Sensor detail popup → History charts: displays history
README.md - MapLibre view → Flood layer logic: calls layer and query functions
app/src/lib/MapLibreMap.svelte - Flood time slider → Flood layer logic: loads time metadata
app/src/lib/FloodTimeBar.svelte - Flood layer logic → Flood model files: reads flood layers
app/src/lib/scenario.js - Flood layer logic → Level classification: uses level colours
app/src/lib/scenario.js - MapLibre view → Basemap tiles: loads basemap style
app/src/lib/MapLibreMap.svelte