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:
records (tuple[DailyScheduleRecord, ...])
start (date)
end (date)
- Return type: