mrms-usgs-events 0.1.1

Pipeline for downloading USGS site data, extracting events, and generating MRMS RadarOnly Zarr datasets.

Citation

For windows in a WSL terminal. Environment creation and package Installation

conda create -n mrms_usgs_events -c conda-forge python=3.11 gdal geopandas libgdal-grib -y

conda activate mrms_usgs_events

python -m pip install --upgrade pip # Upgrade pip

python -m pip install mrms-usgs-events # Install the package

gdalinfo --formats | grep -i grib # Verify gdal grib

mrms-usgs --help # Verify installation

Example use for the Texas July 4 2025 event at the Mystic Camp. (Use at least 1 year between start and end)

mrms-usgs run-site 08165500
--start 2023-07-01
--end 2025-07-10
--base-dir data
--overwrite

Data directory with subfolders created following this structure

data/

├── _mrms_cache/ # Temporary cache of downloaded MRMS .grib2 files to avoid re-downloading

├── basins_json/ # Watershed boundaries (GeoJSON) for each USGS station (used to mask rainfall)

├── events/ # Detected hydrologic events (CSV files with peaks, volumes, and timing)

├── logs/ # Execution logs for debugging and tracking pipeline progress

├── rain_zarr/ # Processed rainfall data stored in Zarr format (spatial + temporal arrays)

├── site_meta/ # Metadata for each USGS station (location, name, timezone, etc.)

└── stage_parquet/ # Time series of water level (stage) data from USGS in Parquet format

Acknowledgements

This material is based upon work supported by the U.S. National Science Foundation under Grant No. TI-2303756 and the Tethys Geoscience Foundation.