findPatients: Find patients based on clinical critera

Description Usage Arguments Value Examples

View source: R/findPatients.R

Description

Identify patients based on clinical data inclusion (and exclusion, if desired) criteria. Flexible to allow for multiple data types, vocabularies, and concepts.

Usage

1
2
3
4
findPatients(strategy_in = "mapped", vocabulary_in, codes_in,
  function_in = "or", strategy_out = NULL, vocabulary_out = NULL,
  codes_out = NULL, function_out = NULL, declare = FALSE, save = FALSE,
  out_name = NULL)

Arguments

strategy_in

"mapped" or "direct" (dictates the strategy for how inclusion criteria are treated. "direct" searches for codes as provided, "mapped" maps criteria to standard concepts and finds descendants.

vocabulary_in

vocabularies for inclusion criteria (comma-separated string of vocabularies)

codes_in

specific concept codes for inclusion criteria (semi-colon separated string of code concepts, corresponding to the order for vocabulary_in. Multiple codes can be used per vocabulary and should be comma-separated.)

function_in

"and" or "or" (dictates how multiple inclusion should be treated. "and" necessitates that all inclusion criteria are met (i.e., intersection), while "or" allows for any critera to be met (i.e., union) )

strategy_out

"mapped", "direct", or NULL (default) (dictates the strategy for how exclusion are treated. NULL indicates no exclusion criteria.)

vocabulary_out

vocabularies for exclusion criteria or NULL (default) (comma-separated string of relevant vocabularies for exclusion criteria. NULL indicates no exclusion criteria)

codes_out

specific concept codes for exclusion criteria or NULL (default) (semi-colon separated string of code concepts for inclusion criteria, corresponding to the order for vocabulary_out. Multiple codes can be used per vocabulary and should be comma-separated. NULL indicates no exclusion criteria.)

function_out

"and", "or", or NULL (default) (dictates how multiple exclusion should be treated. and necessitates that all exclusion criteria are met (i.e., intersection), while or allows for any critera to be met (i.e., union). NULL indicates no exclusion criteria. )

declare

TRUE/FALSE will output status and data information during the process

save

TRUE/FALSE whether intermediate components of the search should be saved (e.g., mapped concepts found with unique patient counts per concept).

out_name

name assigned to search query or NULL (if save = TRUE, saves query using provided name. If the provided name already exists as a directory (or is NULL), the directory defaults to datetime name)

Value

List of patients that meet inclusion criteria (and not exclusion criteria if entered).

Examples

1
patient_list = findPatients(strategy_in="mapped", vocabulary_in = "ICD10CM", codes_in = "F41", strategy_out="mapped", vocabulary_out = "MeSH", codes_out = "D002998", function_out = "and")

BenGlicksberg/ROMOP documentation built on March 6, 2020, 8:15 p.m.