levelcast: Recode codes to a higher level in a hierarchy

In codelist: Working with Code Lists

Recode codes to a higher level in a hierarchy

Description

Recode codes to a higher level in a hierarchy

Usage

levelcast(
  x,
  level,
  codelist = attr(x, "codelist"),
  over_level = c("error", "missing", "ignore"),
  filter_codelist = TRUE
)

Arguments

x	vector of codes to record. This can be an object of type code.
level	level to which to cast the codes.
codelist	the codelist for the codes. This code list should be hierarchical will the cast have effect.
over_level	how to handle codes that are in a higher level than the level that is cast to. The default 'error' will generate an error; 'missing' will result in missing values for those codes; 'ignore' will keep these codes.
filter_codelist	if TRUE codes with a level lower than the lever cast to will be removed from the code list that is returned with the result.

Details

When handling codes that are in a higher level than the level that is cast to, codes that are missing values are ignored as these are often in the highest level.

Value

A vector with the same length as x.

Examples

cl <- codelist(
    codes = c("A", "B", "A1", "A2", "B1", "B2", "A1.1", "B2.2", "X"),
    parent = c(NA, NA, "A", "A", "B", "B", "A1", "B2", NA),
    missing = c(0, 0, 0, 0, 0, 0, 0, 0, 1)
  )
x <- code(c("A1.1", "A1", "A2", "B2.2", "B2.2", NA, "B2", "X"), cl)
levelcast(x, 1)
levelcast(x, 2, over_level = "ignore")
levelcast(x, 0)

codelist documentation built on April 12, 2025, 2:25 a.m.