recode_vec: Recode a vector

In rcoder: Lightweight Data Structure for Recoding Categorical Data without Factors

Recode a vector

Description

A simple interface to recoding a vector based on the coding linking mechanism. If the vector has the "rcoder.coding" attribute, then the coding object stored in that attribute will be used by default.

Usage

recode_vec(vec, to, from = NULL, .embed = TRUE, .bpr = TRUE)

Arguments

vec	A vector
to	A coding object to which the vector will be recoded
from	A coding object that describes the current coding of the vector. Defaults to the "rcoder.coding" attribute value, if it exists, _or_ the "bpr.coding" value (from blueprintr). If neither are found, 'from' stays 'NULL' and the function errors.
.embed	If 'TRUE', 'from' will be stored in the "rcoder.coding" attribute
.bpr	If 'TRUE', adds the _character_ representation of the coding to the "bpr.coding" attribute. Used for interop with blueprintr variable decorations

Value

The recoded vector

See Also

[assign_coding()]

Examples

# Using an explicit `from`
vec <- sample(1:3, 50, replace = TRUE)
cdng_old <- coding(code("Yes", 3), code("Maybe", 2), code("No", 1))
cdng_new <- coding(code("Yes", 2), code("Maybe", 1), code("No", 0))
recode_vec(vec, to = cdng_new, from = cdng_old)

# Using an implicit `from` with assign_coding()
vec <- sample(1:3, 50, replace = TRUE)
vec <- assign_coding(vec, cdng_old)
recode_vec(vec, cdng_new)

rcoder documentation built on Oct. 6, 2023, 9:06 a.m.