Package: summata 0.13.0

summata: Publication-Ready Summary Tables and Forest Plots

A comprehensive framework for descriptive statistics and regression analysis that produces publication-ready tables and forest plots. Provides a unified interface from descriptive statistics through multivariable modeling, with support for linear models, generalized linear models, Cox proportional hazards, and mixed-effects models. Also includes univariable screening, multivariate regression, model comparison, and export to multiple formats including PDF, DOCX, PPTX, 'LaTeX', HTML, and RTF. Built on 'data.table' for computational efficiency.

Authors:Paul Hsin-ti McClelland [aut, cre, cph]

summata_0.13.0.tar.gz
summata_0.13.0.zip(r-4.7-any)summata_0.13.0.zip(r-4.6-any)summata_0.13.0.zip(r-4.5-any)
summata_0.13.0.tgz(r-4.6-any)summata_0.13.0.tgz(r-4.5-any)
summata_0.13.0.tar.gz(r-4.7-any)summata_0.13.0.tar.gz(r-4.6-any)
summata_0.13.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
summata/json (API)

# Install 'summata' in R:
install.packages('summata', repos = c('https://phmcc.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/phmcc/summata/issues

Datasets:

On CRAN:

Conda:

5.83 score 4 scripts 460 downloads 24 exports 21 dependencies

Last updated from:1e982afd69. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK274
source / vignettesOK367
linux-releaseOK280
macos-releaseOK202
macos-oldrelOK162
windows-develOK233
windows-releaseOK223
windows-oldrelOK245
wasm-releaseOK159

Exports:autoforestautotablecompfitcoxforestdesctablefitforestsavefullfitglmforestlmforestm2dtmultifitmultiforestrecdimssurvtabletable2docxtable2htmltable2pdftable2pptxtable2rtftable2textablesaveuniforestuniscreen

Dependencies:clicpp11data.tablefarverggplot2gluegtableisobandlabelinglatticelifecycleMatrixR6RColorBrewerrlangS7scalessurvivalvctrsviridisLitewithr

Installation and Setup
Package Installation | From Repository | Verification | Dependencies | Required Dependencies | Optional Dependencies | LaTeX Configuration | TinyTeX (Recommended) | Alternative LaTeX Distributions | Required LaTeX Packages | Microsoft Office Export | Export Verification Procedure | Troubleshooting | LaTeX Not Found | Missing LaTeX Packages | Package Installation Failures | Write Permission Errors | System Requirements

Last update: 2026-10-18
Started: 2026-02-16

Forest Plots
Preliminaries | Creating Forest Plots from Model Objects | Example 1: Logistic Regression | Example 2: Linear Regression | Example 3: Cox Regression | Example 4: Automatic Model Detection | Creating Forest Plots from summata Output | Example 5: Direct Extraction from Fit Output | Example 6: Model Attribute from Fit Output | Display Options | Example 7: Indenting Factor Levels | Example 8: Condensing Binary Variables | Example 9: Toggle Zebra Striping | Example 10: Sample Size and Event Columns | Formatting Options | Example 11: Adjusting Numeric Precision | Example 12: Custom Reference Label | Example 13: Custom Effect Measure Label | Example 14: Custom Colors | Example 15: Change Font Sizes | Example 16: Table Width | Saving Forest Plots | Example 17: Recommended Dimensions | Example 18: Multiple Formats | Advanced Customization | Example 19: Combined Options | Example 20: Extensions with ggplot2 | Additional GLM Families | Example 21: Poisson Regression | Example 22: Negative Binomial Regression | Function Parameter Summary | Best Practices | Model Preparation | Visual Design | Publication Preparation | Common Issues | Long Variable Names | Overlapping Text | Missing Labels | Further Reading

Last update: 2026-07-31
Started: 2026-01-12

Advanced Workflows
Preliminaries | Interaction Effects | Example 1: Two-Way Interaction | Example 2: Multiple Interactions | Example 3: Continuous × Categorical Interaction | Example 4: Interaction in fullfit() | Example 5: Testing Interaction Significance | Example 6: Forest Plot with Interactions | Mixed-Effects Models | Example 7: Random Intercepts (Linear Mixed) | Example 8: Random Intercepts (Logistic Mixed) | Example 9: Random Slopes | Example 10: Cox Mixed-Effects Model | Example 11: Forest Plot from Mixed Model | Example 12: Comparing Random-Effects Specifications | Stratification and Clustering | Example 13: Stratified Cox Model | Example 14: Cluster-Robust SEs | Weighted Regression | Example 15: Weighted Analysis | Advanced Univariable Screening Features | Example 16: Univariable Screening with Random Effects | Example 17: Cox Screening with Mixed Effects | Example 18: Forest Plot from Univariable Screening | Advanced Multivariate Regression Features | Example 19: Multi-Outcome with Interactions | Example 20: Multi-Outcome with Mixed Effects | Example 21: Survival Multi-Outcome with Mixed Effects | Complete Workflow Example | Best Practices | Interaction Analysis | Method Selection | Sample Size Considerations | Common Issues | Convergence Problems in Mixed Models | Interpreting Interactions | Forest Plots with Interactions | Further Reading

Last update: 2026-07-28
Started: 2026-01-12

Descriptive Tables
Preliminaries | Summary Statistics and Tests | Basic Usage | Example 1: Grouped Descriptive Table | Example 2: Ungrouped Summary Statistics | Customizing Summary Statistics | Example 3: Continuous Variables | Example 4: Categorical Variables | Example 5: Numeric Precision | Statistical Testing | Example 6: Disabling Automatic Test Selection | Example 7: Specifying Tests Manually | Handling Missing Data | Example 8: Including Missing Values | Example 9: Missing Value Denominators | Example 10: Custom Missing Value Label | Total Column Options | Example 11: Total Column Configuration | Complete Example | Accessing Raw Data | Survival Summary Tables | Exporting Tables | Best Practices | Variable Selection | Statistical Considerations | Formatting Recommendations | Common Issues | Empty Cells in Categorical Variables | Skewed Continuous Variables | Large Tables | Further Reading

Last update: 2026-07-28
Started: 2026-01-12

Model Comparison
Preliminaries | Quality Metrics and the Composite Model Score | Available Metrics | CMS Interpretation | Default CMS Weights by Model Type | Basic Usage | Example 1: Nested Model Comparison | Example 2: Linear Regression Models | Example 3: Cox Regression Models | Example 4: Count Models | Interaction Testing | Example 5: Single Interaction | Example 6: Multiple Interactions | Accessing Detailed Results | Example 7: Coefficient Comparison | Example 8: Fitted Model Objects | Example 9: Recommended Model | Custom CMS Weights | Example 10: Custom Weights | Application Scenarios | Scenario 1: Confounder Assessment | Scenario 2: Variable Selection Validation | Scenario 3: Parsimony Assessment | Exporting Results | Best Practices | When to Compare Models | Interpreting Results | Limitations | Common Issues | Non-Convergence | Differing Sample Sizes | Interpreting Close Scores | Further Reading

Last update: 2026-07-28
Started: 2026-01-12

Multivariate Regression
Preliminaries | Basic Usage | Example 1: Unadjusted Analysis | Example 2: Adjusted Analysis | Example 3: Unadjusted and Adjusted Comparison | Predictor Types | Example 4: Continuous Predictors | Example 5: Multilevel Categorical Predictors | Model Types | Example 6: Cox Regression | Example 7: Linear Regression | Example 8: Mixed-Effects Models | Advanced Features | Example 9: Interaction Terms | Example 10: Filtering by p-value | Example 11: Accessing Model Objects | Forest Plot Visualization | Example 12: Forest Plot for Logistic (Binary) Outcomes | Example 13: Customization Options | Example 14: Forest Plot for Continuous Outcomes | Example 15: Forest Plot for Survival Outcomes | Exporting Results | Tables | Forest Plots | Complete Workflow Example | Parameter Reference | Best Practices | Outcome Selection | Adjustment Strategy | Interpretation | Common Issues | Empty Results | Convergence Warnings | Varying Sample Sizes | Many Factor Levels | Other Considerations | Multivariate Regression vs. Univariable Screening | Categorical Outcomes with More Than Two Levels | Further Reading

Last update: 2026-07-28
Started: 2026-02-16

Regression Modeling
Preliminaries | Supported Model Types | Univariable Screening | Example 1: Binary Outcome Screen (Logistic Regression) | Example 2: Filtering Screen by p-value | Example 3: Continuous Outcome Screen (Linear Regression) | Example 4: Time-to-Event Outcome Screen (Cox Regression) | Example 5: Retaining Model Objects | Multivariable Modeling | Example 6: Logistic Regression | Example 7: Linear Regression | Example 8: Cox Regression | Example 9: Poisson Regression | Example 10: Toggling Reference Rows for Factors | Example 11: Confidence Level | Example 12: Confidence Interval Method | Example 13: Raw Coefficients | Combined Analysis | Example 14: Screening-Based Selection | Example 15: All Predictors | Example 16: Custom Selection | Example 17: Controlling Output Columns | Example 18: Survival Analysis | Extended Model Types | Example 19: Negative Binomial | Example 20: Gamma Regression | Example 21: Random-Intercept Model | Example 22: GLMM for Binary Outcome | Example 23: GLMM for Count Outcome | Example 24: Cox Mixed-Effects Model | Example 25: Quasibinomial for Overdispersed Binary Data | Example 26: Conditional Logistic Model for Matched Data | Exporting Results | Best Practices | Variable Selection Strategy | Choosing the Right Model | Interpreting Results | Sample Size Considerations | Common Issues | Missing Data | Factor Reference Levels | Convergence Issues | Overdispersion Diagnostics | Mixed-Effects Model Convergence | Multinomial and Ordinal Outcomes | Further Reading

Last update: 2026-07-28
Started: 2026-01-12

Survival Tables
Preliminaries | Landmark Survival Estimates | Example 1: Basic Landmark Analysis | Example 2: Remove Median Survival Column | Survival Quantiles | Example 3: Survival Quartiles | Multiple Endpoints | Example 4: PFS and OS Comparison | Output Variations | Example 5: Cumulative Event Rates | Example 6: Including At-Risk Counts | Pairing with Kaplan-Meier Curves | Example 7: Coordinated Figure-Table Output | Exporting Tables | Best Practices | Time Point Selection | Reporting Recommendations | Further Reading

Last update: 2026-07-28
Started: 2026-01-12

Table Export
Preliminaries | CSV / TSV Export | Example 1: CSV Export | Example 2: TSV Export | Example 3: Semicolon-Delimited (European Locale) | PDF Export | Example 4: Basic Export | Example 5: With Caption | Example 6: With Formatting Options | Example 7: Page Layout | Example 8: Custom Margins | Example 9: Fit to Page Width | Example 10: Standalone Table | Microsoft Word Export | Example 11: Basic Export | Example 12: With Caption | Example 13: With Formatting Options | Example 14: Page Layout | Example 15: Dark Header Style | HTML Export | Example 16: Basic Export | Example 17: With Caption | Example 18: With Formatting Options | PowerPoint Export | Example 19: Basic Export | Example 20: With Slide Title | Example 21: With Formatting Options | Example 22: Custom Template | LaTeX Export | Example 23: Basic Export | Example 24: With Caption and Label | Example 25: With Booktabs Styling | RTF Export | Example 26: Basic Export | Example 27: With Formatting Options | Example 28: Page Layout | Saving to Any Format | Common Formatting Parameters | Condensing Options | Format-Specific Parameters | PDF | Word/RTF/PowerPoint | HTML | LaTeX | PowerPoint (additional) | Best Practices | Format Selection | Page Layout Guidelines | Consistent Multi-Format Export | Troubleshooting | PDF Compilation Fails | Table Too Wide | Customizing flextable Output | Further Reading

Last update: 2026-07-28
Started: 2026-01-12