Absent

Description

Check if the specified activity is absent from a case.

The absent rule can be used to check whether an activity is absent in a case or not. The n parameter can be configured to create a different level of absence. When n = 0, an activity is not allowed to occur even a single time. The maximum number of times it is allowed to occur is n.

Usage

absent(activity, n = 0)

Arguments

See Also

Other Cardinality rules: contains_between(), contains_exactly(), contains()

Examples

library(bupaR)
library(eventdataR)

# Check for which patients the activity "MRI SCAN" is absent.
patients %>%
 check_rule(absent("MRI SCAN"))

# Check for which patients the activity "Blood test" occurs maximum a single time,
# but not 2 times or more.
patients %>%
 check_rule(absent("Blood test", n = 1))

AND

Description

Check for co-existence of two activities.

Theand rule checks whether two activities both occur in a case (or are both absent). If activity_a exists, activity_b should also exist, and vice versa.

Usage

and(activity_a, activity_b)

Arguments

See Also

Other Exclusiveness rules: xor()

Examples

library(bupaR)
library(eventdataR)

# Check that if a patients is registered, he's also checked-out, and vice versa.
patients %>%
 check_rule(and("Registration","Check-out"))

Check Declarative Rule(s)

Description

This function can be used to check rules or constraint templates on event data. It needs a log (object of class log or derivatives, e.g. grouped_log, eventlog, activitylog, etc.). and (a) rule(s). Rules can be made with the following templates:

• Cardinality:

  • absent: Check if the specified activity is absent from a case,

  • contains: Check if the specified activity is present (contained) in a case,

  • contains_between: Check if the specified activity is present (contained) in a case between the minimum and maximum number of times,

  • contains_exactly: Check if the specified activity is present (contained) in a case for exactly n times.

• Relation:

  • ends: Check if cases end with the specified activity,

  • starts: Check if cases start with the specified activity.

  • precedence: Check for precedence between two activities,

  • response: Check for response between two activities,

  • responded_existence: Check for responded existence between two activities,

  • succession: Check for succession between two activities.

• Exclusiveness:

  • and: Check for co-existence of two activities,

  • xor: Check for exclusiveness of two activities.

Usage

check_rule(log, rule, label = NULL, eventlog = deprecated())

## S3 method for class 'log'
check_rule(log, rule, label = NULL, eventlog = deprecated())

check_rules(log, ..., eventlog = deprecated())

## S3 method for class 'log'
check_rules(log, ..., eventlog = deprecated())

Arguments

Details

The rules or constraint templates in this package are (partially) based on DecSerFlow (Declarative Service Flow Language). For more information, see the References below.

Grouped Logs

When applied to a grouped_log, the grouping variables are ignored but retained in the returned log.

Value

An annotated log (of same type as input), where – for every rule – a new column indicates whether the rule holds or not. The name of the new column can optionally be set using the label argument, or by the name of each rule in the name-rule pairs.

Methods (by class)

• check_rule(log): Check rule on a log.

Functions

• check_rules(log): Check rules on a log.

References

van der Aalst, W. M. P., & Pesic, M. (2006). DecSerFlow: Towards a Truly Declarative Service Flow Language. In M. Bravetti, M. Núñez, & G. Zavattaro (Eds.), Proceedings of the 3rd International Workshop on Web Services and Formal Methods (Vol. 4184, pp. 1–23). Springer. doi:10.1007/11841197_1

See Also

filter_rules

Examples

library(bupaR)
library(eventdataR)

# Check whether MRI Scan is preceded by Blood test.
patients %>%
 check_rule(precedence("Blood test","MRI SCAN"))

# Check whether MRI Scan is preceded by Blood test, and the case starts with Registration.
patients %>%
 check_rules(rule1 = precedence("Blood test","MRI SCAN"),
             rule2 = starts("Registration"))

Contains

Description

Check if the specified activity is present (contained) in a case.

The contains rule examines whether the supplied activity is present in a case or not. The argument n can be used to set a minimum number of occurences that should be present in each case.

Usage

contains(activity, n = 1)

Arguments

See Also

Other Cardinality rules: absent(), contains_between(), contains_exactly()

Examples

library(bupaR)
library(eventdataR)

# Each patient should be registered at least once.
patients %>%
 check_rule(contains("Registration"))

# Check whether some patients have received 2 or more blood tests.
patients %>%
 check_rule(contains("Blood test", n = 2))

Contains Between

Description

Check if the specified activity is present (contained) in a case between the minimum and maximum number of times.

The contains_between rule examines whether the supplied activity is present in a case for a certain interval of times. The arguments min and max can be used to specify the allowed interval of occurences.

Usage

contains_between(activity, min = 1, max = 1)

Arguments

See Also

Other Cardinality rules: absent(), contains_exactly(), contains()

Examples

library(bupaR)
library(eventdataR)

# A patients should have between 0 and 4 blood tests (including 0 and 4).
patients %>%
 check_rule(contains_between("Blood test", min = 0, max = 4))

Contains Exactly

Description

Check if the specified activity is present (contained) in a case for exactly n times.

The contains_exactly rule examines whether the supplied activity is present in a case for an exact number of n times.

Usage

contains_exactly(activity, n = 1)

Arguments

See Also

Other Cardinality rules: absent(), contains_between(), contains()

Examples

library(bupaR)
library(eventdataR)

# Each patient should have exactly one registration activity instance.
patients %>%
 check_rule(contains_exactly("Registration", n = 1))

Ends

Description

Check if cases end with the specified activity.

Usage

ends(activity)

Arguments

See Also

Other Ordering rules: precedence(), responded_existence(), response(), starts(), succession()

Examples

library(bupaR)
library(eventdataR)

# A patient's last activity should be the Check-out
patients %>%
 check_rule(ends("Check-out"))

Filter Using Declarative Rules

Description

This function can be used to filter event data using declaritive rules or constraint templates. It needs a log (object of class log or derivatives, e.g. grouped_log, eventlog, activitylog, etc.). and a set of rules. Rules can be made with the following templates:

• Cardinality:

  • absent: Check if the specified activity is absent from a case,

  • contains: Check if the specified activity is present (contained) in a case,

  • contains_between: Check if the specified activity is present (contained) in a case between the minimum and maximum number of times,

  • contains_exactly: Check if the specified activity is present (contained) in a case for exactly n times.

• Relation:

  • ends: Check if cases end with the specified activity,

  • starts: Check if cases start with the specified activity.

  • precedence: Check for precedence between two activities,

  • response: Check for response between two activities,

  • responded_existence: Check for responded existence between two activities,

  • succession: Check for succession between two activities.

• Exclusiveness:

  • and: Check for co-existence of two activities,

  • xor: Check for exclusiveness of two activities.

Usage

filter_rules(log, ..., eventlog = deprecated())

## S3 method for class 'log'
filter_rules(log, ..., eventlog = deprecated())

Arguments

Details

The rules or constraint templates in this package are (partially) based on DecSerFlow (Declarative Service Flow Language). For more information, see the References below.

Grouped Logs

When applied to a grouped_log, the grouping variables are ignored but retained in the returned log.

Value

A filtered log (of same type as input) that satisfied the specified rules.

Methods (by class)

• filter_rules(log): Filter a log using declaritive rules.

References

van der Aalst, W. M. P., & Pesic, M. (2006). DecSerFlow: Towards a Truly Declarative Service Flow Language. In M. Bravetti, M. Núñez, & G. Zavattaro (Eds.), Proceedings of the 3rd International Workshop on Web Services and Formal Methods (Vol. 4184, pp. 1–23). Springer. doi:10.1007/11841197_1

See Also

check_rules

Examples

library(bupaR)
library(eventdataR)

# Filter where Blood test precedes MRI SCAN and Registration is the start of the case.
patients %>%
 filter_rules(precedence("Blood test","MRI SCAN"),
              starts("Registration"))

Precedence

Description

Check for precedence between two activities.

If activity_b occured, it should be preceded by activity_a in the same case, i.e., if B was executed, it could not have been executed before A was executed. For example, the trace ⁠[A,C,B,B,A]⁠ satisfies the precedence relation.

Usage

precedence(activity_a, activity_b)

Arguments

See Also

Other Ordering rules: ends(), responded_existence(), response(), starts(), succession()

Examples

library(bupaR)
library(eventdataR)

# A MRI Scan should be preceeded by a Blood test.

patients %>%
 check_rule(precedence("Blood test","MRI SCAN"))

processcheckR - Check rules in event data

Description

Tools to check declarative rules in event logs.

Responded Existence

Description

Check for responded existence between two activities.

If activity_a occurs in a case, activity_b should also occur (before or after).

Usage

responded_existence(activity_a, activity_b)

Arguments

See Also

Other Ordering rules: ends(), precedence(), response(), starts(), succession()

Examples

library(bupaR)
library(eventdataR)

# When a Blood test occurs, a MRI Scan should also have
# happened for this patient (before or after the test).

patients %>%
 check_rule(responded_existence("Blood test","MRI SCAN"))

Response

Description

Check for response between two activities.

If activity_a is executed, it should be (eventually) followed by activity_b. The response relation is very relaxed, because B does not have to be executed immediately after A, and multiple As can be executed between the first A and the subsequent B. For example, the trace ⁠[B,A,A,A,C,B]⁠ satisfies the response relation.

Usage

response(activity_a, activity_b)

Arguments

See Also

Other Ordering rules: ends(), precedence(), responded_existence(), starts(), succession()

Examples

library(bupaR)
library(eventdataR)

# A blood test should eventually be followed by Discuss Results.
patients %>%
 check_rule(response("Blood test","Discuss Results"))

Starts

Description

Check if cases start with the specified activity.

Usage

starts(activity)

Arguments

See Also

Other Ordering rules: ends(), precedence(), responded_existence(), response(), succession()

Examples

library(bupaR)
library(eventdataR)

# Each patients should first be registered.
patients %>%
 check_rule(starts("Registration"))

Succession

Description

Check for succession between two activities.

succession checks the bi-directional execution order of activity_a and activity_b, i.e., both response and precedence relations have to hold: every A has to be (eventually) followed by B, and there has to be an A before every B. For example, the trace ⁠[A,C,A,B,B]⁠ satisfies the succession relation.

Usage

succession(activity_a, activity_b)

Arguments

See Also

Other Ordering rules: ends(), precedence(), responded_existence(), response(), starts()

Examples

library(bupaR)
library(eventdataR)

# Blood test should always happen before a MRI Scan,
# and both should happen when one of them happens.
patients %>%
 check_rule(succession("Blood test","MRI SCAN"))

XOR

Description

Check for exclusiveness of two activities.

If activity_a exists, activity_b should not exist, and vice versa.

Usage

xor(activity_a, activity_b)

Arguments

See Also

Other Exclusiveness rules: and()

Examples

library(bupaR)
library(eventdataR)

# A patient should not receive both an X-Ray and MRI Scan.
patients %>%
 check_rule(xor("X-Ray","MRI SCAN"))