Forecast contracts and naive models
Use forecast contracts and naive models to move the forecasting production brief toward a defensible release.
Regional demand shifts through promotions, holidays, and drift.
This lesson isolates forecast contracts and naive models as one decision inside that system. The people affected are product users and operators; the learning data must carry event time, availability time, ownership, and version; and the operating envelope is available before staffing decisions.
Choose whether and how to use forecast origin at a declared prediction cutoff.
Measure decision utility alongside calibration, slice reliability, and system latency—not model score alone.
Regional demand shifts through promotions, holidays, and drift. An unsafe release must degrade to a named baseline or the last known-good version.
Build the mental model before the machinery.
The core move is to treat forecast contracts and naive models as a contract between data, a computation, and an action. Monitor horizon-level error, bias, interval coverage, freshness, reconciliation, and a seasonal-naive fallback. The implementation becomes easier to debug once you can state which inputs exist, which state is learned, what output means, and what must remain invariant after serialization.
forecast origin
Define it in a hand-checkable form and name the prediction-time inputs.
seasonal naive
Connect it to the production metric and identify what it cannot guarantee.
lag features
Stress it with a slice, a temporal boundary, and a failure-safe alternative.
rolling backtests
Stress it with a slice, a temporal boundary, and a failure-safe alternative.
Evaluation, Data & features, Trees & boosting
Name every symbol. Check every shape.
Quantile forecast objective is the central invariant for this lesson. The formula is useful only when its inputs match the production cutoff and its output maps to an action.
Quantile forecast objective
| Symbol | Meaning / shape / unit |
|---|---|
τ | target quantile |
q̂_τ | predicted quantile |
y | observed value |
Open derivation and numerical substitution
Start from the production quantity being optimized, substitute the observed values with their declared units, then isolate the model-controlled term. Preserve shape annotations at each step so broadcasting or aggregation cannot silently change the result.
- Write the named inputs: τ, q̂_τ, y.
- Substitute one small, hand-checkable batch before vectorizing.
- Calculate an independent reference value and compare within a declared tolerance.
# equation → code contract
inputs = validate_shapes_and_units(batch)
value = compute_c07(inputs)
assert is_finite(value)Calculate it small. Shape it realistically. Break it on purpose.
A result you can reproduce on paper
Predict next Monday from the previous Monday, then fit p10, p50, and p90 demand.
- Write every input and unit.
- Substitute values into the quantile forecast objective equation above.
- Compare the result to one simple baseline and explain the direction of the difference.
The same reasoning under real constraints
Forecast hourly regional orders 1–24 hours ahead for staffing and courier incentives.
The production record includes the data snapshot, transformation state, artifact identity, cutoff, score, decision, and the version of the policy that consumed it.
The attractive result you should reject
Training uses realized future weather and random folds, producing a forecast impossible to reproduce at origin time.
Diagnostic: replay the smallest failing slice from immutable inputs, then compare each boundary rather than retuning the model.
Change one assumption and make the tradeoff visible.
This lab runs predefined TypeScript only. It never executes learner code. Use the slider, numeric input, reset, live text, or table—the computation is the same.
Rolling-window backtest
Change history length and inspect bias, error, and interval coverage.
Assumption: Seasonal demand with one simulated regime change at week 30.
Open nonvisual data table
| Item | Computed state | Interpretation |
|---|---|---|
| h+1 | 12.5 MAE | 87.8% |
| h+6 | 13.6 MAE | 86.7% |
| h+12 | 15.0 MAE | 85.4% |
| h+18 | 16.3 MAE | 84.0% |
| h+24 | 17.6 MAE | 82.7% |
Trace the complete operating path.
- 01
Validate and version forecast origin.
- 02
Compute forecast contracts and naive models from prediction-time-safe inputs.
- 03
Persist model, feature, and configuration identities together.
- 04
Serve or materialize behind explicit available before staffing decisions.
- 05
Join telemetry to mature outcomes and retain a rollback path.
Observability
Join service health, input quality, prediction distributions, slice behavior, and mature outcomes by exact version.
Cost
Measure storage, preprocessing, compute, queueing, and human review under a representative arrival pattern.
Failure modes
Training uses realized future weather and random folds, producing a forecast impossible to reproduce at origin time. Add a detector, owner, mitigation, and stop condition for this class of failure.
Alternatives
Compare a rule, a simpler statistical baseline, and a different system boundary before adding model complexity.
Explain the contract, not just the vocabulary.
Regional demand forecast
Build a 24-hour pipeline with naive, statistical, and boosted baselines plus interval forecasts.
- Forecast contract
- Rolling-origin evaluation
- Horizon and coverage report
- Drift/retrain/fallback policy
Read primary material with a purpose.
Forecasting: Principles and Practice
90 min · last checked 26 Aug 2026
↗RECOMMENDED · Official docsscikit-learn lagged forecasting example
25 min · last checked 26 Aug 2026
↗DEEP DIVE · INDEXFind a primary implementation or benchmark
30–90 min · verify task, dataset, and evaluation match
↗Return to the opening failure.
Monitor horizon-level error, bias, interval coverage, freshness, reconciliation, and a seasonal-naive fallback.
For this lesson, the release evidence is a hand-checked formal result, deterministic simulation output, a ≥80% checkpoint, the production rubric, and a named fallback. The course resolves when the system can produce rolling validation, statistical baselines, boosted forecasts, and uncertainty bands.