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
or --extra netcdf 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.14.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.14.0.tar.gz | 168.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| usdata-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 357.2 kB
Release files / usdata-0.14.0.tar.gz
| Download URL | usdata-0.14.0.tar.gz |
|---|---|
| Size | 168.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
435f94916abf2a68b650fb30b05840ee205f0eee94914196cfb9dbe5f39e6ff5
|
|
BLAKE2b-256 checksum How to use checksums |
a4a345bc2d84ca58d6146db057b133284b10a3d9ca1b3000a43fda7a7a2fbd51
|
| 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.14.0-py3-none-any.whl
| Download URL | usdata-0.14.0-py3-none-any.whl |
|---|---|
| Size | 188.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9a1ed353e8216758f97b09c2891de450b0aca7a78f12a56ec1d6ba2d127e2e5f
|
|
BLAKE2b-256 checksum How to use checksums |
249c0d080c46aabaa9d9683f00f994f081dfb9260d28f66e10d618f9686072e3
|
| 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}
|
