PyPI - usdata - Versions diffs - 0.9.0__tar.gz → 0.10.0__tar.gz - Mend

usdata 0.9.0tar.gz → 0.10.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

{usdata-0.9.0 → usdata-0.10.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: usdata
-Version: 0.9.0
+Version: 0.10.0
 Summary: Unified Python SDK and CLI for discovering, fetching, and tracking provenance of U.S. public scientific data
 Keywords: noaa,usgs,nasa,open-data,scientific-data,provenance
 Author: Jake Van Slyke
@@ -52,33 +52,39 @@ open the resulting local files. Provenance and manifests connect those steps.
 - [Runnable examples with saved outputs](examples/README.md)
 - [Readers](docs/reference/readers.md) and [reproducible manifests](docs/reference/manifests.md)
-## Providers
+## Source installation
+For features marked **Unreleased**, install this checkout with
+[uv](https://docs.astral.sh/uv/):
+```sh
+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](#development).
-<!-- registry:start -->
-| Provider | Available | Stub | Planned | Next up (unassigned) | Datasets |
-|---|---:|---:|---:|---|---|
-| [NOAA](docs/providers/noaa.md) | 6 | 0 | 23 | — | `ghcn-daily`, `gsom`, `storm-events`, `nexrad-level2`, `goes-abi`, `coastwatch-sst`, +23 planned |
-| [USGS](docs/providers/usgs.md) | 1 | 0 | 2 | — | `water-daily`, +2 planned |
-| [Census Bureau](docs/providers/census.md) | 0 | 0 | 1 | — | +1 planned |
-| [EPA](docs/providers/epa.md) | 0 | 0 | 1 | — | +1 planned |
-| [FEMA](docs/providers/fema.md) | 0 | 0 | 1 | — | +1 planned |
-| [NASA](docs/providers/nasa.md) | 0 | 0 | 1 | — | +1 planned |
-| [USDA](docs/providers/usda.md) | 0 | 0 | 1 | — | +1 planned |
+## Providers
-Available datasets are in `code`, stubs in _italics_; planned ones are counted. Available means implemented in this source checkout; consult the [releases](https://github.com/jakeryderv/usdata/releases) for published support. Provider pages link access notes to the generated dataset catalog; [the roadmap](docs/roadmap.md) explains future priorities.
-<!-- registry:end -->
+Browse the [dataset catalog](docs/generated/catalog/index.md) for current support,
+release availability, and dataset details. [Provider access notes](docs/providers/README.md)
+explain agency-specific services; the [roadmap](docs/roadmap.md) describes priorities.
 ## Development
-Requires [uv](https://docs.astral.sh/uv/) and [just](https://just.systems/).
+From a [source checkout](#source-installation), requires [uv](https://docs.astral.sh/uv/) and [just](https://just.systems/).
 `just setup` uses the tested Python 3.14.7 pin in `.python-version`. Older Linux
 uv Python 3.14 builds can crash during NumPy array operations; see
 [the upstream fix](https://github.com/astral-sh/python-build-standalone/issues/991).
 ```sh
-git clone https://github.com/jakeryderv/usdata && cd usdata
 just setup     # install toolchain and dependencies
+just hooks-install # optional: install fast staged-file checks
 just test      # all offline tests
 just check     # format, lint, typecheck, offline tests, generated docs, release notices
 just check-pandas  # install the CSV extra and run the same checks
@@ -90,9 +96,17 @@ just docs-serve # build and preview the documentation locally, with reload
 just check-docs # validate generated content and build the site strictly
 just build     # build wheel and sdist
 just smoke     # exercise core and pandas wheel installations outside the checkout
+just changes   # preview upcoming release notes
+just cleanup 123 # from main: remove PR #123's merged branch and clean worktree
 just run search radar
 ```
+Commit hooks fix and format staged Python files using the locked Ruff version,
+and check configuration, merge conflicts, and GitHub Actions workflows. Full
+validation remains `just check`; `just check-hooks` runs the non-mutating config
+and workflow checks alone. Hooks do not rewrite notebooks or raw data fixtures.
+The first hook run downloads its isolated tools and requires network access.
 Offline tests mechanically block network connections. Tests that hit
 live services run with `just test-live`; see [testing levels and organization](docs/testing.md). CI checks Python 3.11 and 3.14 on
 Linux with core-only, pandas, radar, and NetCDF dependency profiles. Installed-wheel
@@ -101,8 +115,9 @@ live-service suites run on Linux. `just setup` restores a core-only development
 environment; the `check-pandas`, `check-radar`, and `check-netcdf` commands install
 their respective extras.
-Releases: `just release minor` opens a version-bump PR; merging it publishes
-to PyPI and creates the tag and GitHub release. See
+Releases: `just release minor` prepares a release branch. Update release notices,
+then `just release-pr` validates and opens a draft for review. Merging the reviewed
+PR publishes to PyPI and creates the tag and GitHub release. See
 [docs/versioning.md](docs/versioning.md).
 See [provider access notes](docs/providers/README.md),

{usdata-0.9.0 → usdata-0.10.0}/README.md RENAMED Viewed

@@ -24,33 +24,39 @@ open the resulting local files. Provenance and manifests connect those steps.
 - [Runnable examples with saved outputs](examples/README.md)
 - [Readers](docs/reference/readers.md) and [reproducible manifests](docs/reference/manifests.md)
-## Providers
+## Source installation
+For features marked **Unreleased**, install this checkout with
+[uv](https://docs.astral.sh/uv/):
+```sh
+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](#development).
-<!-- registry:start -->
-| Provider | Available | Stub | Planned | Next up (unassigned) | Datasets |
-|---|---:|---:|---:|---|---|
-| [NOAA](docs/providers/noaa.md) | 6 | 0 | 23 | — | `ghcn-daily`, `gsom`, `storm-events`, `nexrad-level2`, `goes-abi`, `coastwatch-sst`, +23 planned |
-| [USGS](docs/providers/usgs.md) | 1 | 0 | 2 | — | `water-daily`, +2 planned |
-| [Census Bureau](docs/providers/census.md) | 0 | 0 | 1 | — | +1 planned |
-| [EPA](docs/providers/epa.md) | 0 | 0 | 1 | — | +1 planned |
-| [FEMA](docs/providers/fema.md) | 0 | 0 | 1 | — | +1 planned |
-| [NASA](docs/providers/nasa.md) | 0 | 0 | 1 | — | +1 planned |
-| [USDA](docs/providers/usda.md) | 0 | 0 | 1 | — | +1 planned |
+## Providers
-Available datasets are in `code`, stubs in _italics_; planned ones are counted. Available means implemented in this source checkout; consult the [releases](https://github.com/jakeryderv/usdata/releases) for published support. Provider pages link access notes to the generated dataset catalog; [the roadmap](docs/roadmap.md) explains future priorities.
-<!-- registry:end -->
+Browse the [dataset catalog](docs/generated/catalog/index.md) for current support,
+release availability, and dataset details. [Provider access notes](docs/providers/README.md)
+explain agency-specific services; the [roadmap](docs/roadmap.md) describes priorities.
 ## Development
-Requires [uv](https://docs.astral.sh/uv/) and [just](https://just.systems/).
+From a [source checkout](#source-installation), requires [uv](https://docs.astral.sh/uv/) and [just](https://just.systems/).
 `just setup` uses the tested Python 3.14.7 pin in `.python-version`. Older Linux
 uv Python 3.14 builds can crash during NumPy array operations; see
 [the upstream fix](https://github.com/astral-sh/python-build-standalone/issues/991).
 ```sh
-git clone https://github.com/jakeryderv/usdata && cd usdata
 just setup     # install toolchain and dependencies
+just hooks-install # optional: install fast staged-file checks
 just test      # all offline tests
 just check     # format, lint, typecheck, offline tests, generated docs, release notices
 just check-pandas  # install the CSV extra and run the same checks
@@ -62,9 +68,17 @@ just docs-serve # build and preview the documentation locally, with reload
 just check-docs # validate generated content and build the site strictly
 just build     # build wheel and sdist
 just smoke     # exercise core and pandas wheel installations outside the checkout
+just changes   # preview upcoming release notes
+just cleanup 123 # from main: remove PR #123's merged branch and clean worktree
 just run search radar
 ```
+Commit hooks fix and format staged Python files using the locked Ruff version,
+and check configuration, merge conflicts, and GitHub Actions workflows. Full
+validation remains `just check`; `just check-hooks` runs the non-mutating config
+and workflow checks alone. Hooks do not rewrite notebooks or raw data fixtures.
+The first hook run downloads its isolated tools and requires network access.
 Offline tests mechanically block network connections. Tests that hit
 live services run with `just test-live`; see [testing levels and organization](docs/testing.md). CI checks Python 3.11 and 3.14 on
 Linux with core-only, pandas, radar, and NetCDF dependency profiles. Installed-wheel
@@ -73,8 +87,9 @@ live-service suites run on Linux. `just setup` restores a core-only development
 environment; the `check-pandas`, `check-radar`, and `check-netcdf` commands install
 their respective extras.
-Releases: `just release minor` opens a version-bump PR; merging it publishes
-to PyPI and creates the tag and GitHub release. See
+Releases: `just release minor` prepares a release branch. Update release notices,
+then `just release-pr` validates and opens a draft for review. Merging the reviewed
+PR publishes to PyPI and creates the tag and GitHub release. See
 [docs/versioning.md](docs/versioning.md).
 See [provider access notes](docs/providers/README.md),

{usdata-0.9.0 → usdata-0.10.0}/pyproject.toml RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "usdata"
-version = "0.9.0"
+version = "0.10.0"
 description = "Unified Python SDK and CLI for discovering, fetching, and tracking provenance of U.S. public scientific data"
 readme = "README.md"
 license = "Apache-2.0"
@@ -47,15 +47,19 @@ usdata = "usdata.cli:app"
 [dependency-groups]
 dev = [
+    "pre-commit>=4.6.0",
     "pyright>=1.1.380",
     "pytest>=8.0",
     "pytest-cov>=7.1.0",
     "respx>=0.23.1",
     "ruff>=0.6",
+    "towncrier>=26.9",
 ]
 docs = [
+    "tomli-w>=1.2.0",
     "mkdocstrings-python>=2.0.8",
     "nbconvert>=7.17.1",
+    "towncrier>=26.9",
     "zensical>=0.0.60",
 ]
 examples = [
@@ -126,3 +130,64 @@ markers = [
     "netcdf: optional NetCDF reader coverage",
 ]
 addopts = "-ra --strict-markers"
+[tool.towncrier]
+directory = "changes"
+filename = "CHANGELOG.md"
+start_string = """
+<!-- towncrier release notes start -->
+"""
+underlines = [
+    "",
+    "",
+    "",
+]
+title_format = "## [{version}](https://github.com/jakeryderv/usdata/releases/tag/v{version}) - {project_date}"
+issue_format = "[#{issue}](https://github.com/jakeryderv/usdata/issues/{issue})"
+template = "scripts/templates/changelog.md.jinja"
+wrap = false
+[[tool.towncrier.type]]
+directory = "breaking"
+name = "Breaking"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "security"
+name = "Security"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "removed"
+name = "Removed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "added"
+name = "Added"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "changed"
+name = "Changed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "fixed"
+name = "Fixed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "documentation"
+name = "Documentation"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "development"
+name = "Development"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "internal"
+name = "Internal"
+showcontent = true

{usdata-0.9.0 → usdata-0.10.0}/pyproject.toml.orig RENAMED Viewed

@@ -1,6 +1,6 @@
 [project]
 name = "usdata"
-version = "0.9.0"
+version = "0.10.0"
 description = "Unified Python SDK and CLI for discovering, fetching, and tracking provenance of U.S. public scientific data"
 readme = "README.md"
 license = "Apache-2.0"
@@ -36,15 +36,19 @@ usdata = "usdata.cli:app"
 [dependency-groups]
 dev = [
+    "pre-commit>=4.6.0",
     "pyright>=1.1.380",
     "pytest>=8.0",
     "pytest-cov>=7.1.0",
     "respx>=0.23.1",
     "ruff>=0.6",
+    "towncrier>=26.9",
 ]
 docs = [
+    "tomli-w>=1.2.0",
     "mkdocstrings-python>=2.0.8",
     "nbconvert>=7.17.1",
+    "towncrier>=26.9",
     "zensical>=0.0.60",
 ]
 examples = [
@@ -98,3 +102,58 @@ markers = [
     "netcdf: optional NetCDF reader coverage",
 ]
 addopts = "-ra --strict-markers"
+[tool.towncrier]
+directory = "changes"
+filename = "CHANGELOG.md"
+start_string = "<!-- towncrier release notes start -->\n"
+underlines = ["", "", ""]
+title_format = "## [{version}](https://github.com/jakeryderv/usdata/releases/tag/v{version}) - {project_date}"
+issue_format = "[#{issue}](https://github.com/jakeryderv/usdata/issues/{issue})"
+template = "scripts/templates/changelog.md.jinja"
+wrap = false
+[[tool.towncrier.type]]
+directory = "breaking"
+name = "Breaking"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "security"
+name = "Security"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "removed"
+name = "Removed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "added"
+name = "Added"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "changed"
+name = "Changed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "fixed"
+name = "Fixed"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "documentation"
+name = "Documentation"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "development"
+name = "Development"
+showcontent = true
+[[tool.towncrier.type]]
+directory = "internal"
+name = "Internal"
+showcontent = true

{usdata-0.9.0 → usdata-0.10.0}/src/usdata/data/nexrad_sites.csv RENAMED Viewed

@@ -1,211 +1,211 @@
-id,name,state,lat,lon,elev_ft,type
-KABR,Aberdeen,SD,45.455833,-98.413333,1383,NEXRAD
-KABX,Albuquerque,NM,35.149722,-106.82388,5951,NEXRAD
-KAKQ,Norfolk Rich,VA,36.98405,-77.007361,255,NEXRAD
-KAMA,Amarillo,TX,35.233333,-101.70927,3703,NEXRAD
-KAMX,Miami,FL,25.611083,-80.412667,111,NEXRAD
-KAPX,Gaylord,MI,44.90635,-84.719533,1561,NEXRAD
-KARX,La Crosse,WI,43.822778,-91.191111,1357,NEXRAD
-KATX,Seattle,WA,48.194611,-122.49569,642,NEXRAD
-KBBX,Beale Afb,CA,39.495639,-121.63161,221,NEXRAD
-KBGM,Binghamton,NY,42.199694,-75.984722,1703,NEXRAD
-KBHX,Eureka,CA,40.498583,-124.29216,2516,NEXRAD
-KBIS,Bismarck,ND,46.770833,-100.76055,1755,NEXRAD
-KBLX,Billings,MT,45.853778,-108.60680,3703,NEXRAD
-KBMX,Birmingham,AL,33.172417,-86.770167,759,NEXRAD
-KBOX,Boston,MA,41.955778,-71.136861,232,NEXRAD
-KBRO,Brownsville,TX,25.916,-97.418967,88,NEXRAD
-KBUF,Buffalo,NY,42.948789,-78.736781,790,NEXRAD
-KBYX,Key West,FL,24.5975,-81.703167,89,NEXRAD
-KCAE,Columbia,SC,33.948722,-81.118278,345,NEXRAD
-KCBW,Houlton,ME,46.03925,-67.806431,860,NEXRAD
-KCBX,Boise,ID,43.490217,-116.23603,3172,NEXRAD
-KCCX,State College,PA,40.923167,-78.003722,2486,NEXRAD
-KCLE,Cleveland,OH,41.413217,-81.859867,860,NEXRAD
-KCLX,Charleston,SC,32.655528,-81.042194,229,NEXRAD
-KCRI,Roc Faa Redundant Rda 1,OK,35.238333,-97.46,1315,TEST
-KCRP,Corpus Christi,TX,27.784017,-97.51125,142,NEXRAD
-KCXX,Burlington,VT,44.511,-73.166431,431,NEXRAD
-KCYS,Cheyenne,WY,41.151919,-104.80603,6193,NEXRAD
-KDAX,Sacramento,CA,38.501111,-121.67783,144,NEXRAD
-KDDC,Dodge City,KS,37.760833,-99.968889,2671,NEXRAD
-KDFX,Laughlin Afb,TX,29.273139,-100.28033,1196,NEXRAD
-KDGX,Jackson Brandon,MS,32.279944,-89.984444,609,NEXRAD
-KDIX,Philadelphia,NJ,39.947089,-74.410731,230,NEXRAD
-KDLH,Duluth,MN,46.836944,-92.209722,1542,NEXRAD
-KDMX,Des Moines,IA,41.7312,-93.722869,1095,NEXRAD
-KDOX,Dover Afb,DE,38.825767,-75.440117,164,NEXRAD
-KDTX,Detroit,MI,42.7,-83.471667,1216,NEXRAD
-KDVN,Davenport,IA,41.611667,-90.580833,851,NEXRAD
-KDYX,Dyess Afb,TX,32.5385,-99.254333,1582,NEXRAD
-KEAX,Kansas City,MO,38.81025,-94.264472,1092,NEXRAD
-KEMX,Tucson,AZ,31.89365,-110.63025,5319,NEXRAD
-KENX,Albany,NY,42.586556,-74.064083,1935,NEXRAD
-KEOX,Fort Rucker,AL,31.460556,-85.459389,537,NEXRAD
-KEPZ,El Paso,NM,31.873056,-106.698,4218,NEXRAD
-KESX,Las Vegas,NV,35.70135,-114.89165,4948,NEXRAD
-KEVX,Eglin Afb,FL,30.565033,-85.921667,221,NEXRAD
-KEWX,Austin San Antonio,TX,29.704056,-98.028611,767,NEXRAD
-KEYX,Edwards,CA,35.09785,-117.56075,2873,NEXRAD
-KFCX,Roanoke,VA,37.0244,-80.273969,2965,NEXRAD
-KFDR,Altus Afb,OK,34.362194,-98.976667,1315,NEXRAD
-KFDX,Cannon Afb,NM,34.634167,-103.61888,4698,NEXRAD
-KFFC,Atlanta,GA,33.36355,-84.56595,972,NEXRAD
-KFSD,Sioux Falls,SD,43.587778,-96.729444,1495,NEXRAD
-KFSX,Flagstaff,AZ,34.574333,-111.19844,7514,NEXRAD
-KFTG,Denver Front Range Ap,CO,39.786639,-104.54580,5611,NEXRAD
-KFWS,Dallas,TX,32.573,-97.30315,777,NEXRAD
-KGGW,Glasgow,MT,48.206361,-106.62469,2384,NEXRAD
-KGJX,Grand Junction,CO,39.062169,-108.21376,10101,NEXRAD
-KGLD,Goodland,KS,39.366944,-101.70027,3716,NEXRAD
-KGRB,Green Bay,WI,44.498633,-88.111111,823,NEXRAD
-KGRK,Fort Hood,TX,30.721833,-97.382944,603,NEXRAD
-KGRR,Grand Rapids,MI,42.893889,-85.544889,875,NEXRAD
-KGSP,Greer,SC,34.883306,-82.219833,1069,NEXRAD
-KGWX,Columbus Afb,MS,33.896917,-88.329194,590,NEXRAD
-KGYX,Portland,ME,43.891306,-70.256361,474,NEXRAD
-KHDC,Hammond Municipal Airport,LA,30.5193,-90.4074,43,NEXRAD
-KHDX,Holloman Afb,NM,33.077,-106.12003,4270,NEXRAD
-KHGX,Houston,TX,29.4719,-95.078733,115,NEXRAD
-KHNX,San Joaquin Valley,CA,36.314181,-119.63213,340,NEXRAD
-KHPX,Fort Campbell,KY,36.736972,-87.285583,613,NEXRAD
-KHTX,Huntsville,AL,34.930556,-86.083611,1859,NEXRAD
-KICT,Wichita,KS,37.654444,-97.443056,1400,NEXRAD
-KICX,Cedar City,UT,37.59105,-112.86218,10757,NEXRAD
-KILN,Cincinnati,OH,39.420483,-83.82145,1170,NEXRAD
-KILX,Lincoln,IL,40.1505,-89.336792,731,NEXRAD
-KIND,Indianapolis,IN,39.7075,-86.280278,887,NEXRAD
-KINX,Tulsa,OK,36.175131,-95.564161,749,NEXRAD
-KIWA,Phoenix,AZ,33.289233,-111.66991,1426,NEXRAD
-KIWX,Fort Wayne,IN,41.358611,-85.7,1056,NEXRAD
-KJAX,Jacksonville,FL,30.484633,-81.7019,160,NEXRAD
-KJGX,Robins Afb,GA,32.675683,-83.350833,618,NEXRAD
-KJKL,Jackson,KY,37.590833,-83.313056,1461,NEXRAD
-KLBB,Lubbock,TX,33.654139,-101.81416,3378,NEXRAD
-KLCH,Lake Charles,LA,30.125306,-93.215889,137,NEXRAD
-KLGX,Langley Hill Nw Washington,WA,47.116944,-124.10666,366,NEXRAD
-KLIX,New Orleans,LA,30.336667,-89.825417,179,NEXRAD
-KLNX,North Platte,NE,41.957944,-100.57622,3113,NEXRAD
-KLOT,Chicago,IL,41.604444,-88.084444,760,NEXRAD
-KLRX,Elko,NV,40.73955,-116.8027,6895,NEXRAD
-KLSX,St Louis,MO,38.698611,-90.682778,722,NEXRAD
-KLTX,Wilmington,NC,33.98915,-78.429108,145,NEXRAD
-KLVX,Louisville,KY,37.975278,-85.943889,833,NEXRAD
-KLWX,Sterling,VA,38.976111,-77.4875,404,NEXRAD
-KLZK,Little Rock,AR,34.8365,-92.262194,649,NEXRAD
-KMAF,Midland Odessa,TX,31.943461,-102.18925,2962,NEXRAD
-KMAX,Medford,OR,42.081169,-122.71736,7561,NEXRAD
-KMBX,Minot Afb,ND,48.393056,-100.86444,1590,NEXRAD
-KMHX,Morehead City,NC,34.775908,-76.876189,145,NEXRAD
-KMKX,Milwaukee,WI,42.9679,-88.550667,1023,NEXRAD
-KMLB,Melbourne,FL,28.113194,-80.654083,149,NEXRAD
-KMOB,Mobile,AL,30.679444,-88.24,289,NEXRAD
-KMPX,Minneapolis,MN,44.848889,-93.565528,1101,NEXRAD
-KMQT,Marquette,MI,46.531111,-87.548333,1525,NEXRAD
-KMRX,Knoxville,TN,36.168611,-83.401944,1434,NEXRAD
-KMSX,Missoula,MT,47.041,-113.98622,7978,NEXRAD
-KMTX,Salt Lake City,UT,41.262778,-112.44777,6594,NEXRAD
-KMUX,San Francisco,CA,37.155222,-121.89844,3550,NEXRAD
-KMVX,Grand Forks,ND,47.527778,-97.325556,1083,NEXRAD
-KMXX,Maxwell Afb,AL,32.53665,-85.78975,560,NEXRAD
-KNKX,San Diego,CA,32.919017,-117.0418,1052,NEXRAD
-KNQA,Memphis,TN,35.344722,-89.873333,435,NEXRAD
-KOAX,Omaha,NE,41.320369,-96.366819,1262,NEXRAD
-KOHX,Nashville,TN,36.247222,-86.5625,676,NEXRAD
-KOKX,New York City,NY,40.865528,-72.863917,199,NEXRAD
-KOTX,Spokane,WA,47.680417,-117.62677,2449,NEXRAD
-KOUN,Norman Nssl,OK,35.236058,-97.46235,1284,TEST
-KPAH,Paducah,KY,37.068333,-88.771944,506,NEXRAD
-KPBZ,Pittsburgh,PA,40.531717,-80.217967,1266,NEXRAD
-KPDT,Pendleton,OR,45.69065,-118.85293,1580,NEXRAD
-KPOE,Fort Polk,LA,31.155278,-92.976111,473,NEXRAD
-KPUX,Pueblo,CO,38.45955,-104.18135,5363,NEXRAD
-KRAX,Raleigh Durham,NC,35.665519,-78.48975,462,NEXRAD
-KRGX,Reno,NV,39.754056,-119.46202,8396,NEXRAD
-KRIW,Riverton,WY,43.066089,-108.4773,5633,NEXRAD
-KRLX,Charleston,WV,38.311111,-81.722778,1213,NEXRAD
-KRTX,Portland,OR,45.715039,-122.965,1728,NEXRAD
-KSFX,Pocatello,ID,43.1056,-112.68613,4539,NEXRAD
-KSGF,Springfield,MO,37.235239,-93.400419,1375,NEXRAD
-KSHV,Shreveport,LA,32.450833,-93.84125,387,NEXRAD
-KSJT,San Angelo,TX,31.371278,-100.4925,2004,NEXRAD
-KSOX,Santa Ana Mountains,CA,33.817733,-117.636,3106,NEXRAD
-KSRX,Fort Smith,AR,35.290417,-94.361889,737,NEXRAD
-KTBW,Tampa,FL,27.7055,-82.401778,122,NEXRAD
-KTFX,Great Falls,MT,47.459583,-111.38533,3805,NEXRAD
-KTLH,Tallahassee,FL,30.397583,-84.328944,177,NEXRAD
-KTLX,Oklahoma City,OK,35.333361,-97.277761,1278,NEXRAD
-KTWX,Topeka,KS,38.99695,-96.23255,1415,NEXRAD
-KTYX,Fort Drum,NY,43.755694,-75.679861,1960,NEXRAD
-KUDX,Rapid City,SD,44.124722,-102.83,3195,NEXRAD
-KUEX,Hastings,NE,40.320833,-98.441944,2057,NEXRAD
-KVAX,Moody Afb,GA,30.890278,-83.001806,330,NEXRAD
-KVBX,Vandenberg Afb,CA,34.83855,-120.39791,1354,NEXRAD
-KVNX,Vance Afb,OK,36.740617,-98.127717,1258,NEXRAD
-KVTX,Los Angeles,CA,34.412017,-119.17875,2807,NEXRAD
-KVWX,Evansville,IN,38.26025,-87.724528,625,NEXRAD
-KYUX,Yuma,AZ,32.495281,-114.65671,239,NEXRAD
-LPLA,Lajes Ab,,38.73028,-27.32167,3334,NEXRAD
-PABC,Bethel Faa,AK,60.791944,-161.87638,193,NEXRAD
-PACG,Sitka,AK,56.852778,-135.52916,272,NEXRAD
-PAEC,Nome,AK,64.511389,-165.295,90,NEXRAD
-PAHG,Anchorage,AK,60.725914,-151.35146,356,NEXRAD
-PAIH,Middleton Island,AK,59.460767,-146.30344,132,NEXRAD
-PAKC,King Salmon,AK,58.679444,-156.62944,144,NEXRAD
-PAPD,Fairbanks,AK,65.035114,-147.50143,2707,NEXRAD
-PGUA,Andersen Afb Agana,GU,13.455833,144.811111,386,NEXRAD
-PHKI,South Kauai,HI,21.893889,-159.5525,340,NEXRAD
-PHKM,Kamuela,HI,20.125278,-155.77777,3966,NEXRAD
-PHMO,Molokai,HI,21.132778,-157.18027,1444,NEXRAD
-PHWA,South Shore,HI,19.095,-155.56888,1461,NEXRAD
-RKJK,Kunsan,,35.924167,126.622222,192,NEXRAD
-RKSG,Camp Humphreys,,37.207569,127.285561,1521,NEXRAD
-RODN,Kadena,,26.3078,127.903469,412,NEXRAD
-TADW,Andrews Afb,MD,38.695,-76.845,344,TDWR
-TATL,Atlanta,GA,33.646944,-84.261944,1076,TDWR
-TBNA,Nashville,TN,35.98,-86.661944,817,TDWR
-TBOS,Boston,MA,42.158056,-70.933056,262,TDWR
-TBWI,Baltimore Washington,MD,39.09,-76.63,299,TDWR
-TCLT,Charlotte,NC,35.336944,-80.885,869,TDWR
-TCMH,Columbus,OH,40.006111,-82.715,1148,TDWR
-TCVG,Covington,KY,38.898056,-84.58,1053,TDWR
-TDAL,Dallas Love Field,TX,32.926111,-96.968056,623,TDWR
-TDAY,Dayton,OH,40.021944,-84.123056,1020,TDWR
-TDCA,Washington National,MD,38.758889,-76.961944,344,TDWR
-TDEN,Denver,CO,39.728056,-104.52611,5702,TDWR
-TDFW,Dallas Ft Worth,TX,33.065,-96.918056,584,TDWR
-TDTW,Detroit,MI,42.111111,-83.515,771,TDWR
-TEWR,Newark,NJ,40.593056,-74.27,135,TDWR
-TFLL,Ft Lauderdale,FL,26.143056,-80.343889,121,TDWR
-THOU,Houston Hobby,TX,29.516111,-95.241944,118,TDWR
-TIAD,Washington Dulles,VA,39.083889,-77.528889,472,TDWR
-TIAH,Houston International,TX,30.065,-95.566944,253,TDWR
-TICH,Wichita,KS,37.506944,-97.436944,1352,TDWR
-TIDS,Indianapolis,IN,39.636944,-86.436111,846,TDWR
-TJBQ,Rafael Hernandez Airport,PR,18.485,-67.143,280,TDWR
-TJFK,New York City Jfk,NY,40.588889,-73.881111,112,TDWR
-TJRV,Jose Aponte De La Torre Airpor,PR,18.256,-65.637,50,TDWR
-TJUA,San Juan,PR,18.115667,-66.078167,2958,NEXRAD
-TLAS,Las Vegas,NV,36.143889,-115.00694,2057,TDWR
-TLVE,Cleveland,OH,41.29,-82.008056,932,TDWR
-TMCI,Kansas City,MO,39.498056,-94.741944,1089,TDWR
-TMCO,Orlando International,FL,28.343889,-81.326111,171,TDWR
-TMDW,Chicago Midway,IL,41.651111,-87.73,764,TDWR
-TMEM,Memphis,MS,34.896111,-89.993056,482,TDWR
-TMIA,Miami,FL,25.758056,-80.491111,125,TDWR
-TMKE,Milwaukee,WI,42.818889,-88.046111,932,TDWR
-TMSP,Minneapolis,MN,44.871111,-92.933056,1122,TDWR
-TMSY,New Orleans,LA,30.021944,-90.403056,98,TDWR
-TOKC,Norman Wfo,OK,35.276111,-97.51,1309,TDWR
-TORD,Chicago Ohare,IL,41.796944,-87.858056,745,TDWR
-TPBI,West Palm Beach,FL,26.688056,-80.273056,135,TDWR
-TPHL,Philadelphia,NJ,39.948889,-75.068889,154,TDWR
-TPHX,Phoenix,AZ,33.421111,-112.16305,1089,TDWR
-TPIT,Pittsburgh,PA,40.501111,-80.486111,1385,TDWR
-TRDU,Raleigh,NC,36.001944,-78.696944,515,TDWR
-TSDF,Louisville,KY,38.046111,-85.61,732,TDWR
-TSJU,San Juan,PR,18.473889,-66.178889,157,TDWR
-TSLC,Salt Lake City,UT,40.966944,-111.93,4295,TDWR
-TSTL,St Louis,MO,38.805,-90.488889,646,TDWR
-TTPA,Tampa,FL,27.86,-82.518056,92,TDWR
-TTUL,Tulsa,OK,36.071111,-95.826944,823,TDWR
+id,name,state,lat,lon,elev_ft,type
+KABR,Aberdeen,SD,45.455833,-98.413333,1383,NEXRAD
+KABX,Albuquerque,NM,35.149722,-106.82388,5951,NEXRAD
+KAKQ,Norfolk Rich,VA,36.98405,-77.007361,255,NEXRAD
+KAMA,Amarillo,TX,35.233333,-101.70927,3703,NEXRAD
+KAMX,Miami,FL,25.611083,-80.412667,111,NEXRAD
+KAPX,Gaylord,MI,44.90635,-84.719533,1561,NEXRAD
+KARX,La Crosse,WI,43.822778,-91.191111,1357,NEXRAD
+KATX,Seattle,WA,48.194611,-122.49569,642,NEXRAD
+KBBX,Beale Afb,CA,39.495639,-121.63161,221,NEXRAD
+KBGM,Binghamton,NY,42.199694,-75.984722,1703,NEXRAD
+KBHX,Eureka,CA,40.498583,-124.29216,2516,NEXRAD
+KBIS,Bismarck,ND,46.770833,-100.76055,1755,NEXRAD
+KBLX,Billings,MT,45.853778,-108.60680,3703,NEXRAD
+KBMX,Birmingham,AL,33.172417,-86.770167,759,NEXRAD
+KBOX,Boston,MA,41.955778,-71.136861,232,NEXRAD
+KBRO,Brownsville,TX,25.916,-97.418967,88,NEXRAD
+KBUF,Buffalo,NY,42.948789,-78.736781,790,NEXRAD
+KBYX,Key West,FL,24.5975,-81.703167,89,NEXRAD
+KCAE,Columbia,SC,33.948722,-81.118278,345,NEXRAD
+KCBW,Houlton,ME,46.03925,-67.806431,860,NEXRAD
+KCBX,Boise,ID,43.490217,-116.23603,3172,NEXRAD
+KCCX,State College,PA,40.923167,-78.003722,2486,NEXRAD
+KCLE,Cleveland,OH,41.413217,-81.859867,860,NEXRAD
+KCLX,Charleston,SC,32.655528,-81.042194,229,NEXRAD
+KCRI,Roc Faa Redundant Rda 1,OK,35.238333,-97.46,1315,TEST
+KCRP,Corpus Christi,TX,27.784017,-97.51125,142,NEXRAD
+KCXX,Burlington,VT,44.511,-73.166431,431,NEXRAD
+KCYS,Cheyenne,WY,41.151919,-104.80603,6193,NEXRAD
+KDAX,Sacramento,CA,38.501111,-121.67783,144,NEXRAD
+KDDC,Dodge City,KS,37.760833,-99.968889,2671,NEXRAD
+KDFX,Laughlin Afb,TX,29.273139,-100.28033,1196,NEXRAD
+KDGX,Jackson Brandon,MS,32.279944,-89.984444,609,NEXRAD
+KDIX,Philadelphia,NJ,39.947089,-74.410731,230,NEXRAD
+KDLH,Duluth,MN,46.836944,-92.209722,1542,NEXRAD
+KDMX,Des Moines,IA,41.7312,-93.722869,1095,NEXRAD
+KDOX,Dover Afb,DE,38.825767,-75.440117,164,NEXRAD
+KDTX,Detroit,MI,42.7,-83.471667,1216,NEXRAD
+KDVN,Davenport,IA,41.611667,-90.580833,851,NEXRAD
+KDYX,Dyess Afb,TX,32.5385,-99.254333,1582,NEXRAD
+KEAX,Kansas City,MO,38.81025,-94.264472,1092,NEXRAD
+KEMX,Tucson,AZ,31.89365,-110.63025,5319,NEXRAD
+KENX,Albany,NY,42.586556,-74.064083,1935,NEXRAD
+KEOX,Fort Rucker,AL,31.460556,-85.459389,537,NEXRAD
+KEPZ,El Paso,NM,31.873056,-106.698,4218,NEXRAD
+KESX,Las Vegas,NV,35.70135,-114.89165,4948,NEXRAD
+KEVX,Eglin Afb,FL,30.565033,-85.921667,221,NEXRAD
+KEWX,Austin San Antonio,TX,29.704056,-98.028611,767,NEXRAD
+KEYX,Edwards,CA,35.09785,-117.56075,2873,NEXRAD
+KFCX,Roanoke,VA,37.0244,-80.273969,2965,NEXRAD
+KFDR,Altus Afb,OK,34.362194,-98.976667,1315,NEXRAD
+KFDX,Cannon Afb,NM,34.634167,-103.61888,4698,NEXRAD
+KFFC,Atlanta,GA,33.36355,-84.56595,972,NEXRAD
+KFSD,Sioux Falls,SD,43.587778,-96.729444,1495,NEXRAD
+KFSX,Flagstaff,AZ,34.574333,-111.19844,7514,NEXRAD
+KFTG,Denver Front Range Ap,CO,39.786639,-104.54580,5611,NEXRAD
+KFWS,Dallas,TX,32.573,-97.30315,777,NEXRAD
+KGGW,Glasgow,MT,48.206361,-106.62469,2384,NEXRAD
+KGJX,Grand Junction,CO,39.062169,-108.21376,10101,NEXRAD
+KGLD,Goodland,KS,39.366944,-101.70027,3716,NEXRAD
+KGRB,Green Bay,WI,44.498633,-88.111111,823,NEXRAD
+KGRK,Fort Hood,TX,30.721833,-97.382944,603,NEXRAD
+KGRR,Grand Rapids,MI,42.893889,-85.544889,875,NEXRAD
+KGSP,Greer,SC,34.883306,-82.219833,1069,NEXRAD
+KGWX,Columbus Afb,MS,33.896917,-88.329194,590,NEXRAD
+KGYX,Portland,ME,43.891306,-70.256361,474,NEXRAD
+KHDC,Hammond Municipal Airport,LA,30.5193,-90.4074,43,NEXRAD
+KHDX,Holloman Afb,NM,33.077,-106.12003,4270,NEXRAD
+KHGX,Houston,TX,29.4719,-95.078733,115,NEXRAD
+KHNX,San Joaquin Valley,CA,36.314181,-119.63213,340,NEXRAD
+KHPX,Fort Campbell,KY,36.736972,-87.285583,613,NEXRAD
+KHTX,Huntsville,AL,34.930556,-86.083611,1859,NEXRAD
+KICT,Wichita,KS,37.654444,-97.443056,1400,NEXRAD
+KICX,Cedar City,UT,37.59105,-112.86218,10757,NEXRAD
+KILN,Cincinnati,OH,39.420483,-83.82145,1170,NEXRAD
+KILX,Lincoln,IL,40.1505,-89.336792,731,NEXRAD
+KIND,Indianapolis,IN,39.7075,-86.280278,887,NEXRAD
+KINX,Tulsa,OK,36.175131,-95.564161,749,NEXRAD
+KIWA,Phoenix,AZ,33.289233,-111.66991,1426,NEXRAD
+KIWX,Fort Wayne,IN,41.358611,-85.7,1056,NEXRAD
+KJAX,Jacksonville,FL,30.484633,-81.7019,160,NEXRAD
+KJGX,Robins Afb,GA,32.675683,-83.350833,618,NEXRAD
+KJKL,Jackson,KY,37.590833,-83.313056,1461,NEXRAD
+KLBB,Lubbock,TX,33.654139,-101.81416,3378,NEXRAD
+KLCH,Lake Charles,LA,30.125306,-93.215889,137,NEXRAD
+KLGX,Langley Hill Nw Washington,WA,47.116944,-124.10666,366,NEXRAD
+KLIX,New Orleans,LA,30.336667,-89.825417,179,NEXRAD
+KLNX,North Platte,NE,41.957944,-100.57622,3113,NEXRAD
+KLOT,Chicago,IL,41.604444,-88.084444,760,NEXRAD
+KLRX,Elko,NV,40.73955,-116.8027,6895,NEXRAD
+KLSX,St Louis,MO,38.698611,-90.682778,722,NEXRAD
+KLTX,Wilmington,NC,33.98915,-78.429108,145,NEXRAD
+KLVX,Louisville,KY,37.975278,-85.943889,833,NEXRAD
+KLWX,Sterling,VA,38.976111,-77.4875,404,NEXRAD
+KLZK,Little Rock,AR,34.8365,-92.262194,649,NEXRAD
+KMAF,Midland Odessa,TX,31.943461,-102.18925,2962,NEXRAD
+KMAX,Medford,OR,42.081169,-122.71736,7561,NEXRAD
+KMBX,Minot Afb,ND,48.393056,-100.86444,1590,NEXRAD
+KMHX,Morehead City,NC,34.775908,-76.876189,145,NEXRAD
+KMKX,Milwaukee,WI,42.9679,-88.550667,1023,NEXRAD
+KMLB,Melbourne,FL,28.113194,-80.654083,149,NEXRAD
+KMOB,Mobile,AL,30.679444,-88.24,289,NEXRAD
+KMPX,Minneapolis,MN,44.848889,-93.565528,1101,NEXRAD
+KMQT,Marquette,MI,46.531111,-87.548333,1525,NEXRAD
+KMRX,Knoxville,TN,36.168611,-83.401944,1434,NEXRAD
+KMSX,Missoula,MT,47.041,-113.98622,7978,NEXRAD
+KMTX,Salt Lake City,UT,41.262778,-112.44777,6594,NEXRAD
+KMUX,San Francisco,CA,37.155222,-121.89844,3550,NEXRAD
+KMVX,Grand Forks,ND,47.527778,-97.325556,1083,NEXRAD
+KMXX,Maxwell Afb,AL,32.53665,-85.78975,560,NEXRAD
+KNKX,San Diego,CA,32.919017,-117.0418,1052,NEXRAD
+KNQA,Memphis,TN,35.344722,-89.873333,435,NEXRAD
+KOAX,Omaha,NE,41.320369,-96.366819,1262,NEXRAD
+KOHX,Nashville,TN,36.247222,-86.5625,676,NEXRAD
+KOKX,New York City,NY,40.865528,-72.863917,199,NEXRAD
+KOTX,Spokane,WA,47.680417,-117.62677,2449,NEXRAD
+KOUN,Norman Nssl,OK,35.236058,-97.46235,1284,TEST
+KPAH,Paducah,KY,37.068333,-88.771944,506,NEXRAD
+KPBZ,Pittsburgh,PA,40.531717,-80.217967,1266,NEXRAD
+KPDT,Pendleton,OR,45.69065,-118.85293,1580,NEXRAD
+KPOE,Fort Polk,LA,31.155278,-92.976111,473,NEXRAD
+KPUX,Pueblo,CO,38.45955,-104.18135,5363,NEXRAD
+KRAX,Raleigh Durham,NC,35.665519,-78.48975,462,NEXRAD
+KRGX,Reno,NV,39.754056,-119.46202,8396,NEXRAD
+KRIW,Riverton,WY,43.066089,-108.4773,5633,NEXRAD
+KRLX,Charleston,WV,38.311111,-81.722778,1213,NEXRAD
+KRTX,Portland,OR,45.715039,-122.965,1728,NEXRAD
+KSFX,Pocatello,ID,43.1056,-112.68613,4539,NEXRAD
+KSGF,Springfield,MO,37.235239,-93.400419,1375,NEXRAD
+KSHV,Shreveport,LA,32.450833,-93.84125,387,NEXRAD
+KSJT,San Angelo,TX,31.371278,-100.4925,2004,NEXRAD
+KSOX,Santa Ana Mountains,CA,33.817733,-117.636,3106,NEXRAD
+KSRX,Fort Smith,AR,35.290417,-94.361889,737,NEXRAD
+KTBW,Tampa,FL,27.7055,-82.401778,122,NEXRAD
+KTFX,Great Falls,MT,47.459583,-111.38533,3805,NEXRAD
+KTLH,Tallahassee,FL,30.397583,-84.328944,177,NEXRAD
+KTLX,Oklahoma City,OK,35.333361,-97.277761,1278,NEXRAD
+KTWX,Topeka,KS,38.99695,-96.23255,1415,NEXRAD
+KTYX,Fort Drum,NY,43.755694,-75.679861,1960,NEXRAD
+KUDX,Rapid City,SD,44.124722,-102.83,3195,NEXRAD
+KUEX,Hastings,NE,40.320833,-98.441944,2057,NEXRAD
+KVAX,Moody Afb,GA,30.890278,-83.001806,330,NEXRAD
+KVBX,Vandenberg Afb,CA,34.83855,-120.39791,1354,NEXRAD
+KVNX,Vance Afb,OK,36.740617,-98.127717,1258,NEXRAD
+KVTX,Los Angeles,CA,34.412017,-119.17875,2807,NEXRAD
+KVWX,Evansville,IN,38.26025,-87.724528,625,NEXRAD
+KYUX,Yuma,AZ,32.495281,-114.65671,239,NEXRAD
+LPLA,Lajes Ab,,38.73028,-27.32167,3334,NEXRAD
+PABC,Bethel Faa,AK,60.791944,-161.87638,193,NEXRAD
+PACG,Sitka,AK,56.852778,-135.52916,272,NEXRAD
+PAEC,Nome,AK,64.511389,-165.295,90,NEXRAD
+PAHG,Anchorage,AK,60.725914,-151.35146,356,NEXRAD
+PAIH,Middleton Island,AK,59.460767,-146.30344,132,NEXRAD
+PAKC,King Salmon,AK,58.679444,-156.62944,144,NEXRAD
+PAPD,Fairbanks,AK,65.035114,-147.50143,2707,NEXRAD
+PGUA,Andersen Afb Agana,GU,13.455833,144.811111,386,NEXRAD
+PHKI,South Kauai,HI,21.893889,-159.5525,340,NEXRAD
+PHKM,Kamuela,HI,20.125278,-155.77777,3966,NEXRAD
+PHMO,Molokai,HI,21.132778,-157.18027,1444,NEXRAD
+PHWA,South Shore,HI,19.095,-155.56888,1461,NEXRAD
+RKJK,Kunsan,,35.924167,126.622222,192,NEXRAD
+RKSG,Camp Humphreys,,37.207569,127.285561,1521,NEXRAD
+RODN,Kadena,,26.3078,127.903469,412,NEXRAD
+TADW,Andrews Afb,MD,38.695,-76.845,344,TDWR
+TATL,Atlanta,GA,33.646944,-84.261944,1076,TDWR
+TBNA,Nashville,TN,35.98,-86.661944,817,TDWR
+TBOS,Boston,MA,42.158056,-70.933056,262,TDWR
+TBWI,Baltimore Washington,MD,39.09,-76.63,299,TDWR
+TCLT,Charlotte,NC,35.336944,-80.885,869,TDWR
+TCMH,Columbus,OH,40.006111,-82.715,1148,TDWR
+TCVG,Covington,KY,38.898056,-84.58,1053,TDWR
+TDAL,Dallas Love Field,TX,32.926111,-96.968056,623,TDWR
+TDAY,Dayton,OH,40.021944,-84.123056,1020,TDWR
+TDCA,Washington National,MD,38.758889,-76.961944,344,TDWR
+TDEN,Denver,CO,39.728056,-104.52611,5702,TDWR
+TDFW,Dallas Ft Worth,TX,33.065,-96.918056,584,TDWR
+TDTW,Detroit,MI,42.111111,-83.515,771,TDWR
+TEWR,Newark,NJ,40.593056,-74.27,135,TDWR
+TFLL,Ft Lauderdale,FL,26.143056,-80.343889,121,TDWR
+THOU,Houston Hobby,TX,29.516111,-95.241944,118,TDWR
+TIAD,Washington Dulles,VA,39.083889,-77.528889,472,TDWR
+TIAH,Houston International,TX,30.065,-95.566944,253,TDWR
+TICH,Wichita,KS,37.506944,-97.436944,1352,TDWR
+TIDS,Indianapolis,IN,39.636944,-86.436111,846,TDWR
+TJBQ,Rafael Hernandez Airport,PR,18.485,-67.143,280,TDWR
+TJFK,New York City Jfk,NY,40.588889,-73.881111,112,TDWR
+TJRV,Jose Aponte De La Torre Airpor,PR,18.256,-65.637,50,TDWR
+TJUA,San Juan,PR,18.115667,-66.078167,2958,NEXRAD
+TLAS,Las Vegas,NV,36.143889,-115.00694,2057,TDWR
+TLVE,Cleveland,OH,41.29,-82.008056,932,TDWR
+TMCI,Kansas City,MO,39.498056,-94.741944,1089,TDWR
+TMCO,Orlando International,FL,28.343889,-81.326111,171,TDWR
+TMDW,Chicago Midway,IL,41.651111,-87.73,764,TDWR
+TMEM,Memphis,MS,34.896111,-89.993056,482,TDWR
+TMIA,Miami,FL,25.758056,-80.491111,125,TDWR
+TMKE,Milwaukee,WI,42.818889,-88.046111,932,TDWR
+TMSP,Minneapolis,MN,44.871111,-92.933056,1122,TDWR
+TMSY,New Orleans,LA,30.021944,-90.403056,98,TDWR
+TOKC,Norman Wfo,OK,35.276111,-97.51,1309,TDWR
+TORD,Chicago Ohare,IL,41.796944,-87.858056,745,TDWR
+TPBI,West Palm Beach,FL,26.688056,-80.273056,135,TDWR
+TPHL,Philadelphia,NJ,39.948889,-75.068889,154,TDWR
+TPHX,Phoenix,AZ,33.421111,-112.16305,1089,TDWR
+TPIT,Pittsburgh,PA,40.501111,-80.486111,1385,TDWR
+TRDU,Raleigh,NC,36.001944,-78.696944,515,TDWR
+TSDF,Louisville,KY,38.046111,-85.61,732,TDWR
+TSJU,San Juan,PR,18.473889,-66.178889,157,TDWR
+TSLC,Salt Lake City,UT,40.966944,-111.93,4295,TDWR
+TSTL,St Louis,MO,38.805,-90.488889,646,TDWR
+TTPA,Tampa,FL,27.86,-82.518056,92,TDWR
+TTUL,Tulsa,OK,36.071111,-95.826944,823,TDWR

{usdata-0.9.0 → usdata-0.10.0}/src/usdata/data/registry.yaml RENAMED Viewed

@@ -1,5 +1,5 @@
 # Curated dataset registry: the single source of truth for what usdata knows about.
-# Rendered to docs/reference/datasets.md and the README by `just docs`.
+# Rendered exclusively to docs/generated/catalog/ by `just docs`.
 #
 # status: available = adapter implemented and tested (since: version it shipped in)
 #         stub      = adapter class exists but raises NotImplementedProvider (target: version or later)
@@ -196,20 +196,21 @@ datasets:
   - id: noaa:coops-water-levels
     provider: noaa
-    status: planned
+    status: available
     domain: sea-level-tides
-    target: later
-    title: CO-OPS Water Levels and Tides
+    since: "0.10"
+    title: CO-OPS Observed Water Levels
     description: >-
-      Observed and predicted water levels, tide predictions, and related
-      products for NWLON tide stations from the CO-OPS Data API, with a
-      companion metadata API for station lookup. Anonymous REST with
-      station, product, datum, and date-range parameters.
+      Preliminary or verified six-minute observed water levels from the
+      anonymous CO-OPS Data API. Select one station, an explicit vertical datum,
+      units, and a UTC interval of at most 28 days. Raw CSV retains quality flags;
+      predictions and station discovery are not included.
     keywords: [tides, water level, sea level, coastal, coops, nwlon, stations]
     protocol: http
     homepage: https://api.tidesandcurrents.noaa.gov/api/prod/
     license: US Government Work (public domain)
-    capabilities: { spatial_subset: false, temporal_subset: true, variable_subset: true }
+    capabilities: { spatial_subset: false, temporal_subset: true, variable_subset: false }
+    adapter: usdata.providers.noaa.coops:CoopsWaterLevels
   - id: noaa:gsom
     provider: noaa
@@ -232,18 +233,21 @@ datasets:
   - id: noaa:gsoy
     provider: noaa
-    status: planned
+    status: available
     domain: surface-weather
-    target: later
+    since: "0.10"
     title: Global Summary of the Year
     description: >-
       Annual station summaries derived from GHCN-Daily via the NCEI Access Data
-      Service dataset global-summary-of-the-year. Shares the GHCN-Daily client.
+      Service dataset global-summary-of-the-year. Selects complete UTC calendar
+      years and explicit stations, or discovers stations through the search service.
     keywords: [climate, annual, stations, temperature, precipitation, gsoy, ncei]
     protocol: http
     homepage: https://www.ncei.noaa.gov/access/search/data-search/global-summary-of-the-year
     license: US Government Work (public domain)
     capabilities: { spatial_subset: false, temporal_subset: true, variable_subset: true }
+    spatial_extent: { west: -180.0, south: -90.0, east: 180.0, north: 90.0 }
+    adapter: usdata.providers.noaa.gsoy:GlobalSummaryYearly
   - id: noaa:climate-normals
     provider: noaa
@@ -675,3 +679,96 @@ datasets:
     homepage: https://www.nass.usda.gov/Research_and_Science/Cropland/SARS1a.php
     license: US Government Work (public domain)
     capabilities: { spatial_subset: true, temporal_subset: true, variable_subset: false }
+# Documentation composition keyed by stable dataset ID; validated by just docs.
+catalog:
+  noaa:ghcn-daily:
+    guide: docs/providers/noaa-ghcn.md
+    summary: Daily station weather
+    formats:
+    - CSV
+    selection: Station observations within inclusive calendar dates; selected elements
+    inputs: Both dates; station IDs or a geographic query
+    reader_extra: pandas
+    examples:
+    - examples/weather-and-streamflow/example.ipynb
+  noaa:gsom:
+    guide: docs/providers/noaa-gsom.md
+    summary: Monthly station climate
+    formats:
+    - CSV
+    selection: Complete UTC calendar months touched by the query; station and element filters
+    inputs: Both dates; station IDs or a geographic query
+    reader_extra: pandas
+    examples:
+    - examples/monthly-climate/example.ipynb
+  noaa:gsoy:
+    guide: docs/providers/noaa-gsoy.md
+    summary: Annual station climate
+    formats:
+    - CSV
+    selection: Complete UTC calendar years touched by the query; station and element filters
+    inputs: Both dates; station IDs or a geographic query
+    reader_extra: pandas
+    examples:
+    - examples/annual-climate/README.md
+  noaa:nexrad-level2:
+    guide: docs/providers/noaa-nexrad.md
+    summary: NEXRAD radar scans
+    formats:
+    - NEXRAD Level II
+    selection: Whole radar scans by site and inclusive UTC scan-start time
+    inputs: Both timestamps; radar IDs or a geographic query
+    reader_extra: radar
+    examples:
+    - examples/radar-reflectivity/example.ipynb
+  noaa:goes-abi:
+    guide: docs/providers/noaa-goes.md
+    summary: GOES CONUS imagery
+    formats:
+    - NetCDF4
+    selection: Whole single-channel CONUS scenes by inclusive UTC scan-start time
+    inputs: Satellite, channel, and both timestamps
+    reader_extra: netcdf
+    examples:
+    - examples/goes-imagery/example.ipynb
+  noaa:storm-events:
+    guide: docs/providers/noaa-storm-events.md
+    summary: Storm Events details
+    formats:
+    - gzip CSV
+    selection: Whole annual archives; filter rows locally after downloading
+    inputs: Both dates (selects the containing years)
+    reader_extra: pandas
+    examples:
+    - examples/storm-events/example.ipynb
+  noaa:coastwatch-sst:
+    guide: docs/providers/noaa-coastwatch.md
+    summary: Sea-surface temperature
+    formats:
+    - CSV with units row
+    selection: Grid centers and timestamps inside the requested bounds; optional stride
+    inputs: BBox or location, and both timestamps
+    reader_extra: pandas
+    examples:
+    - examples/sst-analysis/example.ipynb
+  noaa:coops-water-levels:
+    guide: docs/providers/noaa-coops.md
+    summary: Coastal water levels
+    formats:
+    - CSV
+    selection: Six-minute observations for one station and datum; at most 28 days
+    inputs: Station, datum, and both minute-aligned timestamps
+    reader_extra: pandas
+    examples:
+    - examples/coastal-water-levels/README.md
+  usgs:water-daily:
+    guide: docs/providers/usgs-water-daily.md
+    summary: Daily water observations
+    formats:
+    - CSV
+    selection: Site observations for inclusive local calendar dates; parameter and statistic filters
+    inputs: Both dates; site IDs or a geographic query
+    reader_extra: pandas
+    examples:
+    - examples/weather-and-streamflow/example.ipynb

usdata-0.10.0/src/usdata/providers/noaa/coops.py ADDED Viewed

@@ -0,0 +1,141 @@
+"""Observed six-minute CO-OPS water levels as raw CSV.
+Params: one seven-digit ``station``, an explicit ``datum``, and optional
+``units`` (metric or english). Both dates are required at minute precision;
+requests use UTC and span at most 28 days. Predictions are not included.
+"""
+from __future__ import annotations
+import csv
+import hashlib
+from datetime import UTC, datetime, timedelta
+from pathlib import Path
+import httpx
+from usdata._files import staged_path
+from usdata.models import Asset, Protocol, Query, TimeRange
+from usdata.protocols import http
+from usdata.providers._http import _HttpProvider
+from usdata.providers.base import QueryError
+DATA_URL = "https://api.tidesandcurrents.noaa.gov/api/prod/datagetter"
+DATUMS = {"CRD", "IGLD", "LWD", "MHHW", "MHW", "MTL", "MSL", "MLW", "MLLW", "NAVD", "STND"}
+MAX_INTERVAL = timedelta(days=28)
+REQUIRED_COLUMNS = {
+    "Date Time",
+    "Water Level",
+    "Sigma",
+    "O or I (for verified)",
+    "F",
+    "R",
+    "L",
+    "Quality",
+}
+def _validate_csv(path: Path, asset: Asset) -> None:
+    """Reject error documents and malformed/empty responses before committing bytes."""
+    try:
+        with path.open(encoding="utf-8-sig", newline="") as stream:
+            records = csv.reader(stream, strict=True)
+            columns = [name.strip() for name in next(records, [])]
+            if (
+                any(not name for name in columns)
+                or len(set(columns)) != len(columns)
+                or not REQUIRED_COLUMNS.issubset(columns)
+            ):
+                raise ValueError("missing expected water-level CSV columns")
+            count = 0
+            for values in records:
+                if values and values[0].startswith("Error:"):
+                    raise ValueError(values[0][:512])
+                if len(values) != len(columns):
+                    raise ValueError("CSV row does not match the header")
+                row = dict(zip(columns, values, strict=True))
+                when = datetime.strptime(row["Date Time"].strip(), "%Y-%m-%d %H:%M").replace(
+                    tzinfo=UTC
+                )
+                if asset.time is not None and not asset.time.overlaps(
+                    TimeRange(start=when, end=when)
+                ):
+                    raise ValueError("observation lies outside the requested interval")
+                if row["Quality"].strip() not in {"p", "v"}:
+                    raise ValueError("unrecognized observation quality")
+                for field in ("Water Level", "Sigma"):
+                    if row[field].strip():
+                        float(row[field])
+                count += 1
+            if not count:
+                raise ValueError("no water-level observations returned")
+    except (ValueError, UnicodeError, csv.Error) as error:
+        raise httpx.DecodingError(
+            f"CO-OPS returned no usable water-level CSV: {error}",
+            request=httpx.Request("GET", asset.href),
+        ) from error
+class CoopsWaterLevels(_HttpProvider):
+    """One station's observed water levels, preserving source units and quality fields."""
+    def list_assets(self, query: Query) -> list[Asset]:
+        """Describe one bounded CSV request; availability is checked during fetching."""
+        if unknown := set(query.params) - {"station", "datum", "units"}:
+            raise QueryError(f"unsupported {self.dataset.id} params: {', '.join(sorted(unknown))}")
+        if query.bbox is not None or query.text is not None or query.variables:
+            raise QueryError(
+                "CO-OPS requires an explicit station; location, text and variables are unsupported"
+            )
+        station = query.params.get("station")
+        if (
+            not isinstance(station, str)
+            or len(station) != 7
+            or not station.isascii()
+            or not station.isdigit()
+        ):
+            raise QueryError("station must be a seven-digit string, for example '8518750'")
+        datum = query.params.get("datum")
+        if not isinstance(datum, str) or datum not in DATUMS:
+            raise QueryError(f"datum must be explicit: {', '.join(sorted(DATUMS))}")
+        units = query.params.get("units", "metric")
+        if units not in ("metric", "english"):
+            raise QueryError("units must be metric or english")
+        if query.time is None or query.time.start is None or query.time.end is None:
+            raise QueryError(f"{self.dataset.id} requires both start and end timestamps")
+        start = query.time.start.replace(tzinfo=query.time.start.tzinfo or UTC).astimezone(UTC)
+        end = query.time.end.replace(tzinfo=query.time.end.tzinfo or UTC).astimezone(UTC)
+        if any(value.second or value.microsecond for value in (start, end)):
+            raise QueryError("CO-OPS timestamps must have minute precision (zero seconds)")
+        if end - start > MAX_INTERVAL:
+            raise QueryError("CO-OPS requests must span at most 28 days; split longer intervals")
+        params = {
+            "station": station,
+            "product": "water_level",
+            "begin_date": start.strftime("%Y%m%d %H:%M"),
+            "end_date": end.strftime("%Y%m%d %H:%M"),
+            "datum": datum,
+            "units": units,
+            "time_zone": "gmt",
+            "format": "csv",
+            "application": "usdata",
+        }
+        url = str(httpx.URL(DATA_URL, params=params))
+        digest = hashlib.sha256(url.encode()).hexdigest()[:16]
+        return [
+            Asset(
+                id=f"water_level_{station}_{digest}.csv",
+                dataset_id=self.dataset.id,
+                href=url,
+                protocol=Protocol.HTTP,
+                media_type="text/csv",
+                time=TimeRange(start=start, end=end),
+            )
+        ]
+    def fetch(self, asset: Asset, dest: Path) -> Path:
+        """Download raw CSV, validating the response before replacing the destination."""
+        with staged_path(dest) as temporary:
+            http.download(asset.href, temporary, self._http())
+            _validate_csv(temporary, asset)
+        return dest

usdata-0.10.0/src/usdata/providers/noaa/gsoy.py ADDED Viewed

@@ -0,0 +1,46 @@
+"""Annual station summaries through the NCEI Access Data Service.
+Params: ``stations`` (list or comma string) and ``units`` (metric or standard).
+Both dates are required; every UTC calendar year touched by the interval is
+selected in full. Geographic discovery uses the same normalized year bounds.
+"""
+from datetime import UTC
+from usdata.models import Asset, Query, TimeRange
+from usdata.providers.base import QueryError
+from usdata.providers.noaa.ghcnd import GhcnDaily
+class GlobalSummaryYearly(GhcnDaily):
+    """GSOY CSV subsets, reusing NCEI station discovery and HTTP transport."""
+    ncei_dataset = "global-summary-of-the-year"
+    def _yearly_query(self, query: Query) -> Query:
+        if query.text is not None:
+            raise QueryError(f"{self.dataset.id} does not support text queries")
+        if "stations" in query.params and query.bbox is not None:
+            raise QueryError("pass stations or a location/bbox, not both")
+        if query.time is None or query.time.start is None or query.time.end is None:
+            raise QueryError(f"{self.dataset.id} requires both start and end dates")
+        start = query.time.start.replace(tzinfo=query.time.start.tzinfo or UTC).astimezone(UTC)
+        end = query.time.end.replace(tzinfo=query.time.end.tzinfo or UTC).astimezone(UTC)
+        return query.model_copy(
+            update={
+                "time": TimeRange(
+                    start=start.replace(month=1, day=1, hour=0, minute=0, second=0, microsecond=0),
+                    end=end.replace(
+                        month=12, day=31, hour=23, minute=59, second=59, microsecond=999999
+                    ),
+                )
+            }
+        )
+    def find_stations(self, query: Query) -> list[str]:
+        """Find stations overlapping the selected complete calendar years."""
+        return super().find_stations(self._yearly_query(query))
+    def list_assets(self, query: Query) -> list[Asset]:
+        """Resolve annual CSVs with stable URLs and complete-year asset bounds."""
+        return super().list_assets(self._yearly_query(query))

{usdata-0.9.0 → usdata-0.10.0}/src/usdata/readers.py RENAMED Viewed

@@ -58,8 +58,9 @@ def open_asset(
     Gzip CSVs are decompressed locally without changing cached bytes.
     Infer ``csv`` or ``erddap-csv`` from media type and protocol, or use an
     explicit reader for ambiguous metadata. Identifier columns default to pandas
-    strings; explicit dtype entries override those defaults. Dates remain strings
-    unless named in parse_dates. No checksum verification or downloading occurs.
+    strings; explicit dtype entries override those defaults. Dates are not parsed
+    unless named in parse_dates; use dtype to preserve numeric-looking date labels
+    as strings. No checksum verification or downloading occurs.
     Radar accepts zero-based ``sweep`` indices (one integer or a non-empty list);
     the default opens the whole volume after checking sweep record alignment.
     """