Skip to content

Dataset reference

Each dataset has one page here: how to select it, what arrives, what the service does not say, and its generated reference. To browse datasets with previews and walkthroughs, use the dataset grid on usdata.dev.

Released is included in usdata 0.34.0. Source only is implemented in this checkout and requires a source installation. Planned cannot fetch data yet.

Implemented datasets

Dataset Availability Files What gets selected
Daily station weather Released CSV Station observations within inclusive calendar dates; selected elements
Monthly station climate Released CSV Complete UTC calendar months touched by the query; station and element filters
Annual station climate Released CSV Complete UTC calendar years touched by the query; station and element filters
Hourly airport observations Released CSV Every report on whole calendar days per station; optional column filters
Whole monthly station records, one file per station Released CSV One whole file per named station, every month and element it holds
Storm Events details, fatalities, and locations Released gzip CSV Whole annual archives of one table; filter rows locally after downloading
SPC tornado, hail, and wind databases Released CSV Whole annual, half-decade, or decade files of one table; filter rows locally after downloading
NWS warnings and watches by county Released CSV Events issued for one county or UGC inside an inclusive UTC window; optionally one event type
Photos from NWS damage surveys, one file per damage point attachment Released JPEG, PNG Each JPEG or PNG attached to a damage point with storm time in an inclusive UTC window of at most 7 days
NWS damage survey points, tornado tracks, and damage areas Released GeoJSON One layer's features with storm time in an inclusive UTC window, optionally in a box; one page per object-id run
NWS watch, warning, and advisory polygons and areas Source only zipped shapefile and CSV (no reader) Events starting inside an inclusive UTC window, one zip per UTC month; optionally one state or offices, event types, and polygon options
SPC convective and fire weather outlook areas Source only zipped shapefile (no reader) Outlooks issued inside an inclusive UTC window, one zip per UTC month; optionally outlook types, days, and geometry form
NEXRAD radar scans Released NEXRAD Level II Whole radar scans by site and inclusive UTC scan-start time
MRMS gridded radar products Released GRIB2 (gzipped) Whole two-minute CONUS grids of one product by inclusive UTC file stamp, at most one day
NEXRAD derived radar products Released NEXRAD Level III (no reader) Whole product files by site, product code, and inclusive UTC scan time since 2020-03-30
GOES ABI imagery, multiband scenes, and cloud-top products Released NetCDF4 Whole scenes of one ABI product by inclusive UTC scan-start time, with one channel or mesoscale sector where the product has them
GOES lightning detections Released NetCDF4 Whole 20-second detection files by inclusive UTC file-start time, at most one day
Tropical cyclone best tracks Released HURDAT2 fixed-format text The newest or a named revision of one whole basin file; filter track points locally
Global tropical cyclone best tracks Released CSV with a units row, NetCDF4 One whole subset file per query, from the newest or a pinned product version
GFS model output Released GRIB2 Global files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and grid resolution
HRRR model output Released GRIB2 CONUS files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and file variant
NBM forecast guidance Released GRIB2 Regional core files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and region
RAP model output Released GRIB2 Files, whole or by named GRIB2 message, chosen by run initialization window, cycle hour, forecast hours, and file family
30-year station climate normals Released CSV Hourly, daily, monthly, or annual/seasonal normals per station; optional month-day window except annual/seasonal; hourly returns whole days
Seasonal El Niño indices, the official RONI and the traditional ONI Released whitespace-delimited text (no reader) One whole index table, every season from DJF 1950; select seasons locally
Coastal current speed and direction Released CSV Native six-minute observations for one station and explicit bin; at most 28 days
Monthly global 2 degree sea surface temperature since 1850 Released NetCDF4 Whole global monthly files, one for every month the window touches
Coastal water levels Released CSV Six-minute observations for one station and datum; at most 28 days
Coastal tide predictions Released CSV Predictions for one station and datum on a chosen interval; at most a year
Sea-surface temperature Released CSV with units row Grid centers and timestamps inside the requested bounds; optional stride
Post-event aerial imagery tiles Released GeoTIFF Whole GeoTIFFs of one event folder, optionally by subfolder and by the footprint that tile names give
Earthquake events Released CSV Events inside an inclusive UTC window and optional box, magnitude, and depth bounds
Daily water observations Released CSV Site observations for inclusive local calendar dates; parameter and statistic filters
Five-year population, housing, and income estimates by state or county Released JSON One vintage's estimates for up to fifty variables over a state, its counties, or one county
Daily air pollutant summaries from regulatory monitors Released JSON Local days within inclusive UTC calendar dates for one to five pollutants; one file per year
Federal disaster declarations by county Released CSV Declarations whose incident period overlaps an inclusive UTC window, for a named state or county; a county also returns its state's statewide designations

Browse by provider

Provider Released Source only Planned
NOAA 29 2 12
USGS 2 0 1
Census Bureau 1 0 0
EPA 1 0 0
FEMA 1 0 1
NASA 0 0 1
USDA 0 0 1

Planned entries are listed separately on each provider page. See versions and targets for future work.