Skip to main content

Module conformal_frame_guard

Module conformal_frame_guard 

Source
Expand description

Conformal frame guard: coverage-guaranteed prediction intervals for frame timing.

Wraps ConformalPredictor with a frame-time time series, nonconformity score tracking, and p99 prediction intervals. When the predicted p99 exceeds the frame budget, degradation is triggered.

Fallback: before calibration reaches min_samples, a fixed 16 ms budget threshold is used (no conformal interval).

§Integration

The guard sits between frame measurement and [BudgetController]:

frame_time ──► ConformalFrameGuard ──► P99Prediction
                       │                      │
                       ▼                      ▼
                  observe()              exceeds_budget?
                  (calibrate)           → trigger degrade

Structs§

ConformalFrameGuard
Conformal frame guard: wraps ConformalPredictor with p99 intervals.
ConformalFrameGuardConfig
Configuration for the conformal frame guard.
ConformalFrameGuardTelemetry
Telemetry snapshot of the conformal frame guard.
NonconformitySummary
Summary statistics for nonconformity score distribution.
P99Prediction
Result of a p99 prediction from the guard.

Enums§

GuardState
State of the conformal frame guard.