energy_data_retrieval.sources.rte.client#

Consolidated half-hourly French production by technology from ODRÉ.

The dataset also has quarter-hour forecasts. Their empty generation fields are not actual observations and are excluded without filling them with zero. Only the eight mutually exclusive top-level production categories are used; subcategories, pumping, consumption and imports are never double-counted.

energy_data_retrieval.sources.rte.client.normalize_generation(payload, *, maximum_rows=1000000)[source]#

Parse an Explore API 2.1 page of actual half-hourly generation in MW.

Source date_heure has an explicit UTC offset. Forecast-only quarter-hour rows are counted in metadata and omitted; null generation in a genuine half-hour row stays missing. Source nature distinguishes consolidated and definitive observations. Neither the technology detail nor a national total is summed into the top-level production categories.

Parameters:
  • payload (JSONValue)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.rte.client.RTEClient(http, maximum_requests=64, maximum_rows=1000000, page_size=100)[source]#

Bases: object

Public Explore API retrieval, paginated separately for each French civil day.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

  • page_size (int)

http: HTTPClient#
maximum_requests: int#
maximum_rows: int#
page_size: int#
generation(start, end, *, dataset='consolidated')[source]#

Fetch inclusive French civil dates from the consolidated national dataset.

Live telemetry is a different product and is deliberately not aliased to consolidated generation. Pagination must account for all advertised records; short, repeated or changing pages fail rather than truncate.

Parameters:
  • start (date)

  • end (date)

  • dataset (str)

Return type:

GenerationResult