recode_labels: Convert between values and labels for factor-type variables...

In epicentre-msf/redcap: R Utilities For REDCap

Convert between values and labels for factor-type variables (e.g. yes/no, radio, dropdown, checkbox)

Description

Convert between values and labels for factor-type variables (e.g. yes/no, radio, dropdown, checkbox)

Usage

recode_labels(
  x,
  conn,
  dict = redcap::meta_dictionary(conn, add_complete = TRUE),
  convert_to = c("labels", "values"),
  types = c("radio", "yesno", "dropdown", "checkbox"),
  header_labs = FALSE
)

Arguments

x	Data frame representing a REDCap form (e.g. from a previous export using fetch_records)
conn	A REDCap API connection object (created with rconn)
dict	REDCap metadata dictionary. Defaults to fetching the current version with meta_dictionary
convert_to	Convert values to labels ("labels") or labels to values ("values")
types	Types of REDCap variables to convert, based on column "field_type" in the metadata dictionary. Defaults to c("radio", "yesno", "dropdown", "checkbox").
header_labs	Logical indicating whether column names of x are labels (TRUE) or raw variable names (FALSE). Default assumes header has raw variable names (i.e. FALSE).

epicentre-msf/redcap documentation built on April 13, 2025, 3:27 a.m.