energy_data_retrieval.grid_discovery#
Location-based candidates and bounded evidence for existing gridded sources.
Documented global coverage is a discovery hint, not a data-availability check. Only an explicit sample request resolves an Open-Meteo cell and one UTC day of values. A CMIP6 catalogue plan establishes dataset/file identity, not the presence of a variable at a point on its native grid.
- energy_data_retrieval.grid_discovery.grid_datasets(latitude, longitude, *, start=None, end=None)[source]#
Describe only integrated products; perform no network or file reads.
Optional inclusive dates annotate compatibility with documented coverage. Unknown coverage is retained explicitly, and a documented overlap never verifies actual values or recent availability. Snapshot dates and CMIP6 grid coordinates are not inferred from a generic product’s headline coverage.
- Parameters:
latitude (float)
longitude (float)
start (date | None)
end (date | None)
- Return type:
list[dict[str, JSONValue]]
- energy_data_retrieval.grid_discovery.verify_open_meteo(http, candidates, *, day)[source]#
Probe at most the two integrated Open-Meteo products for one UTC day.
The existing adapters request the extra endpoint needed for interval alignment. Each successful sample reports null counts; a partial sample never establishes complete availability. Failed providers do not discard other results, and raw exception messages are excluded from the report. The public route is used; no credentials are read from the environment.
- Parameters:
http (HTTPClient)
candidates (list[dict[str, JSONValue]])
day (date)
- Return type:
list[dict[str, JSONValue]]
- energy_data_retrieval.grid_discovery.cmip6_plan_candidates(plan, latitude, longitude)[source]#
Summarize an existing validated catalogue plan without reading native files.
Use a plan returned by
CMIP6Client.searchorload_plan. The requested point is context only and was not an ESGF search filter. Selected native file labels, provider metadata and citation links remain intact; point coverage stays unknown.- Parameters:
plan (CMIP6Plan)
latitude (float)
longitude (float)
- Return type:
list[dict[str, JSONValue]]