add_global_p: Add the global p-values

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

Add the global p-values

Description

This function uses car::Anova() to calculate global p-values for model covariates. Output from tbl_regression and tbl_uvregression objects supported.

Usage

add_global_p(x, ...)

## S3 method for class 'tbl_regression'
add_global_p(
  x,
  include = everything(),
  type = NULL,
  keep = FALSE,
  anova_fun = NULL,
  quiet = NULL,
  ...
)

## S3 method for class 'tbl_uvregression'
add_global_p(
  x,
  type = NULL,
  include = everything(),
  keep = FALSE,
  anova_fun = NULL,
  quiet = NULL,
  ...
)

Arguments

x	Object with class 'tbl_regression' or 'tbl_uvregression'
...	Additional arguments to be passed to car::Anova, aod::wald.test() or anova_fun (if specified)
include	Variables to calculate global p-value for. Input may be a vector of quoted or unquoted variable names. Default is everything()
type	Type argument passed to car::Anova(type=). Default is "III"
keep	Logical argument indicating whether to also retain the individual p-values in the table output for each level of the categorical variable. Default is FALSE.
anova_fun	Function that will be used in place of car::Anova() when specified to calculate the global p-values. function must return a tibble matching the output of car::Anova() %>% broom::tidy() including a columns called "term" and "p.values" function must accept arguments anova_fun(x, ...), where x is a model object arguments passed in ... will be passed to anova_fun(...) the add_global_p(type=) argument is ignored in ⁠anova_fun=⁠ a common function used here is tidy_wald_test(), a wrapper for aod::wald.test()
quiet	Logical indicating whether to print messages in console. Default is FALSE

Example Output

Example 1

Example 2

Author(s)

Daniel D. Sjoberg

See Also

Review list, formula, and selector syntax used throughout gtsummary

Other tbl_uvregression tools: add_q(), bold_italicize_labels_levels, inline_text.tbl_uvregression(), modify, tbl_merge(), tbl_split(), tbl_stack(), tbl_strata(), tbl_uvregression()

Other tbl_regression tools: add_q(), bold_italicize_labels_levels, combine_terms(), inline_text.tbl_regression(), modify, tbl_merge(), tbl_regression(), tbl_split(), tbl_stack(), tbl_strata()

Examples

# Example 1 ----------------------------------
tbl_lm_global_ex1 <-
  lm(marker ~ age + grade, trial) %>%
  tbl_regression() %>%
  add_global_p()

# Example 2 ----------------------------------
tbl_uv_global_ex2 <-
  trial[c("response", "trt", "age", "grade")] %>%
  tbl_uvregression(
    method = glm,
    y = response,
    method.args = list(family = binomial),
    exponentiate = TRUE
  ) %>%
  add_global_p()

gtsummary documentation built on July 26, 2023, 5:27 p.m.