fieldToVar {redcapAPI}

Convert a REDCap Data Field to an R Vector

Description

Converts a field exported from REDCap into a valid R vector

Usage

fieldToVar(
  records,
  meta_data,
  factors = TRUE,
  dates = TRUE,
  checkboxLabels = FALSE,
  labels = TRUE,
  handlers = list(),
  mChoice = NULL,
  ...
)

Arguments

records

A data frame of records returned by exportRecords or exportReports

meta_data

A data frame giving the data dictionary, as returned by exportMetaData

factors

Logical, determines if checkbox, radio button, dropdown and yesno variables are converted to factors

dates

Logical, determines if date variables are converted to POSIXct format

checkboxLabels

Logical, determines if checkbox variables are labeled as "Checked" or using the checkbox label. Only applicable when factors = TRUE

labels

Logical. Determines if the variable labels are applied to the data frame.

handlers

List, Specify type conversion overrides for specific REDCap field types. E.g., handlers=list(date_ = as.Date). For datetime specifications the datetime ordering directive from the tail is dropped. The following field types are supported: date_, datetime_, datetime_seconds_, time_mm_ss, time, float, number, calc, int, integer, select, radio, dropdown, yesno, truefalse, checkbox, and form_complete.

mChoice

logical; defaults to TRUE. Convert checkboxes to mChoice if Hmisc is installed.

...

additional arguments that are ignored.

Details

This function is called internally by exportRecords and exportReports. it is not available to the user.