cat_group_tbl: Summarize two categorical variables

In summarytabl: Generate Summary Tables for Categorical, Ordinal, and Continuous Data

Summarize two categorical variables

Description

cat_group_tbl() summarizes nominal or categorical variables by a grouping variable, returning frequency counts and percentages.

Usage

cat_group_tbl(
  data,
  row_var,
  col_var,
  margins = "all",
  na.rm.row_var = FALSE,
  na.rm.col_var = FALSE,
  pivot = "longer",
  only = NULL,
  ignore = NULL
)

Arguments

data	A data frame.
row_var	A character string of the name of a variable in data containing categorical data. This is the primary categorical variable.
col_var	A character string of the name of a variable in data containing categorical data. This is the secondary categorical variable.
margins	A character string that determines how percentage values are calculated; whether they sum to one across rows, columns, or the entire table (i.e., all). Defaults to all, but can also be set to rows or columns.
na.rm.row_var	A logical value indicating whether missing values for row_var should be removed before calculations. Default is FALSE.
na.rm.col_var	A logical value indicating whether missing values for col_var should be removed before calculations. Default is FALSE.
pivot	A character string that determines the format of the table. By default, longer returns the data in the long format. To return the data in the wide format, specify wider.
only	A character string or vector of character strings of the types of summary data to return. Default is NULL, which returns both counts and percentages. To return only counts or percentages, use count or percent, respectively.
ignore	An optional named vector or list that defines values to exclude from row_var and col_var. If set to NULL (default), all values are retained. To exclude multiple values from row_var or col_var, provide them as a named list.

Value

A tibble showing the count and percentage of each category in row_var by each category in col_var.

Author(s)

Ama Nyame-Mensah

Examples

cat_group_tbl(data = nlsy,
              row_var = "gender",
              col_var = "bthwht",
              pivot = "wider",
              only = "count")

cat_group_tbl(data = nlsy,
              row_var = "birthord",
              col_var = "breastfed",
              pivot = "longer")

summarytabl documentation built on Nov. 6, 2025, 5:07 p.m.