sumExtras (version 1.0.0)

sumExtras-package: sumExtras: Extra Functions for 'gtsummary' Table Styling

Description

Provides additional convenience functions for 'gtsummary' (Sjoberg et al. (2021) tools:::Rd_expr_doi("10.32614/RJ-2021-053")) & 'gt' tables, including automatic variable labeling from dictionaries, standardized missing value display, and consistent formatting helpers for streamlined table styling workflows.

Main Functions

• extras() - Overall columns, p-values, clean styling

• clean_table() - Standardize missing value display

• add_auto_labels() - Automatic variable labeling

• use_jama_theme() - JAMA compact theme for gtsummary

• theme_gt_compact() - JAMA-style compact theme for gt

• add_group_styling() - Format grouped table headers

• add_group_colors() - Group colors with gt conversion

Important Notes on Package Dependencies

gtsummary Internals: This package depends on internal structures of the gtsummary package (specifically tbl$call_list, tbl$inputs, and tbl$table_body). Compatibility is maintained where possible, but major gtsummary updates may require sumExtras updates.

Minimum Versions: Requires gtsummary >= 1.7.0 and gt >= 0.9.0 for the necessary internal structures.

Testing: Test your workflows after gtsummary updates, especially major version changes.

Author

Maintainer: Kyle Grealis (ORCID)

Other contributors:

• Raymond Balise (ORCID) [contributor]

• Daniel Maya (ORCID) [contributor]

See Also

• gtsummary package: https://www.danieldsjoberg.com/gtsummary/

• Package website: https://www.kyleGrealis.com/sumExtras/

Examples

# \donttest{
# Basic workflow with extras()
gtsummary::trial |>
  gtsummary::tbl_summary(by = trt) |>
  extras()

# Complete workflow with styling
gtsummary::trial |>
  gtsummary::tbl_summary(by = trt, include = c(age, marker, grade, stage)) |>
  extras() |>
  gtsummary::add_variable_group_header(
    header = "Patient Characteristics",
    variables = age:stage
  ) |>
  add_group_styling() |>
  add_group_colors()
# }