Metadata-Version: 2.4
Name: khalib
Version: 0.2
Summary: Classifier Calibration with Khiops
Author-email: Felipe Olmos <luisfelipe.olmosmarchant@orange.com>
License-Expression: BSD-3-Clause
Project-URL: homepage, https://khiopslab.github.io/khalib
Project-URL: source, https://github.com/KhiopsLab/khalib
Project-URL: tracker, https://github.com/KhiopsLab/khalib/issues
Project-URL: changelog, https://github.com/KhiopsLab/khalib/blob/main/CHANGELOG.md
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development
Classifier: Topic :: Scientific/Engineering
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: khiops>=11.0.0.0
Requires-Dist: numpy>=2.0.0
Requires-Dist: scikit-learn>=1.5.0
Requires-Dist: matplotlib>=3.9.0
Dynamic: license-file

<!-- start-summary -->
# khalib
`khalib` is a classifier probability calibration package powered by the [Khiops][khiops-org] AutoML
suite.


## Features
- `KhalibClassifier`: A scikit-learn estimator to calibrate classifiers with a similar interface
  as [CalibratedClassifierCV][sk-calclf].
- `calibration_error` : A function to estimate the Estimated Calibration Error (ECE).
- `build_reliability_diagram` : A function to build a reliability diagram.

These features are based on Khiops's non-parametric supervised histograms, so there is no need to
specify the number and width of the bins, as they are automatically estimated from data.

[khiops-org]: https://khiops.org
[sk-calclf]: https://scikit-learn.org/stable/modules/generated/sklearn.calibration.CalibratedClassifierCV.html

<!-- end-summary -->

See the [documentation][khalib-docs] for more information.

<!-- start-install -->
## Installation

- [Install Khiops][khiops-setup]
- Install the `khalib` python library:

```sh
pip install khalib
```
[khiops-setup]: https://khiops.org/setup/

<!-- end-install -->


## Documentation

See https://khiopslab.github.io/khalib/


[khalib-docs]: https://khiopslab.github.io/khalib
