Metadata-Version: 2.5
Name: waterledger-models
Version: 3.1.0
Summary: Water Ledger's models: weather-driven data center cooling water (towers, hybrid, closed loop, lake-source) with Monte Carlo uncertainty, staff water, and site runoff quality
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: numpy>=1.24
Provides-Extra: all
Requires-Dist: bmipy>=2.0; extra == 'all'
Requires-Dist: dask[array]>=2023.1; extra == 'all'
Requires-Dist: pystac>=1.10; extra == 'all'
Requires-Dist: pyyaml>=6; extra == 'all'
Requires-Dist: xarray>=2023.1; extra == 'all'
Requires-Dist: zarr>=2.16; extra == 'all'
Provides-Extra: bmi
Requires-Dist: bmipy>=2.0; extra == 'bmi'
Requires-Dist: pyyaml>=6; extra == 'bmi'
Requires-Dist: xarray>=2023.1; extra == 'bmi'
Provides-Extra: ensemble
Requires-Dist: dask[array]>=2023.1; extra == 'ensemble'
Requires-Dist: xarray>=2023.1; extra == 'ensemble'
Provides-Extra: stac
Requires-Dist: dask[array]>=2023.1; extra == 'stac'
Requires-Dist: pystac>=1.10; extra == 'stac'
Requires-Dist: xarray>=2023.1; extra == 'stac'
Requires-Dist: zarr>=2.16; extra == 'stac'
Description-Content-Type: text/markdown

# waterledger-models

The models behind [Water Ledger](https://waterledger.org): the water large new users take, use up and send back,
starting with data centers.

```bash
pip install waterledger-models          # numpy only
pip install "waterledger-models[all]"   # with xarray ensembles, BMI components and STAC publishing
```

- `datacenter.physics`: the cooling equations and parameter ranges, vectorized (Rutberg evaporative ratio as in USGS
  SIR 2013-5188, DOE FEMP water balance, Stull wet bulb).
- `datacenter.cooling`: the per-run Monte Carlo over decades of hourly weather for towers, hybrid, and closed loop with
  or without evaporative assist; staff water at the campus's size.
- `datacenter.lake`: lake-source (once-through) cooling with forced lake evaporation (USGS heat-balance method).
- `datacenter.ensemble`: vectorized ensembles as xarray, dask across locations (`[ensemble]`).
- `datacenter.bmi`: `CoolingWaterBmi` and `LakeCoolingBmi`, CSDMS BMI 2.0 with CSDMS Standard Names (`[bmi]`).
- `datacenter.stac`: ensemble results as zarr with a STAC catalog (`[stac]`).
- `hydrology`: screening hydrology: SCS curve-number runoff, Theis drawdown and Glover stream depletion.
- `runoff`: runoff, sediment, nutrients, road salt and fuel from a developed site.
- `weather`: hourly ERA5 weather from the Open-Meteo archive.

`MODEL_VERSION` is Water Ledger's model version (1.2), which changes when the numbers do; the package version (semver)
changes with the code. They are independent.
