tbl_ard_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_ard_continuous(
  cards,
  variable,
  include,
  by = NULL,
  label = NULL,
  statistic = everything() ~ "{median} ({p25}, {p75})"
)

Arguments

cards	(card) An ARD object of class "card" typically created with ⁠cards::ard_*()⁠ functions.
variable	(string) A single variable name of the continuous variable being summarized.
include	(character) Character vector of the categorical variables to
by	(string) A single variable name of the stratifying variable.
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.
statistic	(formula-list-selector) Specifies summary statistics to display for each variable. The default is everything() ~ "{median} ({p25}, {p75})".

Value

a gtsummary table of class "tbl_ard_summary"

Examples

library(cards)

bind_ard(
  # the primary ARD with the results
  ard_continuous(
    trial,
    # the order variables are passed here is important.
    # 'trt' is the column stratifying variable and needs to be listed first.
    by = c(trt, grade),
    variables = age
  ),
  # add univariate trt tabulation
  ard_categorical(
    trial,
    variables = trt
  ),
  # add missing and attributes ARD
  ard_missing(
    trial,
    by = c(trt, grade),
    variables = age
  ),
  ard_attributes(
    trial,
    variables = c(trt, grade, age)
  )
) |>
  tbl_ard_continuous(by = "trt", variable = "age", include = "grade")

bind_ard(
  # the primary ARD with the results
  ard_continuous(trial, by = grade, variables = age),
  # add missing and attributes ARD
  ard_missing(trial, by = grade, variables = age),
  ard_attributes(trial, variables = c(grade, age))
) |>
  tbl_ard_continuous(variable = "age", include = "grade")

gtsummary documentation built on Sept. 11, 2024, 5:50 p.m.