Dataset Factory★ EST. 2026 · BEST AT 800×600 ★
★ WELCOME TO THE DATASET FACTORY ★ PUBLIC DATA → CHECKED BUILDS → HONEST BASELINES ★ NO POP-UPS ★ NO COOKIES ★ NO TRACKERS ★ HAND-MADE HTML ★ UNDER CONSTRUCTION SINCE THE NINETIES ★

Usgs Streamgage Record Survival

When a new USGS daily mean streamflow record opens at a monitoring location, will that record still be active five years later?

Versioned research data. Read the suitability requirements before interpreting scores.

Suitability and evaluation

Evaluation setting: retrospective research. Read the prediction setting and limitations below. Public validation is development data; downloadable holdout labels must stay outside the evaluated agent workspace.

At a glance

QuestionWhen a new USGS daily mean streamflow record opens at a monitoring location, will that record still be active five years later?
FieldU.S. Geological Survey (USGS), U.S. Department of the Interior / binary-classification
Rows3,460
Documented splits3
This versionv-75d63061fc7d7395
Released2026-11-16
Validation ROC AUC0.7181944555831795
Validation Brier0.17094465093118094
Artifactbe72de55eb39dc02a4465ad1a926ab93deb921b7c5431f21d9bbb166ded7998a

Get this dataset

How to load it

from datasets import load_dataset
ds = load_dataset('earino/factory-usgs-streamgage-record-survival', revision='v-75d63061fc7d7395')

The version links and checksums identify this artifact. Exclude the labelled holdout from the agent's workspace when running an evaluation.

What is inside

SplitRowsPositive labels
eval448—
holdout574—
train2,438—

Files and checksums

DownloadBytesSHA-256
LICENSE-EVIDENCE.json6453205f6a1f650fb1838425b79b32a9dd80ed1bdc82327b82fc609f5e4991673fd
LICENSE.md1,214fdf2bf670f587c2c8bf3ececfd635a243ee3caf24ad86ae7b62d99b32fddfa92
README.md5,481b470288b9a10d7fe2161122d6260c6ceaf19ed9dc9ca18811a8b0049e01add50
SOURCES.json9,318cedc0a0f716023a2e13c05698885b83badeb37a10ef4ff76a4adb71639c762ef
evaluation.json2,2847a28a4dde083ac0fbd504654c6a90a6b2ff03d08dc3e7b1bf13c76af69d38011
extract__meta.json1,62926a4119668cddf8bc407b4a3bd67b7d28196d1e037de445d34ecdb9b6ee1b4e7
extract__private__holdout.csv45,641cfcb9d6fee9f84ec36c395e6204272366748a04b1ba2de8741493bbeb0eca341
extract__public__eval.csv35,7815300aac135acbf6e82df95779c256f1a9978ec0196db5d7008d3564ebdd9c88b
extract__public__train.csv171,1036fad0998ea8a4323e1ee8bc4a4ac946934d464f4c341df0558c8816c4b66bf38
extract__quality.json33,238648b8cbb1e6a6f445f3f7180eed4fac03731a3a4b8456c7ff7416a65967b76a8
get_dataset.py3,680fad89222d50f9d9709225c34909be74c591df409c08b8b5951eba9d3cadfdd48
qualification.json17,9338a9ea935e16e46fdfdd83f4bc85dd300ba00eb485f35c0e0b288556b77d66cc3
reproduction__LICENSE-CC0-1.0.txt7,048a2010f343487d3f7618affe54f789f5487602331c0a8d03f49e9a7c547cf0499
reproduction__LICENSE-MIT.txt1,12456b932ff064e5da113ae10175c8546325f64f26e1ece71683ffcbf8b2304fe1c
reproduction__artifact_scrub.py11,3698c663253e691a7b8751f9c853b40a3752a833360caafb1ea8e8f534e64af4b68
reproduction__build.py39,432bd04a17f6cd640ffa27aa9869092903baf129f8588493f9a608f4707583c9b02
reproduction__construction.json37,0019bd0513392b68244542f2ed821e60e90c774f061a0388df4f94b3342bf467dbd
reproduction__dataset_package.py7,927c2364defe58dcc99322be59a1bb04894ce00e823ce37afeb37bc31012f744327
reproduction__dataset_run.py12,3818085fae14d6e93b852e692e18c1ef72113a3601f48f78901b6d1ae6db278de57
reproduction__get_dataset.py3,680fad89222d50f9d9709225c34909be74c591df409c08b8b5951eba9d3cadfdd48
reproduction__leakage_battery.py17,379adbf7ee0aca0012b78cc1f1e4aeb968a23717cae30f66a02e080215e75f830e3
reproduction__provenance.json57311a9c4f355a6345b1a64b1bb34afd669daa68a62b53b6635c45f9861295a81a7
reproduction__qualify_dataset.py66,067bff6d43d0904182e2612c32bab702e41addbf389904a236c209e78be39e37a6b
reproduction__recovery_recipes.py17,609f64c542fcda232169c95ace17421b45275194b934938c0ea4c9b68e6f844ad0e
reproduction__requirements.txt1605c72f3268174d20364624f76680e189c408a05dba2e7b8cfe12d077b3865e7f0
reproduction__source.json19,677f3eac57bc97cce637f08b58b84e27cf87f7a2525e767dbdc97dd08ab9b67e48a
reproduction__source_io.py5,6070c60eed4968cd342148efbaac7e4fa98f00708d8e6c14c0929928687b9af1ea3
reproduction__train.py2,500a3c6bcf13735bc85c52129ded68f839090dffdc266ebc3810dc61b2e6ea5e7e8
reproduction__validate.py1,277b597e7f84fed614e64b4a86fbecbd6ec0145916a24d0d221a796586976418e7b
reproduction__validate.sh4823f06ca48f11c2e05d331b4d8394284925de660c1d4b086d2f8243959e83b7e6d
source-checks.json9,642a6de343ccdcf162f0cac823166fe0bb3b6a5b1ea5539da0d3936f005dfddf31f
source-snapshot.tar.gz4,561,162e91b25b99d7ea06190b17ded2c003bed60c1d9fbc1ff6bdc4534ca23027bbea3
verify_dataset.py1,276f4a4bb7f565cdbd075c520621f881876b491eaed91a5e6e70afb31e4753f9834

Release notes · 2026-11-16

When a new USGS daily mean streamflow record opens at a monitoring location, will that record still be active five years later?

Population: USGS monitoring locations (agency code USGS) in the 50 states, DC and territories, excluding ANSI state codes 81 to 86 and 90 to 98 used for Mexican and Canadian subdivisions, that carry a primary daily mean discharge series (parameter 00060, statistic 00003, data type daily values) whose begin falls between 2001-01-01 and 2019-12-31. One row per location, taking the earliest such series. A location is excluded when another 00060 daily mean series at the same location was active at any time in the 365 days before that begin. Series with a null end are dropped.

Target: y = 1 if the time series' `end` timestamp (most recent observation in that series) is on or after the fifth anniversary of `begin`; y = 0 otherwise. Series with no `end` value are dropped, never imputed.

Prediction time: The series begin date (first day of the daily mean discharge record), using only site metadata and facts about the record and the surrounding network at the moment it opens; no later observation of that same series is used as an input.

Splits: Chronological by `begin` date: train 2001-01-01 to 2012-12-31; eval 2013-01-01 to 2015-12-31; holdout 2016-01-01 to 2019-12-31. A 60-day embargo gap is dropped immediately after each boundary (2013-01-01 to 2013-03-01 and 2016-01-01 to 2016-03-01) so multi-site installation projects do not straddle splits. Rows are distinct locations, so no location appears in more than one split and no row's outcome window is another row's input.

Outcome horizon: Five years from the first day of record (calendar fifth anniversary; about 1,826 days).

Inputs: drainage_area: Basin area upstream of the gage in square miles.; contributing_drainage_area: Contributing area in square miles when it differs from the total drainage area.; altitude: Gage or land surface altitude in feet on the recorded vertical datum.; huc2_region: First two digits of the 12 digit hydrologic unit code, giving the hydrologic region.; state_code: Two digit ANSI state code of the location, after excluding Mexican and Canadian subdivision codes 81 to 86 and 90 to 98.; district_code: USGS Water Science Center district code that operates the location. The declared state and district group was expanded into these two concrete columns.; site_type_code: Hydrologic setting code such as ST stream, ST-CA canal, ST-DCH ditch, LK lake, ES estuary.; has_instantaneous_discharge_series: 1 when the same location also carries an instantaneous discharge series (parameter 00060, statistic 00011) whose begin is on or before the daily mean begin date; proxy for a telemetry equipped, operations funded gage.; nearby_active_gage_count_50km: Count of distinct other USGS locations with a daily mean discharge series active on the decision date within 50 km, computed by haversine from feature coordinates.; huc2_prior_termination_rate: Share of training-window daily mean discharge series in the same hydrologic region whose fifth anniversary preceded the decision date and whose record had already ended before it.; begin_month: Calendar month 1 to 12 in which the record opened, capturing installation timing.

Recorded structural checks and baselines

PASSED Gate 1.6.1.

Existing unmodified runner baseline on public validation only; no holdout scoring

These historical checks do not establish availability at each prediction time or protection against every shortcut. Scores below describe the recorded protocol.

Limits

Source, licences, and citation

U.S. Geological Survey (USGS), U.S. Department of the Interior

Data compiled by the U.S. Geological Survey

Source: U.S. public domain: government-work exclusion under 17 U.S.C. 105(a); USGS states its produced data are in the U.S. Public Domain. No upstream licence grant and no CC0 designation on this database record.. Compilation: CC0-1.0. Code and documentation: MIT.

Our additional compilation rights only; upstream terms remain in force.

Suggested citation

U.S. Geological Survey, 2026, USGS water data for the Nation: U.S. Geological Survey National Water Information System database, accessed November 15, 2026, at https://doi.org/10.5066/F7P55KJN

Versions

★ THANKS FOR VISITING · BOOKMARK THIS PAGE · TELL A FRIEND ABOUT THE DATASET FACTORY · SIGN THE GUESTBOOK BEFORE YOU LEAVE ★