Skip to main content

A flexible and generic framework for explainable landscape analysis (XLA).

Project description

pyXla

Documentation: https://pyxla.readthedocs.io


Overview

pyXla (Python package for eXplainable landscape analysis) is a flexible and generic framework for explainable landscape analysis (XLA).

Explainability is achieved by incorporating landscape analysis (LA) features that are meant for intuitive interpretation, and accompanied by visualisations alongside metrics whenever possible. Flexibility and generality are achieved by separating sampling from the actual analysis such that all the techniques implemented operate on a unified input format. As a result, the proposed framework can produce results even with a minimum of input components.

The focus of other landscape analysis branches such as exploratory landscape analysis (ELA), has leaned more towards automated problem analysis, where low-level features are used to train machine learning models to distinguish between problems for the purpose of automated algorithm selection.

The use of machine learning techniques for analysis of uninterpretable low-level features entails a loss of explainability, where focus has shifted from intuitively understanding the nature of optimisation problems and associated algorithmic performance to reliance on black-box problem characterisation and algorithm selection. Explainability is a key aim of LA, and a desirable property, more so in the context of explainable artificial intelligence (xAI). ELA's dependence on machine learning pipelines in LA limits its explainability.

In pyXla, inputs are either provided in designated files or by specifying functions to generate the inputs. The inputs are: F for objective values, X for solutions, V for violation values, D for pairwise distances between solutions, N for neighbourhood relationships between solutions, and I for any other additional input. Additionally, the following sampling algorithms for continuous problems are implemented: random walk sampling, adaptive walk sampling, and Hilbert curve sampling.

A total of 16 explainable landscape analysis features grouped into 4 categories are implemented comprising:

  • the statistical features: distribution of objective values (distr_F), distribution of violation values (distr_V), correlation of values (corr), correlation of ranks (corr_ranks), and variable importance (X_imp);

  • the ranking-based features: distribution of Pareto ranks (distr_Par) and distribution of Deb's ranks (distr_Deb);

  • the distance-based features: fitness distance correlation (FDC), violation distance correlation (VDC), rank distance correlation (RDC), pairwise distance correlation (PDC), and dispersion of the best solutions (disp_best); and

  • the neighbourhood features: neighbouring solutions' objective values correlation (NFC), neighbouring solutions' violation value of correlation (NVC), neighbouring solutions' ranks correlation (NRC), and neighbouring change in feasibility (NCF).

The pyXla framework conveniently composes the 16 landscape analysis features and three sampling algorithms, thus simplifying explainable landscape analysis. The figure below is a high-level diagram of the framework:

A high-level diagram of the pyXla framework.

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

pyxla-0.0.81.tar.gz (81.0 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyxla-0.0.81-py3-none-any.whl (31.2 kB view details)

Uploaded Python 3

File details

Details for the file pyxla-0.0.81.tar.gz.

File metadata

  • Download URL: pyxla-0.0.81.tar.gz
  • Upload date:
  • Size: 81.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Hatch/1.16.3 cpython/3.12.3 HTTPX/0.28.1

File hashes

Hashes for pyxla-0.0.81.tar.gz
Algorithm Hash digest
SHA256 2f99aa78a1b2bd14989e89798e0ad91ee8b8d3742954c11ece2330be9bcf61fd
MD5 4a526e4e3bebf2a82c2a1ccb0193442d
BLAKE2b-256 c2398546297143e9b8fd35ddf6940ee2352d8de1a362cb50be3f7eef3f229752

See more details on using hashes here.

File details

Details for the file pyxla-0.0.81-py3-none-any.whl.

File metadata

  • Download URL: pyxla-0.0.81-py3-none-any.whl
  • Upload date:
  • Size: 31.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: Hatch/1.16.3 cpython/3.12.3 HTTPX/0.28.1

File hashes

Hashes for pyxla-0.0.81-py3-none-any.whl
Algorithm Hash digest
SHA256 c9e091850d73ca09eba0f2c674016a2329f86d05dcb4244aebe002f126cc58e8
MD5 a0047afbb9cf2729d44a1c1fa5bfacbf
BLAKE2b-256 535c065b0c5249f49956858c56204bbae7aac6631a7714b4b24d016cf4df5e33

See more details on using hashes here.

Supported by

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