yamlet (version 1.2.1)

redecorate: Redecorate a List-like Object

Description

Redecorates a list-like object. Equivalent to decorate( ..., overwrite = TRUE). If meta is not supplied, an attempt will be made to redecorate with existing decorations, if any.

Usage

redecorate(x, meta = NULL, ..., overwrite = TRUE)

Value

a list-like object, typically data.frame

Arguments

x

object

meta

file path for corresponding yamlet metadata, or a yamlet object

...

passed arguments

overwrite

passed to decorate

See Also

Other decorate: as_decorated(), as_decorated.default(), decorate(), decorate.character(), decorate.data.frame(), decorate.list(), decorate_groups(), decorate_groups.data.frame(), decorations(), decorations.data.frame(), decorations_groups(), decorations_groups.data.frame(), group_by_decorations(), group_by_decorations.data.frame()

Examples

library(dplyr)
library(magrittr)
library(csv)
library(haven)
file <- system.file(package = 'yamlet', 'extdata','quinidine.csv')
x <- decorate(as.csv(file))
x %>% select(Subject) %>% decorations
x %<>% redecorate('Subject: Patient Identifier')
x %>% select(Subject) %>% decorations

# xpt may already have labels:

dm <- 'extdata/dm.xpt.gz' %>% 
  system.file(package = 'yamlet') %>% 
  gzfile %>% 
  read_xpt

dm %>% class  
dm %>% decorations(AGE, SEX, RACE)

# but technically not decorated, and poor persistence:
bind_rows(dm, dm) %>% decorations(AGE, SEX, RACE)

# self-redecorating helps:
dm %<>% redecorate
bind_rows(dm, dm) %>% decorations(AGE, SEX, RACE)