disasters

An automated workflow for generating disaster response maps and layouts over a user-defined AOI using NASA-JPL OPERA products.

Overview

This tool streamlines the generation of data to support disaster response efforts using NASA-JPL OPERA products. It automates the discovery, download, mosaicking, and visualization of products related to:

• Flooding (e.g., DSWx-HLS)
• Wildfires (e.g., DIST-ALERT-HLS)
• Earthquakes (e.g., CSLC, DISP) (coming soon)

The output includes ready-to-share maps and analysis-ready GeoTIFFs for any user-defined region and event type. Currently flood and wildfires are supported (earthquakes coming soon).

Development setup

Requirements

• Python 3.9+
• Mamba or Conda
• Git

We recommend using Mamba for faster environment setup.

Prerequisite installs

1. Download source code:

git clone https://github.com/cmspeed/disasters

2. Navigate to and install dependencies, using the included environment.yml file:

cd disasters
mamba env create --file environment.yml
mamba activate disasters

The provided environment.yml file sets up a fully functional environment with all required packages.

Usage

Example: Generate flood maps over Lake Mead, Nevada using the two most recent OPERA products

python disaster.py -b 35 37 -115 -113 -o LakeMead -m flood -n 2 -lt "Lake Mead Floods"

Example: Generate fire impact maps over New Mexico using the five (default) most recent OPERA products

python disaster.py -b 32 34 -106.5 -104 -o NM_Fires -m fire -lt "New Mexico Fires, June 2025"

Example: Generate fire impact maps over a wildfire in Quebec using the most recent 30 OPERA products (prior to 07-31-2023), filtered to remove disturbance prior to 05-15-2023

python disaster.py -b 48 49.5 -77.5 -74.4 -o QuebecFires -m fire -d 2023-07-31 -n 30 -lt "Quebec Wildfire, Summer 2023" -fd 2023-05-15

Command-line Arguments

Argument	Required	Description
-b, --bbox	Yes	Bounding box: South North West East (space-separated floats)
-o, --output_dir	Yes	Output directory or prefix for storing results
-m, --mode	Yes	Disaster mode: flood, fire, or earthquake
-n, --number_of_dates	No	Number of most recent dates to process (default: 5)
-lt, --layout_title	Yes	Title of PDF layout generated for each product
-fd, --filter_date	No	Date to use as filter in fire mode to remove all disturbance preceding filter_date

Disaster Modes

The -m / --mode argument determines which disaster type to process and which NASA OPERA products and data layers are used.

Mode	OPERA Products	Layer(s)	Description
flood	DSWx-HLS, DSWx-S1	WTR, BWTR	Detects surface water using optical (HLS) and SAR (S1) observations
fire	DIST-ALERT-HLS, DIST-ALERT-S1 (coming soon)	VEG-ANOM-MAX, VEG-DIST-STATUS	Identifies vegetation disturbance and anomalies from wildfire events
earthquake	CSLC, DISP, RTC-S1 (coming soon)	(coming soon)	Maps surface displacement and SAR backscatter changes related to seismic activity

Output

For each valid product and date:

• Mosaicked GeoTIFF file
• Reprojected WGS84 version of the mosaic
• Quicklook PNG map with legend and colorbar
• Layout in PDF format including PNG map and explanation

Products are organized in a timestamped subdirectory under your specified --output_dir.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.