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.