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.search or load_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]]