energy_data_retrieval.hydro_catalogue.catalogue#
Hydropower identity, physical boundaries and deterministic offline snapshots.
- energy_data_retrieval.hydro_catalogue.catalogue.build_parquet(root, output)[source]#
Validate JSONL and publish an immutable, typed Zstandard snapshot.
- Parameters:
root (Path)
output (Path)
- Return type:
dict[str, Any]
- energy_data_retrieval.hydro_catalogue.catalogue.capacity_summary(rows, field)[source]#
Separate lifecycle, technology and historical vintage; exclude ambiguous scopes.
- Parameters:
rows (list[dict[str, Any]])
field (str)
- Return type:
dict[str, Any]
- energy_data_retrieval.hydro_catalogue.catalogue.stable_id(entity_type, *identity)[source]#
Use immutable registry identity, never mutable plant capacity or ownership.
- Parameters:
entity_type (str)
identity (str)
- Return type:
str
- energy_data_retrieval.hydro_catalogue.catalogue.upsert_records(existing, incoming, *, now)[source]#
Preserve creation dates and quarantine conflicts using the shared upsert.
- Parameters:
existing (list[dict[str, Any]])
incoming (list[dict[str, Any]])
now (str)
- Return type:
tuple[list[dict[str, Any]], list[dict[str, Any]]]