ReLIGn-tool

The tool was presented at the 7th International Conference on Process Mining (ICPM 2025) in Montevideo, Uruguay, where it received the Best Demo Award 🏆.

This project provides a tool for process Model Repairing supported by Local Instance Graphs, following the approach described in the article Model repair supported by frequent anomalous local instance graphs. A demonstration of the tool is available at this link.

Requirements

To run our application you need to have installed:

• Python 3.9.6

• Graphviz

• A set of packages that you can configure inside an environment by using the requirements.txt file

Optional (only required to generate Instance Graphs)

• Java 8: make sure the correct Java 8 version is in your PATH (java -version should show 1.8.x).

• MySQL: must be configured so that the root user can connect with no password.

MySQL Version Requirement

This project requires the mysql_native_password authentication plugin.

• MySQL 5.7 and MySQL 8.0.x up to 8.0.34 support the plugin by default.
• MySQL 8.4 LTS: mysql_native_password is available but disabled by default.
  To enable it, add the following to your my.cnf and restart MySQL:

  [mysqld]
  mysql_native_password=ON

• MySQL 9.0 and above: mysql_native_password has been removed and is not supported.

Important notes for MariaDB users

If you use MariaDB instead of MySQL:

1. Edit the configuration file (usually /etc/mysql/mariadb.conf.d/50-server.cnf on Linux).
2. Under the [mysqld] section, set:

   lower_case_table_names=1

3. Restart MariaDB:

   sudo systemctl restart mariadb
   

Reproduce results

To run our program copy and paste the following command in your terminal:

git clone https://github.com/KDMG/ReLIGn-tool/
cd ReLIGn-tool

python ReLIGn.py

In the data folder you can find some data to test the tool.

Contributors

Contributor name	Contacts
Claudia Diamantini	c.diamantini@univpm.it
Laura Genga	l.genga@tue.nl
Chiara Gobbi	c.gobbi@pm.univpm.it
Alessandro Mele	a.mele@pm.univpm.it
Domenico Potena	d.potena@pm.univpm.it