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: object

Map an observed long-form export; no column names or time zones are guessed.

timezone=None requires 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. value is MWh for energy and USD/MWh for prices. MW means hourly mean MW.

Parameters:
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:
Return type:

CENHourlyExport

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:
Return type:

CENHourlyExport