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.13.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.13.0.tar.gz | 167.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| usdata-0.13.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 354.0 kB
Release files / usdata-0.13.0.tar.gz
| Download URL | usdata-0.13.0.tar.gz |
|---|---|
| Size | 167.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1a959aef6a433bd757cbd936b31c43b2ff29d5743a37edaca8a1c0506e650b87
|
|
BLAKE2b-256 checksum How to use checksums |
fad88cb14abd79c88210215e7b1fe2bfb4dfdcd5a8a221f4e877cc49d6eb1667
|
| 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.13.0-py3-none-any.whl
| Download URL | usdata-0.13.0-py3-none-any.whl |
|---|---|
| Size | 186.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e8165f9f37b4a277fb33233ea3599f0adf8b32d6110010f08dc498047936b96
|
|
BLAKE2b-256 checksum How to use checksums |
d89883bea35d3f4b4704450f27d6756613dff1c2a7968be2693dacf95e1e5127
|
| 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}
|
