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
PFVfollowed 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