Experimental lifecycle Function converts a gtsummary object to a huxtable object. A user can use this function if they wish to add customized formatting available via the huxtable functions. The huxtable package supports output to PDF via LaTeX, as well as HTML and Word.

as_hux_table(
  x,
  include = everything(),
  return_calls = FALSE,
  strip_md_bold = TRUE
)

Arguments

x

Object created by a function from the gtsummary package (e.g. tbl_summary or tbl_regression)

include

Commands to include in output. Input may be a vector of quoted or unquoted names. tidyselect and gtsummary select helper functions are also accepted. Default is everything().

return_calls

Logical. Default is FALSE. If TRUE, the calls are returned as a list of expressions.

strip_md_bold

When TRUE, all double asterisk (markdown language for bold weight) in column labels and spanning headers are removed. Default is TRUE

Value

A huxtable object

Details

The as_hux_table() takes the data frame that will be printed, converts it to a huxtable and formats the table with the following huxtable functions:

  1. huxtable::huxtable()

  2. huxtable::insert_row() to insert header rows

  3. huxtable::align() to set column alignment

  4. huxtable::set_left_padding() to indent variable levels

  5. huxtable::add_footnote() to add table footnotes and source notes

  6. huxtable::set_bold() to bold cells

  7. huxtable::set_italic() to italicize cells

  8. huxtable::set_na_string() to use an em-dash for missing numbers

Any one of these commands may be omitted using the include= argument.

See also

Other gtsummary output types: as_flex_table(), as_gt(), as_kable_extra(), as_kable(), as_tibble.gtsummary()

Author

David Hugh-Jones

Examples

trial %>% dplyr::select(trt, age, grade) %>% tbl_summary(by = trt) %>% add_p() %>% as_hux_table()
#> Characteristic Drug A, N = 98 Drug B, N = 102 p-value #> ───────────────────────────────────────────────────────────────────────────── #> Age 46 (37, 59) 48 (39, 56) 0.7 #> Unknown 7 4 #> Grade 0.9 #> I 35 (36%) 33 (32%) #> II 32 (33%) 36 (35%) #> III 31 (32%) 33 (32%) #> ───────────────────────────────────────────────────────────────────────────── #> Statistics presented: Median (IQR); n (%) #> Statistical tests performed: Wilcoxon rank-sum test; chi-square #> test of independence #> #> Column names: label, stat_1, stat_2, p.value