CHANGELOG.md¶
All notable changes to uncertainty_flow are documented in the root CHANGELOG.md.
This file is kept for historical reference. The canonical changelog is at the repository root.
[Unreleased]¶
Added¶
- Initial project scaffold and package structure
BaseUncertaintyModelabstract base classDistributionPredictioncore output object with.quantile(),.interval(),.mean(),.plot()ConformalRegressor— tabular conformal wrapper for any sklearn estimatorConformalForecaster— temporal-aware conformal wrapper with multivariate supportQuantileForestForecaster— quantile regression forest with leaf distribution storageDeepQuantileNet— multi-quantile MLP with shared trunk (sklearn backend)DeepQuantileNetTorch— PyTorch-backed multi-quantile network with GPU and monotonicity loss (optional)TransformerForecaster— Chronos-2 pretrained forecasting wrapper (optional)- Polars I/O layer with LazyFrame support (
utils/polars_bridge.py) - Holdout and cross-conformal calibration split strategies
- Residual correlation analysis for uncertainty driver detection (
uncertainty_drivers_) - Gaussian, Clayton, Gumbel, Frank copula families with auto-selection
- Calibration report (Polars DataFrame) with pinball loss, Winkler score, coverage
- Warning system with
UF-W/UF-Ecodes - Standalone metrics:
pinball_loss,winkler_score,coverage_score - Shared model persistence via
.save()/.load()with.ufarchives and portable metadata BayesianQuantileRegressor— NumPyro MCMC with horseshoe priors (optional)CausalUncertaintyEstimator— doubly-robust, S-learner, T-learner treatment effect estimationCrossModalAggregator— per-feature-group models with product/copula/independent aggregationConformalRiskControl— conformal calibration for user-defined risk functions- Built-in risk functions:
asymmetric_loss,threshold_penalty,inventory_cost,financial_var UncertaintyExplainer— counterfactual explanations for interval width reductionEnsembleDecomposition— bootstrap-based aleatoric/epistemic uncertainty decompositionFeatureLeverageAnalyzer— per-feature uncertainty attribution with aleatoric/epistemic scoreslaunch_dashboard()— interactive Streamlit calibration dashboard (optional)- CLI benchmarking with 108+ HuggingFace datasets, auto-tuning, and structured output
auto_tuneparameter on supported models for automatic hyperparameter search
Release Notes Template¶
## [X.Y.Z] — YYYY-MM-DD
### Added
- New features
### Changed
- Changes to existing functionality (non-breaking)
### Deprecated
- Features that will be removed in a future version
### Removed
- Features removed in this release
### Fixed
- Bug fixes
### Security
- Security-relevant changes