Return to User manual

Animate logs on top of BPMN model

Authors: Hoang (Bruce) Nguyen, Simon Raboczi, Marcello La Rosa

This plugin allows one or more event logs to be replayed on top of a BPMN model. When using multiple logs, these could capture different variants of the same business process, while the process model would represent a normative specification of how things should be performed within an organization.

To use this plugin, select one or more logs and one BPMN model from the repository, and hit “Analyze>Animate logs”. Alternatively, the plugin can be launched directly from the Apromore Editor by pressing the “Animate logs…” button from the top bar, in which case a dialog window will ask to import one or more logs and to assign a color to each of them. The logs and the model selected are assumed to be related (high fitness). If not, the plugin will not be able to replay the logs on top of the model.

Screen Shot 2018-04-03 at 9.57.51 pm

The plugin will then show the process model within the Editor and a timeline with the logs being used as input (each coded with a different color), plus some statistics about each log, such as the total number of traces and how many of these are used for the animation, as well as information about the adherence of a log to the process model. Screen Shot 2018-04-03 at 10.07.25 pmThe animation will start by hitting the button “Play”. Each token represents the progress of a particular process instance (a case), with the token’s color encoding the log the case comes from.

Screen Shot 2018-04-03 at 10.08.24 pm

Standard controls are available to play, pause, fast or slow forward/reward the animation and to skip through the end/beginning. The replay speed can be changed with the vertical bar. These actions are also available during the animation. If the view on the model is zoomed in/out, or the model layout is changed, the tool will try to adapt the animation to the new position of the elements on the canvas.

A token traversing an activity indicates that the case captured by that token is performing that activity. However, if the token goes around an activity’s border, this indicates that the particular activity is skipped in that process case.

Screen Shot 2018-04-03 at 10.24.01 pm

A large number of tokens slowly traversing a given path may indicate a performance bottleneck, e.g. cases pile up in a particular point of the process due to resources unavailability.

Screen Shot 2018-04-03 at 10.24.06 pm

A screencast where this plugin is used in combination with other plugins is available here.

Example files to use with this plugin can be found in folder “Examples>Log animation” of the Apromore repository.