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 four evaluation 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, 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.

4. Event-based SIENA / DSWX-S1 / VIIRS-FIM case (December 2025–May 2026)

   Event-based comparison among SIENA, DSWX-S1, and NOAA VIIRS-FIM across three representative flood episodes: the Snohomish River event near Seattle, the Jackson County, Indiana event, and the Alaska Yukon River event.

   This workflow includes: pooled per-event inter-product metrics; flood-subset summaries; event-window tracking; comparison summaries across multiple flood settings; manuscript-ready summary outputs.

Repository contents

The archive is organized into four 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

SIENA_VIIRS_DSWX-S1_events/ — Event-based SIENA / DSWX-S1 / VIIRS comparison across three representative flood episodes

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, DSWX-HLS, and DSWX-S1.

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.

This archive contains the evaluation workflows, analysis scripts, plotting utilities, and derived summaries supporting the manuscript comparisons. It does not constitute a full release of the operational SIENA production system or all agent configurations.

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, flood-setting-dependent comparison behavior, and runtime characteristics of the SIENA rebuild.