energy_data_retrieval.sources.elexon.client#

Half-hourly BM-unit metered energy from Elexon Insights B1610.

B1610 quantity is MWh, including negative demand and zero. It is published through settlement, not live SCADA. Dates and settlement periods identify 46/48/50 half-hour civil days in Great Britain; source end labels are UTC.

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

Normalize a native B1610 stream without guessing away settlement revisions.

One row identifies a BM unit and settlement interval. Exact duplicate rows collapse, but conflicting values or different runs for that same key raise: the endpoint normally returns the latest available run. All quantities are signed metered MWh; the API’s generic psrType is not a fuel classification.

Parameters:
  • payload (JSONValue)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.elexon.client.ElexonClient(http, maximum_requests=64, maximum_rows=1000000)[source]#

Bases: object

No-key B1610 retrieval, bounded to six-hour UTC request chunks.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

http: HTTPClient#
maximum_requests: int#
maximum_rows: int#
generation(start, end, *, bm_unit=None)[source]#

Fetch inclusive UK settlement dates, optionally selecting one exact BM unit.

The API uses inclusive interval-start bounds. Six-hour requests avoid one unbounded all-unit response; maximum_rows also limits the combined result. No BM-unit registry or generation technology is inferred.

Parameters:
  • start (date)

  • end (date)

  • bm_unit (str | None)

Return type:

GenerationResult