energy_data_retrieval.sources.cen.client#

CEN generation is reported by operating unit; aggregation requires a roster.

class energy_data_retrieval.sources.cen.client.GenerationDay(day: 'date', units: 'pd.DataFrame', exclusions: 'pd.DataFrame', requests: 'tuple[RequestRecord, ...]')[source]#

Bases: object

Parameters:
  • day (date)

  • units (DataFrame)

  • exclusions (DataFrame)

  • requests (tuple[RequestRecord, ...])

day: date#
units: DataFrame#
exclusions: DataFrame#
requests: tuple[RequestRecord, ...]#
class energy_data_retrieval.sources.cen.client.CENClient(http: 'HTTPClient', user_key: 'str' = '', page_size: 'int' = 5000, maximum_pages: 'int' = 200)[source]#

Bases: object

Parameters:
  • http (HTTPClient)

  • user_key (str)

  • page_size (int)

  • maximum_pages (int)

http: HTTPClient#
user_key: str#
page_size: int#
maximum_pages: int#
classmethod from_environment(http)[source]#
Parameters:

http (HTTPClient)

Return type:

CENClient

registry()[source]#
Return type:

tuple[DataFrame, RequestRecord]

generation_day(day, *, technology='Solar')[source]#

Retrieve every advertised page for one civil day, validating a stable envelope.

An API’s pagination can change during a live query. This adapter fails on any envelope change instead of claiming an atomic or complete snapshot. Requests are sequential and are bounded independently of the date range.

Parameters:
  • day (date)

  • technology (str)

Return type:

GenerationDay

iter_generation_days(start, end, *, technology='Solar')[source]#
Parameters:
  • start (date)

  • end (date)

  • technology (str)

Return type:

Iterator[GenerationDay]

energy_data_retrieval.sources.cen.client.normalize_generation(rows, *, source_timezone='America/Santiago')[source]#

Normalize unit rows; quarantine missing identities and nonexistent DST labels.

Source gen_real_mw is interpreted as mean MW for one real hourly interval, so actual_mwh = gen_real_mw * 1 hour. NaN remains missing and zero remains reported zero. Negative source observations are retained for downstream QA. No site or unit is guessed from a name. Conflicting duplicates fail loudly.

Parameters:
  • rows (Sequence[JSONValue])

  • source_timezone (str)

Return type:

tuple[DataFrame, DataFrame]

energy_data_retrieval.sources.cen.client.aggregate_units(units, expected_units)[source]#

Aggregate using an externally verified roster valid for this time period.

Every expected unit must report a non-null observation. Partial totals are retained as reported_mwh while actual_mwh is null for incomplete hours. Unexpected units are rejected, rather than expanding a roster after the fact.

Parameters:
  • units (DataFrame)

  • expected_units (Mapping[str, frozenset[str]])

Return type:

DataFrame

energy_data_retrieval.sources.cen.client.normalize_registry(rows)[source]#

Normalize registry identity and coordinates without inventing DC capacity.

Parameters:

rows (Sequence[JSONValue])

Return type:

DataFrame