energy_data_retrieval.sources.cen.daily_report#

Public CEN daily PDF reports: reported PV generation and availability notices.

This is a source-specific daily product, not the authenticated hourly API. No schedule shortfall is interpreted as a technical loss or fault attribution.

class energy_data_retrieval.sources.cen.daily_report.GenerationRow(plant_name: 'str', scheduled_mwh: 'float', actual_mwh: 'float', reported_deviation_percent: 'float | None', status_codes: 'str', source_page: 'int')[source]#

Bases: object

Parameters:
  • plant_name (str)

  • scheduled_mwh (float)

  • actual_mwh (float)

  • reported_deviation_percent (float | None)

  • status_codes (str)

  • source_page (int)

plant_name: str#
scheduled_mwh: float#
actual_mwh: float#
reported_deviation_percent: float | None#
status_codes: str#
source_page: int#
class energy_data_retrieval.sources.cen.daily_report.AvailabilityNotice(plant_name: 'str', category: 'str', reported_availability_percent: 'float', notice_ids: 'tuple[str, ...]', source_page: 'int')[source]#

Bases: object

Parameters:
  • plant_name (str)

  • category (str)

  • reported_availability_percent (float)

  • notice_ids (tuple[str, ...])

  • source_page (int)

plant_name: str#
category: str#
reported_availability_percent: float#
notice_ids: tuple[str, ...]#
source_page: int#
energy_data_retrieval.sources.cen.daily_report.discover_reports(html)[source]#

Use observed public links, including revised filenames; never invent URLs.

Parameters:

html (str)

Return type:

dict[date, str]

energy_data_retrieval.sources.cen.daily_report.parse_report_pages(pages, expected_day)[source]#

Parse the tested CEN column-text layout, failing on malformed PFV rows.

Selection is exact source labels starting with PFV followed by a space in section 1.1, excluding PMGD, PMG-prefixed rows, BESS and CSP. Names stay source identities, not a verified mapping to the separate InfoTécnica registry.

Parameters:
  • pages (list[str])

  • expected_day (date)

Return type:

tuple[tuple[GenerationRow, …], tuple[AvailabilityNotice, …]]

energy_data_retrieval.sources.cen.daily_report.parse_report(path, expected_day)[source]#

Retain source hash and page references; pypdf is an optional dependency.

Parameters:
  • path (Path)

  • expected_day (date)

Return type:

dict

energy_data_retrieval.sources.cen.daily_report.retrieve_reports(start, end, output, http)[source]#

Retrieve a bounded public window, preserving exact PDFs and HTTP manifests.

Parameters:
  • start (date)

  • end (date)

  • output (Path)

  • http (HTTPClient)

Return type:

dict

energy_data_retrieval.sources.cen.daily_report.main()[source]#
Return type:

None