pm4py.vis.save_vis_dotted_chart#

pm4py.vis.save_vis_dotted_chart(log: Union[EventLog, DataFrame], file_path: str, attributes=None, bgcolor: str = 'white', show_legend: bool = True, **kwargs)[source]#

Saves the visualization of the dotted chart

The dotted chart is a classic visualization of the events inside an event log across different dimensions. Each event of the event log is corresponding to a point. The dimensions are projected on a graph having: - X axis: the values of the first dimension are represented there. - Y-axis: the values of the second dimension are represented there. - Color: the values of the third dimension are represented as different colors for the points of the dotted chart.

The values can be either string, numeric or date values, and are managed accordingly by the dotted chart. The dotted chart can be built on different attributes. A convenient choice for the dotted chart is to visualize the distribution of cases and events over the time, with the following choices: - X-axis: the timestamp of the event. - Y-axis: the index of the case inside the event log. - Color: the activity of the event.

The aforementioned choice permits to identify visually patterns such as: - Batches. - Variations in the case arrival rate. - Variations in the case finishing rate.

Parameters:
  • log – Event log

  • file_path (str) – Destination path

  • attributes – Attributes that should be used to construct the dotted chart (for example, [“concept:name”, “org:resource”])

  • bgcolor (str) – background color to be used in the dotted chart

  • show_legend (bool) – boolean (enables/disables showing the legend)

import pm4py

pm4py.save_vis_dotted_chart(dataframe, 'dotted.png', attributes=['time:timestamp', 'concept:name', 'org:resource'])