Operational SAR Flood Mapping as a Full-Stack Systems Problem: An AI-Enabled Perspective

This repository contains the **evaluation scripts, workflow notes, and derived summary outputs** used to support the manuscript: **Operational SAR Flood Mapping as a Full-Stack Systems Problem: An AI-Enabled Perspective** The materials document the comparative evidence package used to evaluate the **SIENA** flood-mapping workflow across three settings: 1. **West Coast atmospheric-river case (December 2025)** Comparison of SIENA against earlier operational candidate algorithms using **NOAA VIIRS Flood Inundation Maps (VIIRS-FIM)** as a common coarse reference. This workflow includes: - per-granule binary flood metrics, - false-alarm behavior analysis, - process-time extraction and visualization, - manuscript-ready summary outputs. 2. **Kentucky flood case (April 2025)** Comparison of SIENA against **NOAA Emergency Response Imagery (ERI)** airborne RGB mosaics for event-specific spatial consistency analysis. This workflow includes: - tile-based SIENA vs ERI comparison, - coverage-aware confusion statistics, - area-fraction analysis, - curated representative figure selection, - manuscript-ready summary outputs. 3. **Central Valley, California multi-date case (winter 2025–2026)** Three-way comparison among **SIENA**, **NASA OPERA DSWX-HLS**, and **NOAA VIIRS-FIM** over a fixed regional domain. This workflow includes: - pairwise inter-product metrics, - pooled and per-date summaries, - flood-subset summaries, - wet-fraction scatter analysis, - curated comparison figures, - manuscript-ready summary outputs. ## Repository contents The archive is organized into three main task folders: - `SIENA_VIIRS_6Panels_metric/` West Coast VIIRS-based evaluation and process-time analysis - `SIENA_NOAA_eri_metric/` Kentucky SIENA vs NOAA ERI evaluation - `SIENA_DSWX-HLS_VIIRs_CA/` Central Valley SIENA / DSWX-HLS / VIIRS three-way comparison Within these folders, the repository includes:- Python analysis scripts- shell wrappers for running the workflows- `WORKFLOW.md` files documenting methods, assumptions, thresholds, and outputs- plotting utilities- figure-curation utilities- scripts for generating Word-format summary documents- derived CSV summaries and figure products where included in the packaged archive ## Purpose These materials are intended to provide a **transparent, manuscript-linked record of the comparative evaluation workflows** used in the SIENA case study. The repository is not presented as a polished standalone software release for general operations. Instead, it serves as a **research-support archive** for the quantitative analyses, figure generation, and summary reporting referenced in the manuscript and supplementary materials. ## Important notes - The workflows rely on external flood products and imagery sources, including **NOAA VIIRS-FIM**, **NOAA ERI**, and **NASA OPERA DSWX-HLS**.- Some scripts assume access to local project directory structures, cached ancillary datasets, and previously generated intermediate products.- Thresholds, valid-domain rules, permanent-water masking conventions, and aggregation logic are documented in the included `WORKFLOW.md` files.- The repository emphasizes **comparative evaluation and manuscript reproducibility support**, rather than one-click reproduction in a fully containerized environment. ## Related manuscript use This archive supports the manuscript’s comparative evidence package by documenting and preserving the workflows used to assess:- operational behavior,- false-alarm discipline,- inter-product consistency,- event-specific spatial agreement,- and runtime characteristics of the SIENA rebuild.