tbl_continuous: Summarize continuous variable

In gtsummary: Presentation-Ready Data Summary and Analytic Result Tables

Summarize continuous variable

Description

Summarize a continuous variable by one or more categorical variables

Usage

tbl_continuous(
  data,
  variable,
  include = everything(),
  digits = NULL,
  by = NULL,
  statistic = everything() ~ "{median} ({p25}, {p75})",
  label = NULL,
  value = NULL
)

Arguments

data	(data.frame) A data frame.
variable	(tidy-select) A single column from data. Variable name of the continuous column to be summarized.
include	(tidy-select) Variables to include in the summary table. Default is everything().
digits	(formula-list-selector) Specifies how summary statistics are rounded. Values may be either integer(s) or function(s). If not specified, default formatting is assigned via assign_summary_digits(). See below for details.
by	(tidy-select) A single column from data. Summary statistics will be stratified by this variable. Default is NULL.
statistic	(formula-list-selector) Specifies summary statistics to display for each variable. The default is everything() ~ "{median} ({p25}, {p75})".
label	(formula-list-selector) Used to override default labels in summary table, e.g. list(age = "Age, years"). The default for each variable is the column label attribute, attr(., 'label'). If no label has been set, the column name is used.
value	(formula-list-selector) Supply a value to display a variable on a single row, printing the results for the variable associated with the value (similar to a 'dichotomous' display in tbl_summary()).

Value

a gtsummary table

Examples

# Example 1 ----------------------------------
tbl_continuous(
  data = trial,
  variable = age,
  by = trt,
  include = grade
)

# Example 2 ----------------------------------
trial |>
  dplyr::mutate(all_subjects = 1) |>
  tbl_continuous(
    variable = age,
    statistic = ~"{mean} ({sd})",
    by = trt,
    include = c(all_subjects, stage, grade),
    value = all_subjects ~ 1,
    label = list(all_subjects = "All Subjects")
  )

gtsummary documentation built on Oct. 5, 2024, 1:06 a.m.