energy_data_retrieval.sources.ieso.client#

Ontario’s public hourly generator output, distinct from capability/forecasts.

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

Parse only Outputs/Output/EnergyMW from a native IESO daily XML report.

Source Hour 1 covers 00:00-01:00 and Hour 24 covers 23:00-24:00, in fixed Eastern Standard Time (UTC-05), including summer. timestamp is the UTC interval start. Published values are hourly averages of operational MW telemetry, not settlement-meter MWh. Missing telemetry remains NaN.

Parameters:
  • payload (str)

  • maximum_rows (int)

Return type:

DataFrame

class energy_data_retrieval.sources.ieso.client.IESOClient(http, maximum_requests=31, maximum_rows=1000000)[source]#

Bases: object

Fetch bounded daily reports from IESO’s public recent XML archive.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

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

Retrieve inclusive EST report dates; archive retention is provider-limited.

The public XML archive normally covers 90 days. Older monthly CSV files are a separate product and are not silently substituted. A missing report raises a retrieval error instead of manufacturing zero output.

Parameters:
  • start (date)

  • end (date)

  • unit_ids (list[str] | None)

Return type:

GenerationResult