Skip to contents

Valueset Conformance – Processing

Source: R/valueset_conformance.R
process_vs.Rd

Intakes the output of check_vs in order to apply additional processing. This includes computing row and patient proportions and computing overall totals across all sites included in the input.

Usage

process_vs(vs_results, rslt_source = "remote", csv_rslt_path = NULL)

Arguments

vs_results

tabular input || required

The tabular output of check_vs. This table should include results for all institutions that should be included in the computation of overall / "network level" statistics.

rslt_source

string || defaults to remote

A string that identifies the location of the vs_results table. Acceptable values are

  • local - table is stored as a dataframe in the local R environment

  • csv - table is stored as a CSV file

  • remote - table is stored on a remote database

csv_rslt_path

string || defaults to NULL

If rslt_source has been set to csv, this parameter should indicate the path to the result file(s). Otherwise, this parameter can be left as NULL

Value

This function will return a list that contains two dataframes: -vs_processed: The vs_results table with additional rows reflecting the overall / "network level" counts and a computed proportion of violating concepts -vs_violations: A table listing all of the violating values that exist in the data that do not comply with the provided valueset definition

Examples

# This function should be run after check_vs has been executed for all
# network institutions and results have been combined into a common table

# Once the labels have been applied, the function can be executed
## When results are kept locally:
if (FALSE) { # \dontrun{
my_vs_process <- process_vs(vs_results = my_vs_rslts,
                            rslt_source = 'local')
} # }

## When results are kept in CSV files:
if (FALSE) { # \dontrun{
my_vs_process <- process_vs(vs_results = 'my_vs_rslts',
                            rslt_source = 'csv',
                            csv_rslt_path = 'path/to/my/results')
} # }

## When results are kept on a remote database:
if (FALSE) { # \dontrun{
my_vs_process <- process_vs(vs_results = 'my_vs_rslts',
                            rslt_source = 'remote')
} # }