Analysis of trace lengths

This metric provides an overview of the number of activities that occur in each trace.

An important remark is that this metric takes into account each instance of an activity, but not the individual lifecycle events.

## Usage

```
trace_length(
log,
level = c("log", "trace", "case"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for eventlog
trace_length(
log,
level = c("log", "trace", "case"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for grouped_eventlog
trace_length(
log,
level = c("log", "trace", "case"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for activitylog
trace_length(
log,
level = c("log", "trace", "case"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for grouped_activitylog
trace_length(
log,
level = c("log", "trace", "case"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
```

## Arguments

- log
`log`

: Object of class`log`

or derivatives (`grouped_log`

,`eventlog`

,`activitylog`

, etc.).- level
`character`

(default`"log"`

): Level of granularity for the analysis:`"log"`

(default),`"trace"`

, or`"case"`

. For more information, see`vignette("metrics", "edeaR")`

and**Details**below.- append
`logical`

(default`FALSE`

) : The arguments`append`

and`append_column`

have been deprecated in favour of`augment`

.

Indicating whether to append results to original log. Ignored when level is`"log"`

or`"trace"`

.- append_column
The arguments

`append`

and`append_column`

have been deprecated in favour of`augment`

.

Which of the output columns to append to log, if`append = TRUE`

. Default column depends on chosen level.- sort
`logical`

(default`TRUE`

): Sort output on count. Only for levels with frequency count output.- eventlog

## Details

Argument `level`

has the following options:

At

`"log"`

level, the summary statistics describing the trace length of cases in an aggregated fashion.On

`"trace"`

level, the trace length of the different process variants or traces in the log are calculated.On

`"case"`

level, the trace lengths for each case are computed.

## Methods (by class)

`trace_length(eventlog)`

: Computes trace length for an`eventlog`

.`trace_length(grouped_eventlog)`

: Computes trace length for a`grouped_eventlog`

.`trace_length(activitylog)`

: Computes trace length for an`activitylog`

.`trace_length(grouped_activitylog)`

: Computes trace length for a`grouped_activitylog`

.

## References

Swennen, M. (2018). Using Event Log Knowledge to Support Operational Exellence Techniques (Doctoral dissertation). Hasselt University.

## See also

Other metrics:
`activity_frequency()`

,
`activity_presence()`

,
`end_activities()`

,
`idle_time()`

,
`number_of_repetitions()`

,
`number_of_selfloops()`

,
`number_of_traces()`

,
`processing_time()`

,
`resource_frequency()`

,
`resource_involvement()`

,
`resource_specialisation()`

,
`start_activities()`

,
`throughput_time()`

,
`trace_coverage()`