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]