Analyses the frequency of resources at different levels of analysis.

## Usage

```
resource_frequency(
log,
level = c("log", "case", "activity", "resource", "resource-activity"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for eventlog
resource_frequency(
log,
level = c("log", "case", "activity", "resource", "resource-activity"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for grouped_eventlog
resource_frequency(
log,
level = c("log", "case", "activity", "resource", "resource-activity"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for activitylog
resource_frequency(
log,
level = c("log", "case", "activity", "resource", "resource-activity"),
append = deprecated(),
append_column = NULL,
sort = TRUE,
eventlog = deprecated()
)
# S3 method for grouped_activitylog
resource_frequency(
log,
level = c("log", "case", "activity", "resource", "resource-activity"),
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),`"case"`

,`"activity"`

,`"resource"`

, or`"resource-activity"`

. 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, summary statistics show the number of times a resource executes an activity in the complete log.On

`"case"`

level, summary statistics of the frequency of resources can be used to get a better view on the variance between the different cases, to get an insight into the number of different resources working on each case together with the number of activities a resource executes per case.On

`"activity"`

level, the resource frequency states how many different resources are executing a specific activity in the complete log.On

`"resource"`

level, this metric simply shows the absolute and relative frequency of occurrences of each resource in the complete log.On

`"resource-activity"`

level, the absolute and relative number of times each resource-activity combination occurs in the complete log can be calculated. Two different relative numbers are provided here, one from the resource perspective and one from the activity perspective. At the resource perspective, the denominator is the total number of executions by the resource under consideration. At the activity perspective, the denominator is the total number of occurrences of the activity under consideration.

## Methods (by class)

`resource_frequency(eventlog)`

: Computes the resource frequency for an`eventlog`

.`resource_frequency(grouped_eventlog)`

: Computes the resource frequency for a`grouped_eventlog`

.`resource_frequency(activitylog)`

: Computes the resource frequency for an`activitylog`

.`resource_frequency(grouped_activitylog)`

: Computes the resource frequency 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_involvement()`

,
`resource_specialisation()`

,
`start_activities()`

,
`throughput_time()`

,
`trace_coverage()`

,
`trace_length()`