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:
- 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:
- 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_mwis interpreted as mean MW for one real hourly interval, soactual_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_mwhwhileactual_mwhis 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