cross_tbl: Table of descriptive statistics by categorical variable.

Description

cross_tbl is a wrapper to function from package tbl_summary that constructs tables of descriptive statistics stratified by levels of a categorical outcome.

Usage

cross_tbl(
  data,
  by,
  head_label = " ",
  bold = TRUE,
  show_total = TRUE,
  p_val = FALSE,
  pad = 3,
  method = 2,
  ...
)

Value

A huxtable with descriptive statistics stratified by levels of the outcome.

Arguments

data: A data frame where the variables in the formula can be found.
by: The quoted name of the categorical variable (factor) used for the stratification.
head_label: Character, label to be used as head for the variable's column.
bold: Display labels in bold?
show_total: Logical, show column with totals?
p_val: Logical, show p-values?
pad: Numerical, padding above and bellow rows.
method: An integer indicating methods for continuous variables. 1 Reports means and standard deviations. 2 Reports medians and interquartile ranges.
...: Additional arguments passed to tbl_summary.

Details

Function cross_tbl is a relatively simple wrapper to function tbl_summary. It constructs contingency tables and can also be used to report a table with descriptives for all variables stratified by one of the variables. Please see examples to see how to list variables. If data is labelled, the label of the stratifying variable is used as part of the header.

Examples

Run this code

require(dplyr, quietly = TRUE)

#' data(Oncho)

## A two by two contingency table:
Oncho |>
  select(mf, area) |>
  cross_tbl(by = "mf", bold = TRUE) |>
  theme_pubh(2)

## Reporting prevalence:
Oncho |>
  select(mf, area) |>
  cross_tbl(by = "area", bold = TRUE) |>
  theme_pubh(2)

## Descriptive statistics for all variables in the \code{Oncho} data set except \code{id}.
Oncho |>
  select(-id) |>
  cross_tbl(by = "mf", bold = TRUE) |>
  theme_pubh(2)