binwise 0.2.0

Enable classification models for regression tasks and provide uncertainty estimation

Binwise

Enable classification models for regression tasks and provide uncertainty estimation.

Introduction

Implementation of the binned uncertainty estimation ensemble method, as described in the paper "An Efficient Model-Agnostic Approach for Uncertainty Estimation in Data-Restricted Pedometric Applications" (Barkov et al., 2024).

Binwise serves as an adapter that allows you to apply classification algorithms to regression problems by discretizing the continuous target into bins. The approach not only enables the use of classification models for regression tasks but also can provide uncertainty estimates.

This approach is particularly useful in scenarios with limited training data, as demonstrated in applications like pedometrics and digital soil mapping.

Features

• Use classification algorithms with scikit-learn interface for regression tasks
• Obtain uncertainty estimates for regression predictions

Installation

pip install binwise

Quick Start

Simple example of how to use the binning adapter with TabPFN:

from tabpfn import TabPFNClassifier
from binwise import RegressionToClassificationEnsemble

tabpfn_ensemble = RegressionToClassificationEnsemble(
    base_model_constructor=lambda: TabPFNClassifier(N_ensemble_configurations=1),
    random_state=42,
)

tabpfn_ensemble.fit(X_train, y_train)
y_pred = tabpfn_ensemble.predict(X_test)

Examples

For more detailed examples, check out the following notebooks:

Regression Predictions: Using classification model (TabPFN) for regression task

Regression Predictions with Uncertainty Estimation: Obtaining uncertainty estimates along with predictions

Citation

If you use this code in your research, please cite:

@misc{barkov2024uncertainty,
      title={An Efficient Model-Agnostic Approach for Uncertainty Estimation in Data-Restricted Pedometric Applications}, 
      author={Viacheslav Barkov and Jonas Schmidinger and Robin Gebbers and Martin Atzmueller},
      year={2024},
      eprint={2409.11985},
      archivePrefix={arXiv},
      primaryClass={cs.LG},
      url={https://arxiv.org/abs/2409.11985}, 
}

License:

This project is licensed under the AGPLv3 License - see the LICENSE.md file for details.