Automatic CPN Model Generator

Automatic generation of CPN models from event logs of processes. The models can be run directly in the CPN Tools. To use the tool as a web application please use the link below:

https://cpn-model-process-discovery-1.herokuapp.com/generate-cpn-model/

Screencast of the Tool

Please note, in order to watch the introduction video (4 minutes) on Github, you need to download it.

Please note, in order to watch the complete introduction video (5 minutes) on Github, you need to download it.

User Manual

• Upload an event log in the form of XES or CSV.
  • Note that the attributes name should follow the XES Standard.
• Check the extracted model.
• Change the parameters for running different scenarios.
• Download the CPN model and the SML file as a zip file.
• Extract both files in one location.
• Make sure you have CPN Tools installed.
• Open the file .CPN and execute.
• Results are stored in the form of an event log next to the original files in the CSV format.

Tool Features

• Input: an event log in the form of XES or CSV (with the XES attribute naming standard)
• Output: a ready to execute CPN model using CPN tools along with all the required functions (generating simulated event logs)
• Automatically discovered process model (Colored Petri net)
• Enriched model with the performance information including:
  • activity duration
  • resource pooling (shared resources)
  • probability of choices in the process model
  • capacity of the resources and activities
• Business hours
• Intensity functions and delay function for different arrival rate
• Timestamp converter function for start time and complete time
• Required SML files (function) for capturing the execution of tokens in the form of event logs

Getting started

$ cd src
$ flask run

Docker

For building image:

$ build.sh

For starting application container:

$ docker load < cpn_generation.docker     # (only if the image has been updated/newly created)
$ docker-compose up -d

For stopping application container:

$ docker-compose down

Linting/Style guide

PEP8

Application Structure

.
├── src                   # Application source code
│   │
│   ├── api               # Source code for APIs
│   │   ├── models        # Python model classes
│   │   ├── services      # Python classes containing buisness logic & allows to interact with models
│   │   ├── data          # Place to store event-logs and intermediate files
│   │   ├── routes        # Routes definitions, Entry point for API calls
│   │   └── util          # Useful Python functions for the project
│   │
│   ├── wapp              # Source code for Web App client
│   │   ├── css           # Stylesheets
│   │   ├── images        # Static images
│   │   ├── js            # Javascript code files
│   │   ├── views         # Partial views/htmls for index page
│   │   ├── route.py      # Route definition for serving wapp files
│   │   └── index.html    # Index/Home page 
│   │
│   ├── config.py         # Project configuration settings
│   └── app.py            # App/Server configuration
│
│── tests                 # Unit tests source code
└── server.log            # Logs generated by the server

Contributors:

• Deekshith Shetty
• Mehmood Ahmed
• Shubham Balyan
• Sonam Chugh
• Younes Müller
• Mahsa Pourbafrani