energy_data_retrieval.sources.caiso.client#

CAISO Today’s Outlook fuel-source CSV: five-minute average power in MW.

Imports, net battery output and mixed Other supply are separate flows, never silently included in a generation total. These operational displays are not settlement-quality data. Native CSV clock labels omit UTC offsets; ambiguous/nonexistent DST labels are rejected rather than guessed, interpolated or shifted to another interval.

energy_data_retrieval.sources.caiso.client.parse_fuel_mix(text, *, day, maximum_rows=1000000)[source]#

Parse one source-calendar day’s native fuelsource.csv without gap filling.

timestamp is the published clock label converted to UTC, not an asserted interval-start or interval-end convention. Each source value is a five-minute average MW. Missing numeric cells stay missing; signed values stay signed. The CSV cannot disambiguate the repeated fall-back hour or represent a nonexistent spring-forward hour, so those labels fail explicitly.

Parameters:
  • text (str)

  • day (date)

  • maximum_rows (int)

Return type:

DataFrame

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

Bases: object

Bounded public daily CSV retrieval, with no API key.

Parameters:
  • http (HTTPClient)

  • maximum_requests (int)

  • maximum_rows (int)

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

Retrieve inclusive Pacific source dates; retain imports and net storage separately.

Parameters:
  • start (date)

  • end (date)

Return type:

GenerationResult