REDCap_col_labels: Add variable labels from a REDCap codebook

In melidosData: Load Data from the MeLiDos Field Study

Add variable labels from a REDCap codebook

Description

Sets the label attribute on matching columns in data.

Usage

REDCap_col_labels(
  data,
  lookup,
  var_col = `Variable / Field Name`,
  label_col = `Field Label`,
  warn = TRUE
)

Arguments

data	A data frame.
lookup	A data frame with variable names and labels.
var_col	Unquoted column in lookup containing variable names.
label_col	Unquoted column in lookup containing human-readable labels.
warn	Logical; warn when labels are provided for variables not present in data.

Value

data with label attributes added.

Examples

dict_path <- system.file("ext", "DataDictionary_chronotype.csv",
  package = "melidosData"
)
dict <- utils::read.csv(dict_path, check.names = FALSE)
dict <- REDCap_codebook_prepare(dict,  form.filter = "mctq")
labelled <- REDCap_col_labels(REDCap_example_chronotype, dict)
attr(labelled[[5]], "label")

melidosData documentation built on April 22, 2026, 5:09 p.m.