Apply a codebook to create labelled factors

Apply a codebook to create labelled factors

Usage

encode(data, codebook)

Arguments

data

A data frame or tibble

codebook

A codebook

Value

Data set with variables encoded as factors

Examples

labels <- codebook(
  code("SEX", levels = c(0, 1), labels = c("Male", "Female")),
  code("STUDY", levels = c(1, 2, 3), labels = c("S1", "S2", "S3"))
)
dataset <- data.frame(
   STUDY = c(1, 1, 1, 2, 2, 2),
   SEX   = c(0, 0, 1, 1, 1, 0),
   AGE   = c(32, 18, 64, 52, 26, 80)
)
encode(dataset, labels)
#> # A tibble: 6 × 3
#>   STUDY SEX      AGE
#>   <fct> <fct>  <dbl>
#> 1 S1    Male      32
#> 2 S1    Male      18
#> 3 S1    Female    64
#> 4 S2    Female    52
#> 5 S2    Female    26
#> 6 S2    Male      80