Skip to contents

Tables, manuscript-ready values and ggplot annotations from finalized statistical results. Numerical inference belongs to infercalcR; guidance and prospective planning belong to inferguidR. Plain reporting requires infercalcR and R-distributed packages. It does not require inferguidR, ggplot2, a table framework or testthat.

Installation

R 4.1.0 or later is required. Neither package is on CRAN yet. Install infercalcR first, then infereportR, from GitHub:

install.packages("remotes")
remotes::install_github("CTTIR/infercalcR")
remotes::install_github("CTTIR/infereportR", build_vignettes = TRUE)

The documentation site, with the reference and three vignettes, is at https://cttir.github.io/infereportR/. Start with “Getting started with infereportR”; “Comparison families, adjusted p-values and plot annotations” and “Descriptive tables” cover the remaining features.

Tables and text

library(infercalcR)
library(infereportR)

# A finalized result can be rendered without observations or a model object.
r <- new_inference_result(
  data.frame(row_id = "A-B", variable_id = "outcome", component = "contrast",
    estimand = "mean difference", contrast = "A minus B", estimate = -1.2,
    conf.low = -2.1, conf.high = -0.3, conf.level = 0.95,
    interval.method = "Welch t", interval.scale = "difference",
    interval.scope = "pointwise", p.value = 0.012, status = "ok"),
  list(method_id = "welch_example", result_id = "study-1"))
report_table(r)
report_text(r)
report_text(r, template = "{contrast}: {estimate} {ci}; {p}")

The table retains analytical precision in its original columns. Display values have separate _display columns; p_selected and p_selection identify the chosen stored p-value. report_metadata() returns provenance, population and complete-family adjustment metadata. p = "adjusted" errors when adjusted values are absent. Filter by rows only after adjustment has been performed on the full declared family in infercalcR.

A tiny p-value or stored zero displays a threshold, never p = 0. Missing and unresolved results cannot become ns. Full text retains the supplied estimand, contrast, interval policy, confidence level, sample size and status. It makes no clinical or causal interpretation. The same formatters supply tables, text and plot labels. Decimal-mark changes affect presentation only.

Descriptive summaries

d <- data.frame(outcome = c(1, 2, NA, 4), group = c("A", "A", "B", "B"))
report_descriptive(d, group = "group", units = c(outcome = "mm"))

The raw-data route delegates to infercalcR::describe_data() and performs no hypothesis test. Ordered factors remain categorical. Output includes group and variable denominators, missing counts, labels and units. To add already computed inference, supply inference, an explicit mapping data.frame with variable_id, result_id, row_id, and an inference_population label. At most one inference row per variable is supported. Descriptive and inferential populations remain separately labeled.

ggplot annotations

if (requireNamespace("ggplot2", quietly = TRUE)) {
  d <- data.frame(group = rep(c("A", "B"), each = 3), value = c(1, 3, 4, 2, 5, 6))
  p <- ggplot2::ggplot(d, ggplot2::aes(group, value)) + ggplot2::geom_point()
  positions <- data.frame(row_id = "A-B", xmin = 1, xmax = 2, y_position = 7)
  p + stat_inference(r, positions, label = "estimate_ci_p")
}

Positions must match selected stable row IDs exactly. Named group1/group2 endpoints require groups in the plotted factor-level order; changing visual order does not reverse the scientific contrast. Numeric endpoints support explicit dodge positions. Omnibus annotations use x, y_position and type = "text". Nonsignificant rows are visible by default.

All coordinates and offsets are in original data units. A y_position of 100 maps to 2 under scale_y_log10() once. Cartesian plots and coord_flip() are supported. For horizontal labels use text_hjust = -0.1, text_vjust = 0.5 and choose adequate scale expansion. annotate_inference(plot, ...) checks an existing coordinate system; later-added coordinates cannot be guarded. Arbitrary nonlinear coordinates, automatic placement and automatic dodge/free-scale inference are outside scope.

Facet-specific results require facet_vars, with identical nonmissing keys in stored result rows and positions. Missing declared keys error instead of broadcasting. A list of layers cannot infer undeclared subgroup meaning or validate arbitrary facets added later; maintain this explicit mapping contract.

Verification

All new tests are ordinary tests/*.R scripts against installed packages. They cover precision, interval/p-value semantics, no-computation guards, explicit populations/joins, and actual ggplot builds and drawing. INFER_SUITE_FULL=true requires ggplot2; its absence fails that lane. Minimal-library runs test explicit missing feature errors and label unexecuted integrations as SKIP. Skips do not establish backend support. Set INFER_SUITE_PLOT_DIR to retain plot artifacts during verification.

Acknowledgments and sources

infereportR is part of an inference suite with infercalcR and inferguidR. The suite builds on the work of others. We gratefully acknowledge that work here and cite it, so that every method can be traced to its source.

DescrTab2, Institute of Medical Biometry, Heidelberg University

The suite is deeply inspired by DescrTab2 [1], the R package for publication-quality descriptive statistics tables developed at the Institute of Medical Biometry (IMBI), Heidelberg University, by Jan Meis, Lukas Baumann, Maximilian Pilz and Lukas Sauer, with contributions from Lorenz Uhlmann and Csilla van Lunteren. Its documented test-choice tree, its validation statement and its practice of computing each test with an established implementation (R’s stats package, exact2x2, DescTools and nlme) are the model for how the suite chooses, computes and reports statistical tests. DescrTab2 was archived on CRAN on 18 October 2025; its source code remains available on GitHub. We thank its authors and IMBI Heidelberg for making their work openly available.

Methodenberatung, University of Zurich

The methods-consulting pages of the University of Zurich [2] inspired the guidance in this suite: their decision tree and step-by-step decision assistant for choosing a statistical method, and their worked examples and explanations of each method.

G*Power

The power and sample-size procedures of inferguidR follow the test inventory of G*Power 3.1 [3, 4], and the distribution calculator of infercalcR follows the G*Power 3.1.9.7 calculator. Their results are compared with values recorded from G*Power 3.1.9.7. G*Power is neither distributed with nor called by these packages.

Software

infereportR is written in R [5] and imports infercalcR [6]. Plot annotations use the optional ggplot2 [7]. Use citation("infereportR") for this package and citation() or citation("<package>") for R and the packages you used.

References

  1. Meis J, Baumann L, Pilz M, Sauer L (2022). DescrTab2: Publication Quality Descriptive Statistics Tables. R package version 2.1.16. https://doi.org/10.32614/CRAN.package.DescrTab2. Source code, including the development version 2.1.26: https://github.com/imbi-heidelberg/DescrTab2.
  2. Universität Zürich, Methodenberatung. Datenanalyse mit SPSS: decision tree (Entscheidbaum), decision assistant (Entscheidassistent) and method pages with examples and explanations. https://www.methodenberatung.uzh.ch/de/datenanalyse_spss.html. Accessed 3 October 2026.
  3. Faul F, Erdfelder E, Lang A-G, Buchner A (2007). G*Power 3: A flexible statistical power analysis program for the social, behavioral, and biomedical sciences. Behavior Research Methods, 39(2), 175-191. https://doi.org/10.3758/BF03193146.
  4. Faul F, Erdfelder E, Buchner A, Lang A-G (2009). Statistical power analyses using G*Power 3.1: Tests for correlation and regression analyses. Behavior Research Methods, 41(4), 1149-1160. https://doi.org/10.3758/BRM.41.4.1149.
  5. R Core Team. R: A Language and Environment for Statistical Computing. R Foundation for Statistical Computing, Vienna, Austria. https://www.R-project.org/.
  6. Heller R. infercalcR: Statistical Inference and Diagnostic Calculations. R package. https://github.com/CTTIR/infercalcR.
  7. Wickham H (2016). ggplot2: Elegant Graphics for Data Analysis. Springer, New York. https://doi.org/10.1007/978-3-319-24277-4.