energy_data_retrieval.hydro_catalogue.ons#

ONS hydro-unit evidence with exact CEG identity and conservative plant scope.

energy_data_retrieval.hydro_catalogue.ons.parse_inventory(text)[source]#

Group distinct generator equipment by full CEG; never aggregate code variants.

Parameters:

text (str)

Return type:

list[dict[str, Any]]

energy_data_retrieval.hydro_catalogue.ons.wri_id(ceg)[source]#

Reproduce WRI build_database_BRA.py CEG numeric identity mapping.

Parameters:

ceg (str)

Return type:

str

energy_data_retrieval.hydro_catalogue.ons.eligibility(existing, item)[source]#

Require registry identity and exact names allowing only case/whitespace changes.

Parameters:
  • existing (dict[str, Any] | None)

  • item (dict[str, Any])

Return type:

str

energy_data_retrieval.hydro_catalogue.ons.enrich(existing, item, *, source_id, identity_source_id, now, review=None)[source]#

Add an immutable dated unit observation without inferring current operation.

Parameters:
  • existing (dict[str, Any])

  • item (dict[str, Any])

  • source_id (str)

  • identity_source_id (str)

  • now (str)

  • review (dict[str, Any] | None)

Return type:

dict[str, Any]

energy_data_retrieval.hydro_catalogue.ons.enrich_dispatch_metadata(existing, *, now)[source]#

Expose source-reported state/subsystem/mode without inferring a grid connection.

Multiple values remain explicit sets. Existing unit observations are immutable; the derived metadata retains their original source IDs and row locators.

Parameters:
  • existing (dict[str, Any])

  • now (str)

Return type:

dict[str, Any]