Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

scientific use case section #754

Merged
merged 13 commits into from
May 15, 2024
36 changes: 25 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -68,13 +68,14 @@ After studying the vast XAI landscape we have made choices in the parts of the [

The key points of DIANNA:

* Provides an easy-to-use interface for non (X)AI experts
* Implements well-known XAI methods (LIME, RISE and Kernal SHAP) chosen by systematic and objective evaluation criteria
* Supports the de-facto standard format for neural network models - ONNX.
* Includes clear instructions for export/conversions from Tensorflow, Pytorch, Keras and scikit-learn to ONNX.
* Supports images, text and time series data modalities. Tabular data and even embeddings support is planned.
* Comes with simple intuitive image and text benchmarks
* Easily extendable to other XAI methods
* Provides an easy-to-use interface for non (X)AI experts
* Implements well-known XAI methods (LIME, RISE and Kernal SHAP) chosen by systematic and objective evaluation criteria
elboyran marked this conversation as resolved.
Show resolved Hide resolved
* Supports the de-facto standard of neural network models - ONNX
* Supports images, text, time series, and tabular data modalities, embeddings are currently being developed
* Comes with simple intuitive image, text, time series, and tabular benchmarks, so can help you with your XAI research
* Scientific use-cases tutorials
elboyran marked this conversation as resolved.
Show resolved Hide resolved
* Easily extendable to other XAI methods


For more information on the unique strengths of DIANNA with comparison to other tools, please see the [context landscape](https://dianna.readthedocs.io/en/latest/CONTEXT.html).

Expand Down Expand Up @@ -320,10 +321,23 @@ DIANNA supports different data modalities and XAI methods (explainers). We have
| Text | ✅ | ✅ | |
| Timeseries | ✅ | ✅ | |
| Tabular | planned | ✅ | ✅ |
| Embedding | planned | planned | planned
| Graphs* | work in progress | work in progress | work in progress |

[LRP](https://journals.plos.org/plosone/article/file?id=10.1371/journal.pone.0130140&type=printable) and [PatternAttribution](https://arxiv.org/pdf/1705.05598.pdf) also feature in the top 5 of our thoroughly evaluated explainers. **Contributing by adding these and more (new) post-hoc explainability methods on ONNX models is very welcome!**
| Embedding | work in progress | |
| Graphs* | next steps | ... | ... |

[LRP](https://journals.plos.org/plosone/article/file?id=10.1371/journal.pone.0130140&type=printable) and [PatternAttribution](https://arxiv.org/pdf/1705.05598.pdf) also feature in the top 5 of our thoroughly evaluated explainers.
Also [GradCAM](https://openaccess.thecvf.com/content_ICCV_2017/papers/Selvaraju_Grad-CAM_Visual_Explanations_ICCV_2017_paper.pdf)) has been recently found to be *semantically continous*! **Contributing by adding these and more (new) post-hoc explainability methods on ONNX models is very welcome!**


### Scientific use-cases
Our goal is that the scientific community embrases XAI as a source for novel and unexplored perspectives on scientific problems.
Here, we offer [tutorials](./tutorials) on specific scientific use-cases of uisng XAI:
| Use-case (data) \ XAI | [RISE](http://bmvc2018.org/contents/papers/1064.pdf) | [LIME](https://www.kdd.org/kdd2016/papers/files/rfp0573-ribeiroA.pdf) | [KernelSHAP](https://proceedings.neurips.cc/paper/2017/file/8a20a8621978632d76c43dfd28b67767-Paper.pdf) |
| :--------- | :-------- | :------------------------------ | :-------------------------- |
| Biology (Phytomorphology): Tree Leaves classification (images) | | ✅ | |
| Astronomy: Fast Radio Burst detection (timeseries) | ✅ | | |
| Geo-science (images) | planned | ... | ... | ... |
elboyran marked this conversation as resolved.
Show resolved Hide resolved
| Social sciences (text) | work in progress | ... |... | ... |
| Climate | planned | ... | ... | ... |

## Reference documentation

Expand Down
Loading
Loading