energy_data_retrieval.gas_catalogue.eia_plants#

Exact EIA plant joins for unit site-location and plant grid metadata.

Plant coordinates locate the shared site, never an individual generator. No plant capacity, status or ownership is propagated to units by this adapter.

energy_data_retrieval.gas_catalogue.eia_plants.plant_patches(records, plants, *, source_id)[source]#

Return upsert candidates; conflicts are left for the catalogue upsert API.

Parameters:
  • records (list[dict[str, Any]])

  • plants (list[dict[str, Any]])

  • source_id (str)

Return type:

tuple[list[dict[str, Any]], list[dict[str, Any]]]

energy_data_retrieval.gas_catalogue.eia_plants.parse_plant_patches(data, records, *, source_id)[source]#

Read the original 2025 EIA archive without network access.

Parameters:
  • data (bytes)

  • records (list[dict[str, Any]])

  • source_id (str)

Return type:

tuple[list[dict[str, Any]], list[dict[str, Any]]]