energy_data_retrieval.wind_catalogue.catalogue#

Wind-specific identity, capacity and performance boundaries. No implicit network I/O.

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

Reuse canonical JSONL and typed, deterministic immutable snapshot writer.

Parameters:
  • root (Path)

  • output (Path)

Return type:

dict[str, Any]

energy_data_retrieval.wind_catalogue.catalogue.capacity_summary(rows, field)[source]#

Exclude parent/overlap scopes; keep retired generations in their own lifecycle.

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

  • field (str)

Return type:

dict[str, Any]

energy_data_retrieval.wind_catalogue.catalogue.stable_id(entity_type, *identity)[source]#

Freeze an external ID or reviewed natural identity; never include mutable ratings.

Parameters:
  • entity_type (str)

  • identity (str)

Return type:

str

energy_data_retrieval.wind_catalogue.catalogue.upsert_records(existing, incoming, *, now)[source]#

Reuse dated conflict quarantine, preserving record creation and defensible fields.

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

  • incoming (list[dict[str, Any]])

  • now (str)

Return type:

tuple[list[dict[str, Any]], list[dict[str, Any]]]

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

Reject duplicate identities, dangling links, parent cycles and unsafe sums.

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

  • sources (dict[str, Any])

Return type:

None

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

Require provenance and explicit periods, units, modes and physical boundaries.

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

  • sources (dict[str, Any])

Return type:

None