huxtable (version 1.2.0)

mutate.huxtable: Dplyr verbs for huxtable

Description

Huxtable can be used with dplyr verbs select, rename, slice, arrange, mutate and transmute. These will return huxtables. Other verbs like summarize will simply return data frames as normal; pull will return a vector. mutate has an extra option, detailed below.

Usage

# S3 method for huxtable
mutate(.data, ..., copy_cell_props = TRUE)

Arguments

.data

A huxtable.

...

Arguments passed to mutate.

copy_cell_props

Logical: copy cell and column properties from existing columns.

Details

If mutate creates new columns, and the argument copy_cell_props is missing or TRUE, then cell and column properties will be copied from existing columns to their left, if there are any. Otherwise, they will be the standard defaults. Row and table properties, and properties of cells in existing columns, remain unchanged.

Examples

# NOT RUN {
ht <- hux(a = 1:5, b = 1:5, c = 1:5, d = 1:5)
bold(ht)[c(1, 3), ] <- TRUE
bold(ht)[, 1] <- TRUE
ht2 <- dplyr::select(ht, b:c)
ht2
bold(ht2)
ht3 <- dplyr::mutate(ht, x = a + b)
ht3
bold(ht3)
ht4 <- dplyr::mutate(ht, x = a + b, copy_cell_props = FALSE)
bold(ht4)
# }