https://github.com/bupaverse/processcheckR
Rule-based conformance checking and filtering
https://github.com/bupaverse/processcheckR
Last synced: 4 months ago
JSON representation
Rule-based conformance checking and filtering
- Host: GitHub
- URL: https://github.com/bupaverse/processcheckR
- Owner: bupaverse
- License: other
- Created: 2019-07-29T14:14:47.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-10-03T07:01:11.000Z (over 2 years ago)
- Last Synced: 2024-08-13T07:15:08.175Z (8 months ago)
- Language: R
- Homepage: https://bupaverse.github.io/processcheckR/
- Size: 299 KB
- Stars: 4
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - bupaverse/processcheckR - Rule-based conformance checking and filtering (R)
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
# processcheckR 
[](https://CRAN.R-project.org/package=processcheckR)
[](https://github.com/bupaverse/processcheckR/actions/workflows/R-CMD-check.yaml)
[](https://app.codecov.io/gh/bupaverse/processcheckR?branch=master)
[](https://lifecycle.r-lib.org/articles/stages.html#stable)
The goal of **processcheckR** is to support rule-based conformance checking. Currently the following declarative rules can be checked:
Cardinality rules:
* `absent`: activity does not occur more than `n - 1` times,
* `contains`: activity occurs `n` times or more,
* `contains_between`: activity occurs between `n` and `m` times,
* `contains_exactly`: activity occurs exactly `n` times.
Ordering rules:
* `starts`: case starts with activity,
* `ends`: case ends with activity,
* `succession`: if activity A happens, B should happen after. If B happens, A should have happened before,
* `response`: if activity A happens, B should happen after,
* `precedence`: if activity B happens, A should have happened before,
* `responded_existence`: if activity A happens, B should also (have) happen(ed) (i.e. before or after A).
Exclusiveness:
* `and`: two activities always exist together,
* `xor`: two activities are not allowed to exist together.
Rules can be checked using the `check_rule` and `check_rules` functions (see example below). It will create a new logical variable to indicate for which cases the rule holds. The name of the variable can be configured using the `label` argument in `check_rule`.
## Installation
You can install **processcheckR** from [CRAN](https://cran.r-project.org/) with:
```{r cran-installation, eval = FALSE}
install.packages("processcheckR")
```
### Development Version
You can also install the latest (stable) development version with bugfixes and new features directly from GitHub:
```{r gh-installation, eval = FALSE}
# install.packages("devtools")
devtools::install_github("bupaverse/processcheckR")
```
## Example
```{r example}
library(bupaR)
library(processcheckR)
sepsis %>%
# Check if cases starts with "ER Registration".
check_rule(starts("ER Registration"), label = "r1") %>%
# Check if activities "CRP" and "LacticAcid" occur together.
check_rule(and("CRP","LacticAcid"), label = "r2") %>%
group_by(r1, r2) %>%
n_cases()
```