ps_detailed: Detailed Performance Spectrum

View source: R/ps_detailed.R

ps_detailedR Documentation

Detailed Performance Spectrum

Description

Plots the detailed 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 detailed performance spectrum visualises variability of durations in a segment across cases and time (Denisov et al., 2018). See References for more details.

Usage

ps_detailed(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  scale = NULL
)

## S3 method for class 'log'
ps_detailed(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  scale = NULL
)

## S3 method for class 'grouped_log'
ps_detailed(
  log,
  segment_coverage,
  n_segments,
  classification = NULL,
  scale = 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.

scale

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

Value

A ggplot2 object describing the detailed performance spectrum.

Methods (by class)

  • ps_detailed(log): Plot detailed performance spectrum for a log.

  • ps_detailed(grouped_log): Plot detailed 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. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1007/978-3-319-98648-7_9")}

See Also

ps_aggregated()

Examples


library(psmineR)
library(eventdataR)

sepsis %>%
 ps_detailed(segment_coverage = 0.2,
             classification = "quartile")


psmineR documentation built on Sept. 9, 2025, 5:26 p.m.