DisCERN: Discovering Counterfactual Explanations using Relevance Features from Neighbourhoods
Project description
DisCERN-XAI
DisCERN: Discovering Counterfactual Explanations using Relevance Features from Neighbourhoods
Installing DisCERN
DisCERN supports Python 3+. The stable version of DisCERN is available on PyPI:
pip install discern-xai
To install the dev version of DisCERN and its dependencies, clone this repo and run pip install
from the top-most folder of the repo:
pip install -e .
DisCERN requires the following packages:
numpy
pandas
lime
shap
scikit-learn
Compatible Libraries
Attribution Explainer | scikit-learn | TensorFlow/Keras | PyTorch |
---|---|---|---|
LIME | ✓ | ✓ | N/A |
SHAP | ✓ | ✓ | N/A |
Integrated Gradients | ✗ | ✓ | N/A |
Getting Started with DisCERN
An example of the Adult Income dataset using RandomForest and Keras Deep Neural Net classifiers are here
Citing
Please cite it follows:
-
Wiratunga, N., Wijekoon, A., Nkisi-Orji, I., Martin, K., Palihawadana, C., & Corsar, D. (2021, November). Discern: discovering counterfactual explanations using relevance features from neighbourhoods. In 2021 IEEE 33rd International Conference on Tools with Artificial Intelligence (ICTAI) (pp. 1466-1473). IEEE.
-
Wijekoon, A., Wiratunga, N., Nkisi-Orji, I., Palihawadana, C., Corsar, D., & Martin, K. (2022, August). How Close Is Too Close? The Role of Feature Attributions in Discovering Counterfactual Explanations. In Case-Based Reasoning Research and Development: 30th International Conference, ICCBR 2022, Nancy, France, September 12–15, 2022, Proceedings (pp. 33-47). Cham: Springer International Publishing.
Bibtex:
@inproceedings{wiratunga2021discern,
title={Discern: discovering counterfactual explanations using relevance features from neighbourhoods},
author={Wiratunga, Nirmalie and Wijekoon, Anjana and Nkisi-Orji, Ikechukwu and Martin, Kyle and Palihawadana, Chamath and Corsar, David},
booktitle={2021 IEEE 33rd International Conference on Tools with Artificial Intelligence (ICTAI)},
pages={1466--1473},
year={2021},
organization={IEEE}
}
@inproceedings{wijekoon2022close,
title={How Close Is Too Close? The Role of Feature Attributions in Discovering Counterfactual Explanations},
author={Wijekoon, Anjana and Wiratunga, Nirmalie and Nkisi-Orji, Ikechukwu and Palihawadana, Chamath and Corsar, David and Martin, Kyle},
booktitle={Case-Based Reasoning Research and Development: 30th International Conference, ICCBR 2022, Nancy, France, September 12--15, 2022, Proceedings},
pages={33--47},
year={2022},
organization={Springer}
}
This research is funded by the iSee project which received funding from EPSRC under the grant number EP/V061755/1. iSee is part of the CHIST-ERA pathfinder programme for European coordinated research on future and emerging information and communication technologies.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for discern_xai-0.0.26-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cfe3e89798d7b6e6c3abc06ae3bb2480e6a780d04cd0f091bd4b109f393bc38b |
|
MD5 | 1e04dc390e22d987e10823194c58333a |
|
BLAKE2b-256 | c0abda3eb42cdc070ec1983163afd84335291e8ba9295d890def99b25f020725 |