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

## Facts

- Provider: Songkun Yan, Yang Hong, Meihong Ma et al. (University of Oklahoma)
- License: CC-BY-4.0 (https://zenodo.org/records/22118051)
- Size: 4,800 files
- Format: JSON, Parquet (in sampled files)
- Stored at: Hugging Face, https://huggingface.co/datasets/skyan1002/flash-flood-benchmark-data
- Access: public, readable without an account
- DOI: https://doi.org/10.5281/zenodo.22118051
- Category: Environmental Science
- Source: https://doi.org/10.5281/zenodo.22118051
- Page: https://scigantic.com/archive/6ea34706-2b48-57db-8386-374bbf2d7a7b
- Keywords: Environmental Science, benchmark, JSON, Parquet, Hugging Face

## About

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.

## Load the data

```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

Example file: `catalog/l1_episodes.parquet`

## Open it

- In a hosted notebook with the data mounted: https://scigantic.com/archive/6ea34706-2b48-57db-8386-374bbf2d7a7b
- Full record as JSON (schema card included): https://api.scigantic.com/api/archives/6ea34706-2b48-57db-8386-374bbf2d7a7b
- Over MCP: `get_schema_card` with id `6ea34706-2b48-57db-8386-374bbf2d7a7b` at https://api.scigantic.com/mcp

## Related topics

- [Parquet datasets](https://scigantic.com/topics/parquet)
- [JSON datasets](https://scigantic.com/topics/json)
- [Benchmark datasets](https://scigantic.com/topics/benchmark)
- [Environmental Science datasets](https://scigantic.com/topics/environmental-science)
