Metadata-Version: 2.5
Name: waterledger-data
Version: 3.15.0
Summary: Public U.S. water data for any place, fetched once and cached: Census places, EPA water systems and sewer plants, USGS watersheds, EPA ATTAINS, NOAA weather and design storms, EIA utilities
Project-URL: Homepage, https://waterledger.org
Project-URL: Source, https://github.com/northlinehydrology/waterledger
Project-URL: Issues, https://github.com/northlinehydrology/waterledger/issues
Author-email: Northline Hydrology <info@northlinehydrology.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Hydrology
Requires-Python: >=3.11
Requires-Dist: certifi>=2024.2
Requires-Dist: geopandas>=1.0
Requires-Dist: numpy>=1.24
Requires-Dist: openpyxl>=3.1
Requires-Dist: pandas>=2.0
Requires-Dist: pyarrow>=14
Requires-Dist: pypdf>=4.0
Requires-Dist: requests>=2.28
Requires-Dist: shapely>=2.0
Requires-Dist: tqdm>=4.66
Provides-Extra: era5
Requires-Dist: fsspec>=2023.1; extra == 'era5'
Requires-Dist: omfiles>=1.2; extra == 'era5'
Requires-Dist: s3fs>=2023.1; extra == 'era5'
Provides-Extra: postgis
Requires-Dist: psycopg[binary]>=3.1; extra == 'postgis'
Provides-Extra: r2
Requires-Dist: boto3>=1.28; extra == 'r2'
Description-Content-Type: text/markdown

# waterledger-data

Public U.S. water data for any place, fetched once and cached, as used by [Water Ledger](https://waterledger.org).

```bash
pip install waterledger-data
```

| Module | What it fetches |
|---|---|
| `census` | places in any state: incorporated places, county subdivisions that are governments, counties (Census TIGERweb) |
| `supply` | community water system service areas, with SDWIS population and connections (EPA) |
| `wastewater` | sewer plants: CWNS 2022 design flows matched to ECHO recent flows and receiving waters, active permits only (EPA) |
| `receiving` | each place's HUC-12 watersheds, impairments and TMDLs by watershed (USGS WBD, EPA ATTAINS) |
| `trace` | the watershed tracer: follows a HUC-12 upstream or downstream across state lines with the impaired waters on the way (also the `waterledger-trace` command) |
| `divisions` | NOAA climate divisions, one long-record ISD station for each, county rainfall and Atlas 14 design storms |
| `climate` | hourly Open-Meteo best match (ERA5, ERA5-Land, IFS HRES), NOAA ISD weather (with sites linked across a change of station ID, `isd_sites`) and Environment and Climate Change Canada hourly station records (`eccc_sites`, `eccc_hourly`), Atlas 14 depths |
| `era5` | ERA5 hourly temperature and dew point at a place's 0.25-degree cell (the nearest at least half land), from Open-Meteo's open copy on AWS (`[era5]`), with a raw cache |
| `r2` | optional saving to a private Cloudflare R2 bucket, through wrangler or the S3 API (`[r2]`), skipped by checksum |
| `energy` | electric utility territories (HIFLD), EIA-861 sales and peaks, power-plant water per kWh by grid region (Siddik et al. 2024) |
| `grid930` | EIA-930 hourly demand and generation by fuel for every balancing authority, 2019 on, and the BA's power plant water by fuel class and month from EIA's 2024 plant reports, so its plant water hour by hour (design 0008) |
| `power` | EIA-861 retail sales and residential use for any state (`state_retail_mwh`, `residential`); Michigan's MPSC territories |
| `wateruse` | water use by county and category: USGS's revised 2015 estimates for every state (`usgs_2015`), and the states' own figures for Ohio (ODNR registration, `ohio`), Texas (TWDB Water Use Survey, `texas`) and Virginia (DEQ locality totals, `virginia`), each with its basis (year, reported or estimate, withdrawals or use) |
| `places`, `waters` | Michigan's own layers (cities and townships, EGLE water use and wells) |

Downloads are cached under `WATERLEDGER_CACHE` (default `~/.cache/waterledger`) or the `cache` path in a
`waterledger.toml`. A build that stops part way resumes from the cache.
