For each variable in a tbl_summary table, the add_n function adds a column with the total number of non-missing (or missing) observations

# S3 method for tbl_summary
add_n(
  x,
  statistic = "{n}",
  col_label = "**N**",
  footnote = FALSE,
  last = FALSE,
  missing = NULL,
  ...
)

# S3 method for tbl_svysummary
add_n(
  x,
  statistic = "{n}",
  col_label = "**N**",
  footnote = FALSE,
  last = FALSE,
  missing = NULL,
  ...
)

Arguments

x

Object with class tbl_summary from the tbl_summary function or with class tbl_svysummary from the tbl_svysummary function

statistic

String indicating the statistic to report. Default is the number of non-missing observation for each variable, statistic = "{n}". Other statistics available to report include:

  • "{N}" total number of observations,

  • "{n}" number of non-missing observations,

  • "{n_miss}" number of missing observations,

  • "{p}" percent non-missing data,

  • "{p_miss}" percent missing data The argument uses glue::glue syntax and multiple statistics may be reported, e.g. statistic = "{n} / {N} ({p}%)"

col_label

String indicating the column label. Default is "**N**"

footnote

Logical argument indicating whether to print a footnote clarifying the statistics presented. Default is FALSE

last

Logical indicator to include N column last in table. Default is FALSE, which will display N column first.

missing

DEPRECATED. Logical argument indicating whether to print N (missing = FALSE), or N missing (missing = TRUE). Default is FALSE

...

Not used

Value

A tbl_summary or tbl_svysummary object

Example Output

See also

Author

Daniel D. Sjoberg

Examples

tbl_n_ex <- trial[c("trt", "age", "grade", "response")] %>% tbl_summary(by = trt) %>% add_n()