energy_data_retrieval.bess_oem_catalogue.catalogue#
Validate reviewable BESS records and publish immutable, typed Parquet snapshots.
One row represents an OEM model/configuration with an explicit product boundary. Active MW, apparent MVA, nominal/usable MWh and test conditions remain separate. No network calls, inferred operating status or automatic conflict resolution.
- energy_data_retrieval.bess_oem_catalogue.catalogue.stable_id(manufacturer, model, variant)[source]#
Choose identity once; preserve model case and distinct configuration codes.
- Parameters:
manufacturer (str)
model (str)
variant (str)
- Return type:
str
- energy_data_retrieval.bess_oem_catalogue.catalogue.validate_record(row, sources)[source]#
Reject unknown columns, invalid units and unsupported product specifications.
- Parameters:
row (dict[str, Any])
sources (dict[str, Any])
- Return type:
None
- energy_data_retrieval.bess_oem_catalogue.catalogue.validate_catalogue(rows, sources)[source]#
Check stable IDs and exact model/configuration identity before publication.
- Parameters:
rows (list[dict[str, Any]])
sources (dict[str, Any])
- Return type:
None
- energy_data_retrieval.bess_oem_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]