usdata
Discover U.S. scientific datasets, fetch their files, and keep a reproducible record of where every input came from. Use the same Python SDK or CLI across supported NOAA and USGS datasets.
Pre-alpha. These docs describe the current source checkout. Features marked Unreleased require a source installation; consult the changelog for published versions. Other providers are planned.
Project home: usdata.dev. Documentation and getting started.
Start here
pip install usdata
usdata search precipitation --location Oklahoma
usdata info noaa:ghcn-daily
Search uses a curated registry. Fetching contacts the upstream service; readers open the resulting local files. Provenance and manifests connect those steps.
- Quick start and documentation
- Fetch and analyze data
- Runnable examples with saved outputs
- Readers and reproducible manifests
Source installation
For features marked Unreleased, install this checkout with uv:
git clone https://github.com/jakeryderv/usdata && cd usdata
uv sync --extra pandas
uv run usdata info noaa:coops-water-levels
Run source examples from this checkout with uv run usdata (CLI) or
uv run python (Python). The pandas extra enables CSV reading; use --extra radar,
--extra netcdf, or --extra grib for those formats. For contribution checks, continue with
development setup.
Providers
Browse the dataset catalog for current support, release availability, and dataset details. Provider access notes explain agency-specific services; the roadmap describes priorities.
Development
just setup
just check
See development setup and commands, contributing, and architecture.
License
1 maintainer
Release files for usdata 0.15.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| usdata-0.15.0.tar.gz | 182.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| usdata-0.15.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 392.6 kB
Release files / usdata-0.15.0.tar.gz
| Download URL | usdata-0.15.0.tar.gz |
|---|---|
| Size | 182.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
01010cc5a76cedab947d927b66d345021b2d6daa0382148edbd5b34095e33534
|
|
BLAKE2b-256 checksum How to use checksums |
8c4bd2a7d9d964903eeb1fbd1d07f14e027e6897024359f43c922cb78b758b87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / usdata-0.15.0-py3-none-any.whl
| Download URL | usdata-0.15.0-py3-none-any.whl |
|---|---|
| Size | 209.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
66675984affcc04cb9cf4c4e02a8929e5feef84d260b6caaca0eb989e1b485d5
|
|
BLAKE2b-256 checksum How to use checksums |
15269947a9c9668b94285c30cc3834ecb27a6a05a6e3b71d74fb6056314e264c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
