add_n.tbl_summary {gtsummary} | R Documentation |
Add column with N
Description
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
Usage
## S3 method for class 'tbl_summary'
add_n(
x,
statistic = "{n}",
col_label = "**N**",
footnote = FALSE,
last = FALSE,
...
)
## S3 method for class 'tbl_svysummary'
add_n(
x,
statistic = "{n}",
col_label = "**N**",
footnote = FALSE,
last = FALSE,
...
)
Arguments
x |
Object with class |
statistic |
String indicating the statistic to report. Default is the
number of non-missing observation for each variable,
The argument uses glue::glue syntax and multiple statistics may be reported,
e.g. |
col_label |
String indicating the column label. Default is |
footnote |
Logical argument indicating whether to print a footnote
clarifying the statistics presented. Default is |
last |
Logical indicator to include N column last in table.
Default is |
... |
Not used |
Value
A tbl_summary
or tbl_svysummary
object
Example Output
Example 1
Author(s)
Daniel D. Sjoberg
See Also
Review list, formula, and selector syntax used throughout gtsummary
Other tbl_summary tools:
add_overall()
,
add_p.tbl_summary()
,
add_q()
,
add_stat_label()
,
bold_italicize_labels_levels
,
inline_text.tbl_summary()
,
inline_text.tbl_survfit()
,
modify
,
separate_p_footnotes()
,
tbl_custom_summary()
,
tbl_merge()
,
tbl_split()
,
tbl_stack()
,
tbl_strata()
,
tbl_summary()
Other tbl_svysummary tools:
add_overall()
,
add_p.tbl_svysummary()
,
add_q()
,
add_stat_label()
,
modify
,
separate_p_footnotes()
,
tbl_merge()
,
tbl_split()
,
tbl_stack()
,
tbl_strata()
,
tbl_svysummary()
Examples
# Example 1 ----------------------------------
tbl_n_ex <-
trial[c("trt", "age", "grade", "response")] %>%
tbl_summary(by = trt) %>%
add_n()