energy_data_retrieval.bess_catalogue.catalogue#

Validate reviewable BESS records and publish immutable, typed Parquet snapshots.

One row represents a named project with an explicit capacity scope. Power (MW) and energy (MWh) are separate; neither implies usable AC output unless sourced. No network calls, inferred operating status or automatic conflict resolution.

energy_data_retrieval.bess_catalogue.catalogue.stable_id(country_code, locality, original_name)[source]#

Choose identity once; renames and capacity changes must retain the ID.

Parameters:
  • country_code (str)

  • locality (str)

  • original_name (str)

Return type:

str

energy_data_retrieval.bess_catalogue.catalogue.validate_record(row, sources)[source]#

Reject unknown columns, invalid units, undated status and unsupported facts.

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

  • sources (dict[str, Any])

Return type:

None

energy_data_retrieval.bess_catalogue.catalogue.validate_catalogue(rows, sources)[source]#

Check record identity and external registry crosswalks before publication.

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

  • sources (dict[str, Any])

Return type:

None

energy_data_retrieval.bess_catalogue.catalogue.build_parquet(root, output)[source]#

Build a new Zstandard snapshot, preserving nulls and field/source metadata.

Output must not exist. Canonical records remain in Git; the manifest identifies the exact schema, records and source registry used to reproduce the snapshot.

Parameters:
  • root (Path)

  • output (Path)

Return type:

dict[str, Any]