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: