tbl_butcher: Reduce size of gtsummary objects

View source: R/tbl_butcher.R

tbl_butcherR Documentation

Reduce size of gtsummary objects

Description

Some gtsummary objects can become large and the size becomes cumbersome when working with the object. The function removes all elements from a gtsummary object, except those required to print the table. This may result in gtsummary functions that add information or modify the table, such as add_global_p(), will no longer execute after the excess elements have been removed (aka butchered). Of note, the majority of inline_text() calls will continue to execute properly.

Usage

tbl_butcher(x, include = NULL)

Arguments

x

a gtsummary object

include

names of additional elements to retain in the gtsummary object. c("table_body", "table_styling") will always be retained. Default is NULL

Value

a gtsummary object

Examples


tbl_large <-
  trial %>%
  tbl_uvregression(
    y = age,
    method = lm
  )

tbl_butchered <-
  tbl_large %>%
  tbl_butcher()

# size comparison
object.size(tbl_large) %>% format(units = "Mb")
object.size(tbl_butchered) %>% format(units = "Mb")


ddsjoberg/gtsummary documentation built on Nov. 3, 2023, 11:42 a.m.