Skip to main content

Open source Python library for deriving explanations about business processes based on process,causal and XAI perspectives

Project description

SAX4BPM

SAX4BPM-banner

This is a designated Python library that aims to provide an easy and intuitive way of deriving explanations about business processes, considering multiple perspectives. Concretely, three major knowledge ingredients—a process model, a causal process model, and XAI attribute ranking—are derived and subsequently synthesized by an LLM for the construction of process and context-aware explanations, namely Situation-aware Explanations (SAX explanations). The repository contains the source code which can be cloned, or the library can be installed as a Python package using pip install sax4bpm.

🏁 Getting started: https://ibm.github.io/sax4bpm/installation.html

🛠️ Tutorials: https://ibm.github.io/sax4bpm/tutorials.html

📦 Python Package: https://pypi.org/project/sax4bpm/

Documentation

🗃️ The full documentation for this repository can be found at GitHub Pages.

Introduction

The library provides three layers of business process analysis- process mining, causal discovery, XAI analysis, and LLM-powered blending of the analysis outcomes into human-readable process explanations functionality.

We also provide a simple Streamlit UI for experimentation and discovery of the provided library functionalities.

The library allows importing process event logs in standard formats (MXML, XES, CSV) and invoking the discovery functionality of the desired layer.

Importing event log

For the process perspective, we utilize the open-source PM4PY library allowing the user to invoke process mining algorithms and create a process-model representation out of the process event logs.

Process discovery

We can explore the existing variants in the process model, and choose a particular variant for further analysis.

Process variants

After choosing the appropriate variant we can perform causal discovery to infer the causal dependency model for the particular variant and compare it with the process model to discover discrepancies.

Causal discovery

Finally, we can blend the discovery results using LLM-powered analysis of the different process knowledge layers, and receive answers to user queries based on this analysis.

Knowledge blend

Related Papers

Causal Business Processes

Leveraging LLMs to explain Business Processes

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

sax4bpm-0.2.2.tar.gz (738.1 kB view details)

Uploaded Source

Built Distribution

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

sax4bpm-0.2.2-py3-none-any.whl (76.3 kB view details)

Uploaded Python 3

File details

Details for the file sax4bpm-0.2.2.tar.gz.

File metadata

  • Download URL: sax4bpm-0.2.2.tar.gz
  • Upload date:
  • Size: 738.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for sax4bpm-0.2.2.tar.gz
Algorithm Hash digest
SHA256 d9b9ddf71250a3529b9eb685ff458a64bacaef0eab09a29ca2670a30e4dc872d
MD5 4015c6e9d8b51134ac45c51b02cf2a31
BLAKE2b-256 ce0cf196e2ed67e90907a661ca9076ef495594047ebda42ff4edd571311c4a34

See more details on using hashes here.

File details

Details for the file sax4bpm-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: sax4bpm-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 76.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for sax4bpm-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 611d5a4eb84b74f55ccdc445c6b2d61775a8a887364473244b91344f2bd45133
MD5 4ac14ae54a2a4f1662bb7fe8595cae3f
BLAKE2b-256 1bbfb17a70ea7e77805bb90abe51c790b0dc2ce361767fa91d1fe89daca74eac

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