Skip to content
This repository was archived by the owner on Sep 17, 2025. It is now read-only.

Commit 2422afd

Browse files
EOL notice (#83)
* eol Signed-off-by: Barabanov <[email protected]> * eol Signed-off-by: Barabanov <[email protected]> --------- Signed-off-by: Barabanov <[email protected]>
1 parent 36a5429 commit 2422afd

File tree

1 file changed

+47
-35
lines changed

1 file changed

+47
-35
lines changed

README.md

Lines changed: 47 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,13 @@
1+
# PROJECT NOT UNDER ACTIVE MANAGEMENT
2+
3+
This project will no longer be maintained by Intel.
4+
Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.
5+
Intel no longer accepts patches to this project.
6+
If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the open source software community, please create your own fork of this project.
7+
18
<div align="center">
29

3-
# OpenVINO™ Explainable AI Toolkit - OpenVINO XAI
10+
## OpenVINO™ Explainable AI Toolkit - OpenVINO XAI
411

512
---
613

@@ -53,30 +60,30 @@ for i, image in enumerate(images):
5360

5461
### What's new in v1.1.0
5562

56-
* Support PyTorch models with `insert_xai()` API for saliency map generation on PyTorch / ONNX runtime
57-
* Support OpenVINO IR (.xml) / ONNX (.onnx) model files for `Explainer`
58-
* Enable AISE method: Adaptive Input Sampling for Explanation of Black-box Models
59-
* Add Pointing Game, Insertion-Deletion AUC and ADCC quality metrics for saliency maps
60-
* Upgrade OpenVINO to 2024.4.0
61-
* Add saliency map visualization with explanation.plot()
62-
* Enable flexible naming for saved saliency maps and include confidence scores
63+
- Support PyTorch models with `insert_xai()` API for saliency map generation on PyTorch / ONNX runtime
64+
- Support OpenVINO IR (.xml) / ONNX (.onnx) model files for `Explainer`
65+
- Enable AISE method: Adaptive Input Sampling for Explanation of Black-box Models
66+
- Add Pointing Game, Insertion-Deletion AUC and ADCC quality metrics for saliency maps
67+
- Upgrade OpenVINO to 2024.4.0
68+
- Add saliency map visualization with explanation.plot()
69+
- Enable flexible naming for saved saliency maps and include confidence scores
6370

6471
Please refer to the [change logs](CHANGELOG.md) for the full release history.
6572

6673
### Supported XAI methods
6774

68-
At the moment, *Image Classification* and *Object Detection* tasks are supported for the *Computer Vision* domain.
69-
*Black-Box* (model agnostic but slow) methods and *White-Box* (model specific but fast) methods are supported:
75+
At the moment, _Image Classification_ and _Object Detection_ tasks are supported for the _Computer Vision_ domain.
76+
_Black-Box_ (model agnostic but slow) methods and _White-Box_ (model specific but fast) methods are supported:
7077

71-
| Domain | Task | Type | Algorithm | Links |
72-
|-----------------|----------------------|-----------|------------------------|-------|
78+
| Domain | Task | Type | Algorithm | Links |
79+
| --------------- | -------------------- | --------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
7380
| Computer Vision | Image Classification | White-Box | ReciproCAM | [paper](https://openaccess.thecvf.com/content/CVPR2024W/XAI4CV/papers/Byun_ReciproCAM_Lightweight_Gradient-free_Class_Activation_Map_for_Post-hoc_Explanations_CVPRW_2024_paper.pdf) / [src](openvino_xai/me4thods/white_box/recipro_cam.py) |
74-
| | | | VITReciproCAM | [paper](https://arxiv.org/abs/2310.02588) / [src](openvino_xai/methods/white_box/recipro_cam.py) |
75-
| | | | ActivationMap | experimental / [src](openvino_xai/methods/white_box/activation_map.py) |
76-
| | | Black-Box | AISEClassification | [src](openvino_xai/methods/black_box/aise/classification.py) |
77-
| | | | RISE | [paper](https://arxiv.org/abs/1806.07421v3) / [src](openvino_xai/methods/black_box/rise.py) |
78-
| | Object Detection | White-Box | DetClassProbabilityMap | experimental / [src](openvino_xai/methods/white_box/det_class_probability_map.py) |
79-
| | | Black-Box | AISEDetection | [src](openvino_xai/methods/black_box/aise/detection.py) |
81+
| | | | VITReciproCAM | [paper](https://arxiv.org/abs/2310.02588) / [src](openvino_xai/methods/white_box/recipro_cam.py) |
82+
| | | | ActivationMap | experimental / [src](openvino_xai/methods/white_box/activation_map.py) |
83+
| | | Black-Box | AISEClassification | [src](openvino_xai/methods/black_box/aise/classification.py) |
84+
| | | | RISE | [paper](https://arxiv.org/abs/1806.07421v3) / [src](openvino_xai/methods/black_box/rise.py) |
85+
| | Object Detection | White-Box | DetClassProbabilityMap | experimental / [src](openvino_xai/methods/white_box/det_class_probability_map.py) |
86+
| | | Black-Box | AISEDetection | [src](openvino_xai/methods/black_box/aise/detection.py) |
8087

8188
See more method comparison at the [User Guide](docs/source/user-guide.md).
8289

@@ -86,16 +93,16 @@ Most of CNNs and Transformer models from [Pytorch Image Models (timm)](https://g
8693

8794
Please refer to the following known issues for unsupported models and reasons.
8895

89-
* [Runtime error from ONNX / OpenVINO IR models while conversion or inference for XAI (#29)](https://github.com/openvinotoolkit/openvino_xai/issues/29)
90-
* [Models not supported by white box XAI methods (#30)](https://github.com/openvinotoolkit/openvino_xai/issues/30)
96+
- [Runtime error from ONNX / OpenVINO IR models while conversion or inference for XAI (#29)](https://github.com/openvinotoolkit/openvino_xai/issues/29)
97+
- [Models not supported by white box XAI methods (#30)](https://github.com/openvinotoolkit/openvino_xai/issues/30)
9198

92-
> **_NOTE:_** GenAI / LLMs would be also supported incrementally in the upcoming releases.
99+
> **_NOTE:_** GenAI / LLMs would be also supported incrementally in the upcoming releases.
93100
94101
---
95102

96103
## Installation
97104

98-
> **_NOTE:_** OpenVINO XAI works on Python 3.10 or higher
105+
> **_NOTE:_** OpenVINO XAI works on Python 3.10 or higher
99106
100107
<details>
101108
<summary>Set up environment</summary>
@@ -107,6 +114,7 @@ python3.10 -m venv .ovxai
107114
# Activate virtual env.
108115
source .ovxai/bin/activate
109116
```
117+
110118
</details>
111119

112120
Install from PyPI package
@@ -130,6 +138,7 @@ cd openvino_xai
130138
# Editable mode (for development):
131139
pip install -e .[dev]
132140
```
141+
133142
</details>
134143

135144
<details>
@@ -141,7 +150,9 @@ You can enjoy the PyTorch XAI feature if the PyTorch is installed along with the
141150
# Install PyTorch (CPU version as example)
142151
pip3 install torch --index-url https://download.pytorch.org/whl/cpu
143152
```
153+
144154
Please refer to the [PyTorch Installation Guide](https://pytorch.org/get-started/locally/) for other options.
155+
145156
</details>
146157

147158
<details>
@@ -154,6 +165,7 @@ pytest -v -s ./tests/unit
154165
# Run code quality checks
155166
pre-commit run --all-files
156167
```
168+
157169
</details>
158170

159171
---
@@ -199,9 +211,9 @@ explanation: xai.Explanation = explainer(
199211
explanation.save(dir_path="./output")
200212
```
201213

202-
Original image | Explained image
203-
---------------|----------------
204-
![Oringinal images](tests/assets/cheetah_person.jpg) | ![Explained image](docs/source/_static/xai-cheetah.png)
214+
| Original image | Explained image |
215+
| ---------------------------------------------------- | ------------------------------------------------------- |
216+
| ![Oringinal images](tests/assets/cheetah_person.jpg) | ![Explained image](docs/source/_static/xai-cheetah.png) |
205217

206218
We can see that model is focusing on the body or skin area of the animals to tell if this image contains actual cheetahs.
207219

@@ -231,20 +243,20 @@ with torch.no_grad():
231243

232244
Users could tweak the basic use-case according to their purpose, which include but not limited to:
233245

234-
* Select XAI mode (White-Box or Black-Box) or even specific method which are automatically decided by default
235-
* Provide custom model pre/post processing functions like resize and normalizations which the model expects
236-
* Customize output image visualization options
237-
* Explain multiple class targets, passing them as label indices or as actual label names
238-
* Call explainer multiple times to explain multiple images or to use different targets
239-
* Insert XAI head to your PyTorch models and export to ONNX format to generate saliency maps on ONNX Runtime
246+
- Select XAI mode (White-Box or Black-Box) or even specific method which are automatically decided by default
247+
- Provide custom model pre/post processing functions like resize and normalizations which the model expects
248+
- Customize output image visualization options
249+
- Explain multiple class targets, passing them as label indices or as actual label names
250+
- Call explainer multiple times to explain multiple images or to use different targets
251+
- Insert XAI head to your PyTorch models and export to ONNX format to generate saliency maps on ONNX Runtime
240252
(Refer to the [full example script](./examples/run_torch_onnx.py))
241253

242254
Please find more options and scenarios in the following links:
243255

244-
* [OpenVINO XAI User Guide](docs/source/user-guide.md)
245-
* [OpenVINO Notebook - XAI Basic](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-1-basic/explainable-ai-1-basic.ipynb)
246-
* [OpenVINO Notebook - XAI Deep Dive](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-2-deep-dive/explainable-ai-2-deep-dive.ipynb)
247-
* [OpenVINO Notebook - Saliency Map Interpretation](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-3-map-interpretation/explainable-ai-3-map-interpretation.ipynb)
256+
- [OpenVINO XAI User Guide](docs/source/user-guide.md)
257+
- [OpenVINO Notebook - XAI Basic](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-1-basic/explainable-ai-1-basic.ipynb)
258+
- [OpenVINO Notebook - XAI Deep Dive](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-2-deep-dive/explainable-ai-2-deep-dive.ipynb)
259+
- [OpenVINO Notebook - Saliency Map Interpretation](https://github.com/openvinotoolkit/openvino_notebooks/blob/latest/notebooks/explainable-ai-3-map-interpretation/explainable-ai-3-map-interpretation.ipynb)
248260

249261
### Playing with the examples
250262

0 commit comments

Comments
 (0)