fmt_equivalence: Rounding with number of digits determined by an equivalence...

In vincentarelbundock/gtsummary: Summary Tables and Plots for Statistical Models and Data: Beautiful, Customizable, and Publication-Ready

Rounding with number of digits determined by an equivalence test

Description

This function implements the suggestions of Astier & Wolak for the number of decimal digits to keep for coefficient estimates. The other statistics are rounded by fmt_significant().

Usage

fmt_equivalence(conf_level = 0.95, digits = 3, pdigits = NULL, ...)

Arguments

conf_level	Confidence level to use for the equivalence test (1 - alpha).
digits	Number of significant digits to keep.
pdigits	Number of decimal digits to keep for p values. If NULL, the value of digits is used.
...	Additional arguments are passed to the format() function (e.g., big.marks, scientific). See ?format

References

Astier, Nicolas, and Frank A. Wolak. Credible Numbers: A Procedure for Reporting Statistical Precision in Parameter Estimates. No. w32124. National Bureau of Economic Research, 2024.

Examples

library(modelsummary)
mod <- lm(mpg ~ hp, mtcars)

# Default equivalence-based formatting
modelsummary(mod, fmt = fmt_equivalence())

# alpha = 0.2
modelsummary(mod, fmt = fmt_equivalence(conf_level = .8))

# default equivalence, but with alternative significant digits for other statistics
modelsummary(mod, fmt = fmt_equivalence(digits = 5))

vincentarelbundock/gtsummary documentation built on Nov. 6, 2024, 11:07 p.m.