energy_data_retrieval.wind_catalogue.eia#
Read bounded EIA annual wind partitions without promoting unit status to farms.
- energy_data_retrieval.wind_catalogue.eia.parse_retired_partition(wind, plant, *, year, wind_sha256, plant_sha256, operable_range=None)[source]#
Return every nonoperable wind plant group, retaining original unit rows.
This is a complete workbook tab, not a complete historical retirement census. By default operable rows supply context only.
operable_rangeselects a complete inclusive plant-code range instead; hybrid scope stays open.- Parameters:
wind (bytes)
plant (bytes)
year (int)
wind_sha256 (str)
plant_sha256 (str)
operable_range (tuple[int, int] | None)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.wind_catalogue.eia.enrich_retired_partition(candidates, existing, approved, *, source_id, identity_source_id, now)[source]#
Apply reviewed exact IDs with independent name and coordinate agreement.
Preserve farm status, capacity, historical observations and creation timestamps. A source revision is immutable and replay is idempotent.
- Parameters:
candidates (list[dict[str, Any]])
existing (list[dict[str, Any]])
approved (dict[int, str])
source_id (str)
identity_source_id (str)
now (str)
- Return type:
list[dict[str, Any]]
- energy_data_retrieval.wind_catalogue.eia.stage_reviewed_site(item, *, source_id, now)[source]#
Stage one independently reviewed new EIA site, without inferring farm totals.
Caller must review existing registry IDs, names, coordinates and related phases. Unit observations retain status and capacity; unresolved farm scope excludes sums.
- Parameters:
item (dict[str, Any])
source_id (str)
now (str)
- Return type:
dict[str, Any]