Skip to contents

Aggregated Performance Spectrum

Source: R/ps_aggregated.R
ps_aggregated.Rd

Plots the aggregated performance spectrum. The performance spectrum describes the event data in terms of segments, i.e., pairs of related process steps. The performance of each segment is measured and plotted for any occurrences of this segment over time and can be classified, e.g., regarding the overall population. The aggregated performance spectrum visualises the amount of cases of particular performance over time (Denisov et al., 2018). See References for more details.

Usage

ps_aggregated(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  grouping = c("start", "complete"),
  scale = NULL,
  bins = 30
)

# S3 method for log
ps_aggregated(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  grouping = c("start", "complete"),
  scale = NULL,
  bins = 30
)

# S3 method for grouped_log
ps_aggregated(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  grouping = c("start", "complete"),
  scale = NULL,
  bins = NULL
)

Arguments

log

log: Object of class log or derivatives (grouped_log, eventlog, activitylog, etc.).

segment_coverage, n_segments

numeric: Provide either segment_coverage or n_segments. If neither is provided, segment_coverage = 0.2 will be used.
segment_coverage: The percentage of cases (default 0.2) in which each segment must be present to be visualised in the spectrum. Ignored if n_segments is specified.
n_segments: Visualise only the top n segments based on frequency.

classification

character (default NULL): The variable defining the colour legend. This variable should be present in log.
If NULL (default) when log is a grouped_log, the first grouping variable will be used as classification.
If NULL (default) or "quartile" when log is an eventlog or activitylog, a quartile variable dividing the durations of the segments in quartiles is calculated.

grouping

character (default "start"): The timestamps, "start" or "complete", which are binned in the histogram.

scale

ggplot2 scale function (default scale_fill_discrete_bupaR): Set color scale. Defaults to scale_fill_discrete_bupaR.

bins

numeric (default 30): The number of bins in the aggregated performance spectrum.

Value

A ggplot2 object describing the aggregated performance spectrum.

Methods (by class)

  • ps_aggregated(log): Plot aggregated performance spectrum for a log.

  • ps_aggregated(grouped_log): Plot aggregated performance spectrum for a grouped_log.

References

Denisov, V., Fahland, D., & van der Aalst, W. M. P. (2018). Unbiased, Fine-Grained Description of Processes Performance from Event Data. In M. Weske, M. Montali, I. Weber, & J. vom Brocke (Eds.), Proceedings of the 16th International Conference on Business Process Management (Vol. 11080, pp. 139–157). Springer International Publishing. doi:10.1007/978-3-319-98648-7_9

See also

ps_detailed()

Examples

library(psmineR)
library(eventdataR)

sepsis %>%
 ps_aggregated(segment_coverage = 0.2,
               classification = "quartile",
               grouping = "start",
               bins = 15)