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]