Skip to main content

IREX

The IREX process follows an iterative process, where a set of candidate input variables are identified and proposed for its revision by the expert user. Finally, once anomalous variables are confirmed, they are used to modify the prediction model.

IREX Architecture

The IREX software was developed in Python 3, where XAI methods can be used by importing all the needed libraries. IREX is available in a Python script file that can be run in Spyder (recommended), Pycharm, or Jupyter notebooks.

  1. Model creation, training, and evaluation using the Scikit-learn library and the Pandas and Numpy packages.
  2. Anomalous item identification using the ALE algorithm provided by the Alibi framework
  3. Anomalous item explanation, through a novel visualization method based using heatmaps (Pyplot lib) and the LIME, SHAP, and Permutation Feature Importance XAI methods.
  4. Feedback collection and dataset+model refinement.

Funtionalities

The iterative process that the IREX software follows to refine a classification model can be resumed in five steps:

  1. The model is created, trained and evaluated. By default, Artificial Neural Network (ANN) models are employed as they usually achieve a higher performance than other ML methods. Evaluation is presented using standard performance metrics such as precision/recall tables and the confusion matrix.
  2. The ANN model is introspected with the Accumulated Local Effect (ALE) method to analyze the influence and impact of each item in the classification. In this step, IREX identifies those variables that may lead to a lower performance according to the behaviour expected by the expert user. From this analysis, input variables can be categorized as follows:
    • Irrelevant, when the impact of the item in the classification according to ALE is not significant and has a low influence on the final result.
    • Inconsistent, when the item has a behaviour opposite to what had been expected (e. g. when certain values are supposed to raise the score for a given class, but instead, the item reduces this possibility.). We refer to these variables as ``potentially anomalous items'' (PAIs).
  3. IREX provides a visualization of these findings through different heatmaps that explain the impact of each input variable using a color scale. This way, irrelevant items have a color close to white, whereas a darker color implies a higher impact on the classification. Variables following the expected behavior are represented in blue, while PAIs are presented in red. These heatmaps can (a) summarize the average impact of input variables for a given class, (b) compare the impact estimated by different XAI methods, and (c) provide an individualized analysis for each instance in the dataset.
  4. The expert user will confirm or discard the abnormal behavior of these variables through the analysis of these heatmaps, particularly those PAIs represented in red color-scale.
  5. The feedback provided by the expert user consisting of a list of confirmed anomalous items is used to remove the corresponding variables from the input dataset. With this, the ANN model can be retrained with the new data to start over with the first step. This process is repeated until the software finds no other PAIs in the dataset, generating a final chart describing the trade-off between removed PAIs and the model performance.

Metadata

Release files for IREX 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for IREX 1.0.0
File Size Uploaded Provenance Actions
IREX-1.0.0.tar.gz 9.7 kB Without provenance Details for IREX-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for IREX 1.0.0
File Interpreter ABI Platform Actions
IREX-1.0.0-py3-none-any.whl Python 3 none any Details for IREX-1.0.0-py3-none-any.whl

Total release size: 19.4 kB

Release files / IREX-1.0.0.tar.gz

Download URL IREX-1.0.0.tar.gz
Size 9.7 kB
Tags Source
SHA-256 checksum
How to use checksums
20d3160f0d19c1e50f281321f0b90de79ad839dcbd99bbbf81a468b358484934
BLAKE2b-256 checksum
How to use checksums
b7dc200645397e5699935d216a3148770925c3137d179f31ac935d163cdbadd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Release files / IREX-1.0.0-py3-none-any.whl

Download URL IREX-1.0.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
88ba158470112232db358447f73c724a65c4877c91be51fd9c7acd2aa8f3fa0e
BLAKE2b-256 checksum
How to use checksums
515ad8341129ec829e92e2ef689e8144d241e0745985460ef3b930c3b2514187
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.6

Security for IREX 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page