The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

sumExtras

R-CMD-check CRAN status Lifecycle: stable Tests: 245 passing

Some extras for gtsummary tables

Overview

sumExtras provides convenience functions for gtsummary and gt tables, including automatic variable labeling from dictionaries, standardized missing value display, and consistent formatting helpers for streamlined table styling workflows.

Installation

CRAN

install.packages("sumExtras")

Development version

You can install the development version of sumExtras from GitHub:

# install.packages("pak")
pak::pak("kyleGrealis/sumExtras")

Alternatively, using remotes:

# install.packages("remotes")
remotes::install_github("kyleGrealis/sumExtras")

See the Difference

my_table <- trial |>
  mutate(
    stage = case_when(
      trt == 'Drug A' & stage == 'T2' ~ NA,
      trt == 'Drug B' & stage == 'T4' ~ NA,
      .default = stage
    )
  ) |>
  select(age, marker, grade, stage, trt)

Basic gtsummary

sumExtras with Advanced Styling

 
my_table |> 
  tbl_summary(by = trt) |>
  add_overall() |>
  add_p()
 
# Apply JAMA theme
use_jama_theme()

my_table |>
  tbl_summary(by = trt) |>
  extras() |>
  add_variable_group_header(
    header = "Baseline Characteristics",
    variables = age:stage
  ) |>
  add_group_styling() |>
  add_group_colors(color = "#E3F2FD")

The basic approach creates a functional table, but sumExtras makes it shine with group headers, custom formatting, background colors, and clean missing value display—all while maintaining readable code. The right example shows what’s possible when you need publication-ready tables.

Quick Start

library(sumExtras)
library(gtsummary)

# Apply the recommended JAMA theme (optional but recommended)
use_jama_theme()

# The extras() function - does it all!
trial |>
  tbl_summary(by = trt) |>
  extras()  # Adds overall, p-values, cleans missing values, and more!

# Clean missing values independently
trial |>
  tbl_summary(by = trt) |>
  clean_table()  # Standardizes missing/zero displays to "---"

# With automatic labels from your dictionary
# First, create a dictionary with Variable and Description columns
dictionary <- tibble::tribble(
  ~Variable, ~Description,
  "age", "Age at Enrollment",
  "marker", "Marker Level (ng/mL)",
  "trt", "Treatment Group",
  "grade", "Tumor Grade"
)

trial |>
  tbl_summary(by = trt) |>
  add_auto_labels() |>  # Automatically finds 'dictionary' in your environment
  extras()

What’s Included

How Labels Work

The labeling functions use the same native R attribute approach as popular packages like haven, Hmisc, and ggplot2 4.0+. Labels are stored as simple 'label' attributes on data columns—no special packages or formats required.

Your data may already have labels from various sources:
- Imported datasets (haven reads SPSS/Stata/SAS labels automatically)
- Other packages that set label attributes
- Manual labeling with attr(data$column, "label") <- "Label"
- Collaborative projects with pre-labeled data

The add_auto_labels() function intelligently reads both dictionary-based labels and existing label attributes from your data, letting you choose which takes precedence. Labels work seamlessly across the entire R ecosystem—compatible with gtsummary, ggplot2, gt, and other label-aware packages.

Table Type Support

The extras() function is designed to work with all gtsummary table types using a “warn-and-continue” philosophy:
* It applies all compatible features to your table
* For unsupported features, it issues a helpful warning and continues with what works
* The function always succeeds - it never breaks your pipeline

Feature Support by Table Type

Table Type bold_labels modify_header add_overall add_p Status
tbl_summary (stratified) ✅ ✅ ✅ ✅ Full support
tbl_summary (unstratified) ✅ ✅ ⚠️ ⚠️ Partial support
tbl_svysummary (stratified) ✅ ✅ ✅ ✅ Full support
tbl_regression ✅ ✅ ⚠️ ⚠️ Partial support
tbl_strata ✅ ✅ ⚠️ ⚠️ Partial support

Legend:
* ✅ Feature works and is applied
* ⚠️ Feature not applicable to this table type (function warns but continues)

How It Works

When you call extras() on any table:

  1. Always applied: Bold labels and clean headers
  2. Conditionally applied: Overall column and p-values (only on stratified summary tables)
  3. On unsupported features: You’ll see a warning, but the function completes successfully

Example with an unstratified table:

trial |>
  tbl_summary() |>  # No 'by' argument = unstratified
  extras()  # Warns that overall/p-values aren't supported, but still bolds labels and cleans headers

You’ll see a warning like: “This table is not stratified. Overall column and p-values require stratification. Applying only bold_labels() and modify_header().” but your table is still successfully formatted!

The Name

sumExtras = “SUMmary table EXTRAS” + “SOME EXTRAS for gtSUMMARY”

Get it?

Getting Help

Testing & Quality

sumExtras is thoroughly tested with:

All tests pass with 100% success rate. See the tests directory for detailed test examples and patterns.

Upcoming Features

We’re constantly improving sumExtras. Upcoming feature considerations include:

Contributing

We welcome contributions and ideas! Here’s how you can help:

License

sumExtras is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

sumExtras is built with love using R and these amazing packages:

sumExtras adds some extras to your summary tables! ✨

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.