parse_recode_instructions: Parse Recode Instructions

View source: R/parse_recode_instructions.R

parse_recode_instructionsR Documentation

Parse Recode Instructions

Description

Parse Recode Instructions

Usage

parse_recode_instructions(recode, catch_NAs = TRUE, simplify_to_numeric = TRUE)

Arguments

recode

data.frame. In the format described in "Details"

catch_NAs

logical. Should the presence of "NA" be turned into NA_character_

simplify_to_numeric

Converts old and new into numerics if it can be done loselessly. Otherwise, a warning will be thrown.

Details

Imports a data.frame with at a minimum of the following columns: old_var, old_value, new_var, new_value, new_label, start_year, and end_year.

  • old_var: Column in the dataset containing the values to be recoded

  • old_value: value in the column old_var to be translated into a new value by recoding. If left blank/NA/""/NULL or otherwise missing, the recode operation will essentially take the form of a rename of old_var -> new_var

  • new_var: Column where the recoded values will be placed. If new_var doesn't exist, than it will be created. Otherwise it will be overwritten.

  • new_value: Column indicating where the new values for the recoding process exist. It is positionally (e.g. row) tied to a particular old_value. If blank, it helps identify a simpler rename operation.

  • new_label: character (or convertable to character): The factor label that old_value will be recoded to in conjunction with the position of new_value

Value

list of lists of recode instructions.


PHSKC-APDE/rads documentation built on April 14, 2025, 10:47 a.m.