rashiedomar/listen-to-the-river

Listen to the River is a satellite-based flood analysis project focused on Somali river systems, with a published Baladweyne 2023 case study that combines optical water mapping, SAR change analysis, and impact-layer storytelling in one web dashboard. # Listen to the River `Listen to the River` is a satellite-based flood analysis project focused on Somali river systems, with a published Baladweyne 2023 case study that combines optical water mapping, SAR change analysis, and impact-layer storytelling in one web dashboard. ## Published focus This first public repo pass is centered on: - the Baladweyne, Somalia flood event of November 2023 - a cleaned static web dashboard under `baladweyne-2023/ui/` - the supporting scripts, summaries, and lightweight geodata needed to explain and reproduce the published case study surface The broader early-warning research workspace exists, but the heavier local-only processing branches and raw rasters are intentionally excluded from the public repo surface. ## What this project does The Baladweyne case study was built to answer a practical question: `What flood story can be defended when optical, radar, and impact layers are combined into one interpretable event map?` The published workflow uses: - `Sentinel-2` water detection to establish the main event footprint - `Sentinel-1` pre/post-event change analysis to recover additional flood fringe context - agreement filtering between the two sources to isolate a stricter confidence core - impact overlays against roads, buildings, and named places to translate water extent into human relevance ## Baladweyne 2023 summary Current tracked summary from the published event pack: - final story mask: `196.03 km²` - strict S1/S2 overlap core: `72.60 km²` - selected SAR-only extensions: `92.35 km²` - total affected buildings: `6,460` - total affected roads: `542` - total affected named places: `19` These numbers are stored in: - `baladweyne-2023/analysis/final_story_mask/summary.json` - `baladweyne-2023/analysis/final_story_impacts/impact_summary.json` - `baladweyne-2023/analysis/mask_consensus/summary.json` ## Repository layout - `baladweyne-2023/` - published event case study - `baladweyne-2023/ui/` - static dashboard …