Metadata-Version: 2.1
Name: calibrated-explanations
Version: 0.0.2
Summary: Extract calibrated explanations from machine learning models.
Author-email: Helena Löfström <helena.lofstrom@ju.se>
Project-URL: Homepage, https://github.com/Moffran/calibrated_explanations
Project-URL: Bug Tracker, https://github.com/Moffran/calibrated_explanations/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: scikit-learn
Requires-Dist: matplotlib
Requires-Dist: lime
Requires-Dist: shap
Requires-Dist: crepes
Requires-Dist: typing
Requires-Dist: tqdm
Requires-Dist: random
Requires-Dist: copy

Calibrated Explanations
=======================

[![Build Status for Calibrated Explanations][build-status]][build-log]

Calibrated Explanations is a Python library
that is able to explain predictions of a black-box model
using Venn Abers predictors (classification)
or conformal predictive systems (regression) and perturbations.

Install
-------

First, you need a Python environment installed with pip.

Calibrated Explanations can be installed from PyPI:

	pip install calibrated-explanations

The dependencies are:

* [crepes](https://github.com/henrikbostrom/crepes)
* [lime](https://github.com/marcotcr/lime)
* [matplotlib](https://matplotlib.org/)
* [NumPy](https://numpy.org/)
* [pandas](https://pandas.pydata.org/)
* [scikit-learn](https://scikit-learn.org/)
* [SHAP](https://pypi.org/project/shap/)
* [tqdm](https://tqdm.github.io/)


Getting started
---------------

```python
>>> import calibrated_explanations
... TODO: write me...
```


Development
-----------

This project has tests that can be executed using `pytest`.
Just run the following command from the project root.

```bash
pytest
```


Further reading
---------------

The calibrated explanations library is based on the paper
"Calibrated Explanations for Black-Box Predictions"
by
Helena Löfström,
[Tuwe Löfström](https://github.com/tuvelofstrom),
Ulf Johansson and
Cecilia Sönströd.

If you would like to cite this work, please cite the above paper.

[build-log]:    https://github.com/Moffran/calibrated_explanations/actions/workflows/ce.yml
[build-status]: https://github.com/Moffran/calibrated_explanations/actions/workflows/ce.yml/badge.svg
