energy_data_retrieval.sources.xm.client#

Colombia’s SIMEM hourly actual-generation settlement dataset (055A4D).

energy_data_retrieval.sources.xm.client.parse_generation(payload, *, version='TXF', maximum_rows=1000000)[source]#

Select one explicit settlement revision, retaining source kWh alongside MWh.

This dataset is hourly actual generation at generation boundaries. It is distinct from E17D25, which contains daily estimated SCADA and schedules. timestamp converts the source FechaHora label from Colombia UTC-05; the label is not shifted. No revision is substituted for the selected one.

Parameters:
  • payload (JSONValue)

  • version (str)

  • maximum_rows (int)

Return type:

DataFrame

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

Bases: object

Public credential-free SIMEM GET requests, bounded to one civil day each.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

http: HTTPClient#
maximum_requests: int#
maximum_rows: int#
generation(start, end, *, version='TXF', resource_ids=None)[source]#

Retrieve inclusive Colombia dates and one caller-visible settlement revision.

Parameters:
  • start (date)

  • end (date)

  • version (str)

  • resource_ids (list[str] | None)

Return type:

GenerationResult