energy_data_retrieval.station_discovery#

Bounded station inventories for location discovery, with explicit source status.

Loading an inventory verifies catalogue metadata only. It never certifies the availability, continuity, quality or spatial representativeness of observations.

class energy_data_retrieval.station_discovery.StationCatalogue(source: 'str', status: 'str', frame: 'pd.DataFrame', coverage_scope: 'dict[str, JSONValue]', reference_ids: 'tuple[str, ...]', requests: 'list[dict[str, JSONValue]]', notes: 'list[str]')[source]#

Bases: object

Parameters:
  • source (str)

  • status (str)

  • frame (DataFrame)

  • coverage_scope (dict[str, JSONValue])

  • reference_ids (tuple[str, ...])

  • requests (list[dict[str, JSONValue]])

  • notes (list[str])

source: str#
status: str#
frame: DataFrame#
coverage_scope: dict[str, JSONValue]#
reference_ids: tuple[str, ...]#
requests: list[dict[str, JSONValue]]#
notes: list[str]#
energy_data_retrieval.station_discovery.load_station_catalogue(source, http, *, local_path=None)[source]#

Load one verified inventory and report failures without hiding other sources.

An explicit local snapshot is never replaced by a fresh request on validation failure. Callers may rank a successful frame, but a failure frame is not evidence that no stations exist near the requested location.

Parameters:
  • source (str)

  • http (HTTPClient | None)

  • local_path (Path | None)

Return type:

StationCatalogue