Set Value Labels for a Variable

Sets value labels for a single variable in a survey design object. Extra labels (for values not present in the data) are allowed — they document the full coding scheme. A warning is issued if some observed data values lack a label.

Usage

set_val_labels(x, var, labels)

Arguments

x

A survey design object.

var

<data-masked> Variable to label (bare, unquoted).

labels

A fully named vector where names are the display labels and values are the data codes (e.g., c(Male = 1L, Female = 2L)). All elements must be named.

Value

The modified survey object, invisibly.

See also

set_value_labels() for setting labels for multiple variables, extract_val_labels() to retrieve value labels

Other metadata: extract_question_preface(), extract_val_labels(), extract_var_label(), extract_var_note(), infer_question_prefaces(), set_question_preface(), set_question_prefaces(), set_value_labels(), set_var_label(), set_var_note(), set_variable_labels(), set_variable_notes(), survey_metadata(), survey_weighting_history()

Examples

d <- as_survey(nhanes_2017, ids = sdmvpsu, weights = wtint2yr,
               strata = sdmvstra, nest = TRUE)
d <- set_val_labels(
  d, ridstatr, c("Interview only" = 1L, "Interview + exam" = 2L)
)