Changelog¶
Formato basado en Keep a Changelog; versionado SemVer.
[1.0.0] - 2026-07-24¶
Primera versión estable. Consolida todo el desarrollo 0.1-0.7:
Núcleo¶
Arena: competencia de modelos con backtesting rolling-origin honesto (fpp3 cap. 5.10), leaderboard en escala original (MAE/RMSE/MAPE/sMAPE/MASE) y campeón que reentrena con toda la serie.- Luchadores: Naive, SNaive, Drift, Theta, STLF (STL+ETS), SARIMA/SARIMAX, ETS, híbrido STL+XGBoost, Harmonic (multi-estacional), Croston/SBA (demanda intermitente).
- API extensible: cualquier subclase de
BaseForecastercompite.
Detección automática¶
- Periodicidad por frecuencia del índice o periodograma+ACF (
season_length="auto"). - Transformación: detección de multiplicatividad y λ de Box-Cox por Guerrero (
transform="auto"), con reporte de qué se hizo y por qué. - Quiebres estructurales con PELT piecewise-lineal (nivel/tendencia), con reacciones
report/trim/dummy.
Exógenas¶
- Conocidas (
X_future), en cascada (forecast_X=True, cada una en su mini-arena) y mixtas; backtesting sin fuga de información. - Helpers de calendario: Fourier, días hábiles, Semana Santa móvil.
- Propagación de la incertidumbre de la cascada a los intervalos (método delta).
Incertidumbre y diagnóstico¶
- Intervalos de predicción por modelo (fórmulas fpp3, analíticos, bootstrap con residuales honestos), destransformación exacta de cuantiles y
bias_adjustopcional (cap. 5.6). - Auditoría de intervalos: cobertura empírica y Winkler score en backtesting (cap. 5.9).
- Diagnóstico de residuales del campeón: Ljung-Box + sesgo con veredicto legible (cap. 5.4).
Escala¶
- Pronóstico jerárquico con reconciliación bottom-up / top-down / OLS (cap. 11) y API batch (
compete_many). - Paralelización (
n_jobs), imputación de huecos con reconstrucción de malla temporal, guardas para series patológicas (constantes, m=365, escalas extremas).
Producción¶
result.save()/load(),random_statereproducible,result.plot()con bandas y quiebres marcados.