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_range selects 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]