energy_methods.dispatch_review#

Daily dispatch schedule reconciliation; no technical-loss or monetary inference.

class energy_methods.dispatch_review.DailyScheduleRecord(day: 'str', scheduled_mwh: 'float | None', actual_mwh: 'float | None')[source]#

Bases: object

Parameters:
  • day (str)

  • scheduled_mwh (float | None)

  • actual_mwh (float | None)

day: str#
scheduled_mwh: float | None#
actual_mwh: float | None#
class energy_methods.dispatch_review.ScheduleReview(calendar_days: 'int', comparable_days: 'int', missing_dates: 'tuple[str, ...]', coverage_fraction: 'float', scheduled_mwh: 'float', actual_mwh: 'float', shortfall_mwh: 'float', above_schedule_mwh: 'float', net_deviation_mwh: 'float', net_deviation_percent: 'float | None', zero_actual_with_schedule_dates: 'tuple[str, ...]', revenue_impact: 'None' = None, recoverable_energy_mwh: 'None' = None)[source]#

Bases: object

Parameters:
  • calendar_days (int)

  • comparable_days (int)

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

  • coverage_fraction (float)

  • scheduled_mwh (float)

  • actual_mwh (float)

  • shortfall_mwh (float)

  • above_schedule_mwh (float)

  • net_deviation_mwh (float)

  • net_deviation_percent (float | None)

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

  • revenue_impact (None)

  • recoverable_energy_mwh (None)

calendar_days: int#
comparable_days: int#
missing_dates: tuple[str, ...]#
coverage_fraction: float#
scheduled_mwh: float#
actual_mwh: float#
shortfall_mwh: float#
above_schedule_mwh: float#
net_deviation_mwh: float#
net_deviation_percent: float | None#
zero_actual_with_schedule_dates: tuple[str, ...]#
revenue_impact: None = None#
recoverable_energy_mwh: None = None#
energy_methods.dispatch_review.review_dispatch_schedule(records, *, start, end)[source]#

Reconcile a declared date window, detecting edge and internal missing days.

Shortfall = sum(max(schedule - actual, 0)); excess is reported separately. Net deviation = actual - schedule. Neither quantity identifies resource, grid, forecasting or equipment causes. A zero schedule and zero actual can coexist with a severe known outage: absence of a shortfall is not health.

Parameters:
Return type:

ScheduleReview