Skip to main content

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 ✓ shap.TreeExplainer ✓ shap.DeepExplainer N/A
Integrated Gradients N/A

Getting Started with DisCERN

Binary Classification example on the Adult Income dataset using RandomForest and Keras Deep Neural Net classifiers are here

Multi-class Classification example on the Cancer risk dataset using RandomForest and Keras Deep Neural Net classifiers are here

Citing

Please cite it follows:

  1. 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.

  2. 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:

@misc{wiratunga2021discerndiscovering,
  title={DisCERN:Discovering Counterfactual Explanations using Relevance Features from Neighbourhoods}, 
  author={Nirmalie Wiratunga and Anjana Wijekoon and Ikechukwu Nkisi-Orji and Kyle Martin and Chamath Palihawadana and David Corsar},
  year={2021},
  eprint={2109.05800},
  archivePrefix={arXiv},
  primaryClass={cs.LG}

}

@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}
}




drawing drawing


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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

discern-xai-0.0.27.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

discern_xai-0.0.27-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file discern-xai-0.0.27.tar.gz.

File metadata

  • Download URL: discern-xai-0.0.27.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.6

File hashes

Hashes for discern-xai-0.0.27.tar.gz
Algorithm Hash digest
SHA256 693670d9bfd1a51edbe3ae3d0026576b79f5aec21664d9c1499810af07fb4da4
MD5 8b878cc0bcf737d869d1af18055a1e4a
BLAKE2b-256 0f32b0c0c3fb028a4971ebd30a8b99beec85a2311278e3cb0671a46e4335c374

See more details on using hashes here.

File details

Details for the file discern_xai-0.0.27-py3-none-any.whl.

File metadata

  • Download URL: discern_xai-0.0.27-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.6

File hashes

Hashes for discern_xai-0.0.27-py3-none-any.whl
Algorithm Hash digest
SHA256 bac8840fada1f46887e359567a733cc3078dcfb9bf35839531f1ce1d96084ba7
MD5 b3ede43fbd7fa79c8f29e7f89f039d24
BLAKE2b-256 07d01af3c3575b4eda520922be44906a6725d9ec28e9ec5e5175e3b4c7524001

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page