assign_tests: Assign Test

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

Assign Test

Description

This function is used to assign default tests for add_p() and add_difference().

Usage

assign_tests(x, ...)

## S3 method for class 'tbl_summary'
assign_tests(
  x,
  include,
  by = x$inputs$by,
  test = NULL,
  group = NULL,
  adj.vars = NULL,
  summary_type = x$inputs$type,
  calling_fun = c("add_p", "add_difference"),
  ...
)

## S3 method for class 'tbl_svysummary'
assign_tests(
  x,
  include,
  by = x$inputs$by,
  test = NULL,
  group = NULL,
  adj.vars = NULL,
  summary_type = x$inputs$type,
  calling_fun = c("add_p", "add_difference"),
  ...
)

## S3 method for class 'tbl_continuous'
assign_tests(x, include, by, cont_variable, test = NULL, group = NULL, ...)

## S3 method for class 'tbl_survfit'
assign_tests(x, include, test = NULL, ...)

Arguments

x	(gtsummary) a table of class 'gtsummary'
...	Passed to rlang::abort(), rlang::warn() or rlang::inform().
include	(character) Character vector of column names to assign a default tests.
by	(string) a single stratifying column name
test	(named list) a named list of tests.
group	(string) a variable name indicating the grouping column for correlated data. Default is NULL.
adj.vars	(character) Variables to include in adjusted calculations (e.g. in ANCOVA models).
summary_type	(named list) named list of summary types
calling_fun	(string) Must be one of 'add_p' and 'add_difference'. Depending on the context, different defaults are set.
cont_variable	(string) a column name of the continuous summary variable in tbl_continuous()

Value

A table of class 'gtsummary'

Examples

trial |>
  tbl_summary(
    by = trt,
    include = c(age, stage)
  ) |>
  assign_tests(include = c("age", "stage"), calling_fun = "add_p")

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