energy_analysis.chile_curtailment#

Reproduce published Chile curtailment tables and analyze explicit CEN exports.

Run python -m energy_analysis.chile_curtailment --output artifacts/chile-curtailment. Offline mode uses published aggregates from DOI 10.1016/j.est.2026.125203. An optional hourly configuration uses separately acquired CEN data, never a fabricated reconstruction of the authors’ unavailable hourly dataset.

energy_analysis.chile_curtailment.reproduce_published_tables()[source]#

Recompute Tables 2/3/7/8 with explicit rounding residuals and tolerances.

Uses 365 days even for 2024, matching the paper’s convention. This is an aggregate reproduction, not an independent raw-data replication.

Return type:

dict[str, DataFrame]

energy_analysis.chile_curtailment.analyze_hourly_exports(curtailment, *, expected_entities, prices=None, corridors=(), timezone='America/Santiago')[source]#

Observed-hour diagnostics with a caller-verified stable PV/wind plant roster.

Every observed hour must include all expected plants; otherwise fail rather than understate curtailment. Whole missing hours remain absent and are counted in coverage. Changing historical rosters require separate time slices. Price screens retain only paired corridor hours and expose excluded counts.

Parameters:
  • curtailment (CENHourlyExport)

  • expected_entities (dict[str, list[str]])

  • prices (CENHourlyExport | None)

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

  • timezone (str)

Return type:

dict[str, DataFrame]

energy_analysis.chile_curtailment.main()[source]#
Return type:

None