Skip to main content

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

Causal Business Processes

Leveraging LLMs to explain Business Processes

Metadata

Release files for sax4bpm 0.3.1

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

Source distribution (sdist)

Source distribution for sax4bpm 0.3.1
File Size Uploaded Provenance Actions
sax4bpm-0.3.1.tar.gz 742.9 kB Without provenance Details for sax4bpm-0.3.1.tar.gz

Built distribution (wheel)

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

Total release size: 825.4 kB

Release files / sax4bpm-0.3.1.tar.gz

Download URL sax4bpm-0.3.1.tar.gz
Size 742.9 kB
Tags Source
SHA-256 checksum
How to use checksums
3c8e18da1d2cd18fc825e6d37631f5312e9d24629b0ec82df76f79d791b079ec
BLAKE2b-256 checksum
How to use checksums
da855b6281a9c32c7f11816133af38b6e871bf47c7866f96832ca1290cfc2d98
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / sax4bpm-0.3.1-py3-none-any.whl

Download URL sax4bpm-0.3.1-py3-none-any.whl
Size 82.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
33880f72a8e68b6bad95425897607f822e26a6f0651707cd604e8b7b91988922
BLAKE2b-256 checksum
How to use checksums
b4e200ccad836010617ac6bbd973a02ed005cc6ca0e7a51ee77ca96f3aec81dd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Security for sax4bpm 0.3.1

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.

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