redecorate: Redecorate a List-like Object

In yamlet: Versatile Curation of Table Metadata

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)

Arguments

x	object
meta	file path for corresponding yamlet metadata, or a yamlet object
...	passed arguments
overwrite	passed to decorate

Value

a list-like object, typically data.frame

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)

yamlet documentation built on June 8, 2025, 1:57 p.m.