TORRENT: CONUS Flash-Flood Benchmark of Episode-Gauge-Watershed Testbeds

Provider
Songkun Yan, Yang Hong, Meihong Ma et al. (University of Oklahoma)
License
CC-BY-4.0 (source)
Size
4,800 files
Format
JSON, Parquet (in sampled files)
Stored at
Hugging Face (https://huggingface.co/datasets/skyan1002/flash-flood-benchmark-data)
Access
Free and public. No account with the data provider is needed.
DOI
10.5281/zenodo.22118051
Category
Environmental Science
Source
https://doi.org/10.5281/zenodo.22118051

About TORRENT: CONUS Flash-Flood Benchmark of Episode-Gauge-Watershed Testbeds

TORRENT is a benchmark of reproducible flash-flood testbeds for the contiguous United States, built for hydrological-response analysis and model intercomparison (companion paper in Earth System Science Data). Level 1 is the national NCEI Storm Events flash-flood catalogue for 1996-2025: 42,466 episodes, 110,251 event records and 342,238 location records. Level 2 is an observation-availability catalogue for 2021-2025 (5,424 episodes, 4,599 with USGS discharge availability, each with an evidence label). Level 3 has 806 evaluation-ready episode-gauge-watershed testbeds (160 episodes, 208 gauges) with watershed boundaries from NLDI, 3DEP terrain and USGS NWIS discharge, from which a curated primary benchmark of 21 testbeds (14 episodes, 21 gauges, return period at least 2 years) is flagged; regulated and post-fire basins are labelled rather than removed. NSSL MRMS and FLASH-CREST forcing is fetched on demand by a script. The repository mirrors the v1.0 Zenodo archive byte for byte (catalog CSVs and Parquet, bundles/ zips, about 1.1 GB) and adds manifest.jsonl with resolve URLs for programmatic access. Licensed CC BY 4.0 (Zenodo); cite the TORRENT paper and DOI 10.5281/zenodo.22118051.

How to load this dataset in Python

from datasets import load_dataset
ds = load_dataset("skyan1002/flash-flood-benchmark-data")
print(ds)

Data structure

File types in sampled files: JSON, Parquet

Files

Example file: catalog/l1_episodes.parquet

Analyze this dataset without downloading it

On Scigantic, TORRENT: CONUS Flash-Flood Benchmark of Episode-Gauge-Watershed Testbeds opens in a hosted JupyterLab notebook with the data already mounted, so you can read files where they are stored instead of copying them first. Each notebook includes an AI assistant that can see the mounted files and write and run analysis code. Open the dataset page to launch a notebook, or browse the full catalog.

This page is also available as Markdown and as JSON.

Related Environmental Science datasets