Metadata-Version: 2.5
Name: waterledger-data
Version: 3.8.1
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: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Hydrology
Requires-Python: >=3.11
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: postgis
Requires-Dist: psycopg[binary]>=3.1; extra == 'postgis'
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 ERA5 (Open-Meteo) and NOAA ISD weather, Atlas 14 depths |
| `energy` | electric utility territories (HIFLD), EIA-861 sales and peaks, power-plant water per kWh by grid region (Siddik et al. 2024) |
| `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.
