Metadata-Version: 2.4
Name: ercot-grid-ref
Version: 0.1.0
Summary: Shared ERCOT weather-zone, hub, load-zone, and metro alias enums for Scientifiq consumers
Author: Scientifiq
License: Proprietary
Project-URL: Homepage, https://github.com/gareth314/data_ercot-s3-exploration-and-schemas
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"

# ercot-grid-ref

Shared ERCOT naming enums for Scientifiq Python consumers (Wraith, ercot-data
emitters, orchestrator `simulation_setup`, geo analytics).

## Install

```bash
pip install ercot-grid-ref
```

Editable (from this monorepo package):

```bash
pip install -e packages/ercot-grid-ref
```

## Contents

| Symbol | Role |
|--------|------|
| `WEATHER_ZONES` | Eight ERCOT weather zones (Coast…West), Kalman `l_t` order |
| `WEATHER_ZONE_COLUMN_ALIASES` | Bronze CSV column aliases → canonical zone |
| `HUB_ZONES` | Hub Zone settlement points (`HB_HOUSTON`…`HB_WEST`) |
| `LOAD_ZONES` | Common Load Zone labels (`LZ_*`) |
| `REGION_TO_WEATHER_ZONE` | Metro / corridor aliases → weather zone |
| `normalize_region` | Normalize a free-text region label |

System total MW is **not** a weather zone — use `SYSTEM_TOTAL` / derive from
the eight zones. Hub Average (`HB_HUBAVG`) is intentionally absent from
`HUB_ZONES` (validation series only, never a Houston proxy).
