energy_data_retrieval.sources.cen.curtailment#
Explicit CEN curtailment/generation/price CSV contracts; no guessed endpoints.
Source products: CEN ERNC reduction reports, SEN generation and preliminary real marginal costs, as identified in Acosta et al., DOI 10.1016/j.est.2026.125203. Downloads require a user-supplied observed public CSV URL. Excel/Qlik exports must first be exported to long-form CSV with source labels and units preserved.
- class energy_data_retrieval.sources.cen.curtailment.CENHourlySchema(quantity, timestamp_column, entity_column, value_column, unit, timezone=None, timestamp_label='start', technology_column=None, technology_map=(), region_column=None, delimiter=',', decimal='.')[source]#
Bases:
objectMap an observed long-form export; no column names or time zones are guessed.
timezone=Nonerequires an explicit offset on every timestamp. Otherwise naive civil-clock labels use the declared zone and ambiguous/nonexistent DST labels fail. Only one-hour intervals are supported. End-labelled exports are shifted one real hour before local time-block classification.- Parameters:
quantity (Literal['curtailment', 'generation', 'marginal_cost'])
timestamp_column (str)
entity_column (str)
value_column (str)
unit (str)
timezone (str | None)
timestamp_label (Literal['start', 'end'])
technology_column (str | None)
technology_map (tuple[tuple[str, str], ...])
region_column (str | None)
delimiter (str)
decimal (str)
- quantity: Literal['curtailment', 'generation', 'marginal_cost']#
- timestamp_column: str#
- entity_column: str#
- value_column: str#
- unit: str#
- timezone: str | None = None#
- timestamp_label: Literal['start', 'end'] = 'start'#
- technology_column: str | None = None#
- technology_map: tuple[tuple[str, str], ...] = ()#
- region_column: str | None = None#
- delimiter: str = ','#
- decimal: str = '.'#
- class energy_data_retrieval.sources.cen.curtailment.CENHourlyExport(data: 'pd.DataFrame', provenance: 'dict[str, object]')[source]#
Bases:
object- Parameters:
data (DataFrame)
provenance (dict[str, object])
- data: DataFrame#
- provenance: dict[str, object]#
- energy_data_retrieval.sources.cen.curtailment.normalize_cen_hourly(frame, schema)[source]#
Reject missing values, duplicate entity-hours and unresolved DST timestamps.
All source rows must match the declared PV/wind mapping; mixed-technology files must be explicitly filtered upstream. No missing entity/hour is filled.
valueis MWh for energy and USD/MWh for prices. MW means hourly mean MW.- Parameters:
frame (DataFrame)
schema (CENHourlySchema)
- Return type:
DataFrame
- energy_data_retrieval.sources.cen.curtailment.import_cen_hourly_csv(path, schema, *, source_url)[source]#
Read a preserved CEN export with input hash and explicit source contract.
- Parameters:
path (Path)
schema (CENHourlySchema)
source_url (str)
- Return type:
- energy_data_retrieval.sources.cen.curtailment.fetch_cen_hourly_csv(http, url, schema)[source]#
Fetch an observed public CSV URL through the repository’s bounded transport.
- Parameters:
http (HTTPClient)
url (str)
schema (CENHourlySchema)
- Return type: