Changelog
Source:NEWS.md
summata 0.13.0 (2026-10-18)
- Speed up
desctable(), which now computes rank-test p-values from a single sort and derives the grouping structure once per table - Pass the arguments in
...ofdesctable()(e.g.,var.equal = TRUE) to the tests that accept them, with a warning for arguments no test accepts; exclude missing and empty categories from categorical tests, falling back to a Monte Carlo p-value when Fisher’s exact test exceeds its workspace - Fix categorical totals, median survival intervals at nondefault confidence levels, and the formatting of values of 1,000 or more in
desctable(), and show the second level of binary variables in condensed tables - Compute the Gehan-Breslow, Tarone-Ware, and Peto-Peto tests that
survtable(test_type = )names, honorp_digits, list groups in order of first appearance asdesctable()does, and match survival time quantiles to their groups when a factor level is empty - Show logical predictors by level, with
FALSEas the reference, in regression tables and forest plots - Accept non-syntactic variable names (e.g.,
"tumor stage"), with or without backticks, infit(),uniscreen(),multifit(),fullfit(), andsurvtable(), and read factor levels and variable names that contain a colon correctly - Fix the matching, counts, and labels of interaction terms whose variables have non-syntactic, overlapping, or logical names
- Order the variables of the tables of models passed to
fit(model = )andm2dt()as the model formula does, and describe mixed models as univariable or multivariable from their fixed-effect terms - Count the events of Cox models from the event argument of
Surv(), coded asSurv()codes it; counts were wrong for status coded 1 and 2, counting-process responses,clogit()models, and events written as expressions - Omit aliased coefficients from forest plots and Cox regression tables, show a factor whose first level is empty against its effective reference level, and drop empty factor levels before fitting Cox models
- Compute forest plot intervals as the regression tables do, following
summata.conf_method, at the requestedconf_levelinuniforest(), and with the t quantile for linear models - Fix forest plot interaction rows under
indent_groupsandcondense_table,coxforest()intervals and interactions forcoxmemodels, and the fixed-effect terms of mixed models (e.g.,log(age)) inglmforest()andlmforest(); draw forest plots whenknitris not installed - Report only the predictor’s coefficients in
multifit(), with observations rather than events as n for Cox models and the given order of outcomes and levels undercolumns = "both"; fit Cox models toSurv()outcomes, asfit()does; draw the table’s estimates inmultiforest() - Name the predictor or outcome of a failed fit in
uniscreen()andmultifit(), and use one core when the number of cores cannot be determined - Compare linear mixed models in
compfit()on maximum likelihood fits, include the Brier score in the composite score of logistic models, score the Cox global p-value independently of the number format, accept candidates with aliased coefficients, and skip profile intervals that are not displayed; use model-level N and Events incompfit()and thefit()print method - Bold significant p-values in exported tables under every number format, and keep the p-values of factor levels in indented and condensed exports
- Compute the c-statistic without
pROCand name GLM families withoutstringr; both are removed fromSuggests - Documentation and testing suite revisions
summata 0.12.0 (2026-07-31)
CRAN release: 2026-08-21
- Fix n/Events counts to report complete cases across all functions, so group sizes sum to the model n; empty factor levels now report zero, and
multifit()adjusted columns matchfullfit()(STROBE item 12) - Report the analyzed sample and events in
print()methods and forest plot footers, with counts available via theanalysis_countsattribute - Import
Surv(),strata(),cluster(), andcoxph()fromsurvivalto fixclogitandcoxmefailures when the package is not attached by the user - Fix coefficient parsing for variable names that share a prefix or contain regular expression metacharacters
- Fix
uniforest()to draw factor levels in their established order rather than alphabetically whenindent_groups = TRUE - Fix counts of 100,000 or greater displaying in exponential notation, and centralize count formatting in a vectorized
format_count() - Carry variable labels from the regression functions through to the forest plot functions, so labels supplied once apply to both table and plot
- Add
forestsave()for saving forest plots at their recommended dimensions, with format-appropriate graphics devices and optional font embedding;rec_dimsnow records its units - Add
recdims()function for directly retrieving the figure dimensions recommended for a forest plot - Rename
autotable()totablesave(), pairing it withforestsave()and distinguishing it fromautoforest(), which detects model class rather than file format;autotable()is retained as a deprecated alias - Add
quietargument totablesave()and thetable2*()functions, and return the file path invisibly fromtable2pdf(),table2html(), andtable2tex() - Add
table_dataattribute to the forest plot functions for access to the values drawn in the figure - Add
compfit()warning when candidate models are fitted to different numbers of observations - Suppress spurious diagnostics: singular-fit messages from mixed-effects screening, the deprecated
lme4::findbars()call, theMuMIn::r.squaredGLMM()null model advisory, and the Hosmer-Lemeshow test where fitted values are too few to bin - Declare
parallel,tools, andutilsin Imports, and addSystemRequirementsfor the optional external tools - Documentation and testing suite revisions
summata 0.11.5 (2026-05-06)
CRAN release: 2026-05-07
- Explicitly define
%||%operator for backward compatibility - Move main documentation to Codefloe Pages
- Minor documentation edits
summata 0.11.4 (2026-03-14)
CRAN release: 2026-03-20
- Use profile likelihood CIs for GLM/negbin and exact t-distribution CIs for linear models, replacing Wald approximation
- Add
conf_methodparameter ("profile"/"wald") tofit(),uniscreen(),fullfit(),multifit(), andm2dt(), with global optionsummata.conf_method - Report complete-case n/Events in
fullfit()multivariable rows (STROBE item 12) - Cache profile likelihood CIs from
fit()for reuse in forest plot functions - Resolve
family = "Gamma"string toGamma(link = "log")for interpretable multiplicative effects - Fix
survival::strata()namespace in conditional logistic regression test - Update benchmarks feature comparison articles
summata 0.11.3 (2026-03-03)
CRAN release: 2026-03-08
- CRAN initial release re-submission
- Fix
table2pdf()to specify output directory for files - Minor WORDLIST changes
summata 0.11.2 (2026-03-02)
- CRAN initial release re-submission
- Minimal executable examples added to all exported functions, with lengthier demonstrations wrapped in
\donttest{} - Modify file-writing examples in documentation headers to write to
tempdir()
summata 0.11.1 (2026-02-22)
- CRAN initial release re-submission
- Documentation LaTeX fixes
- Broken link fixes
summata 0.10.8 (2026-02-09)
- Add compatibility with US/EU locales and different big/small number marks
- Add quiet vs. verbose settings to regression functions for warnings
- Documentation and vignette updates
summata 0.10.6 (2026-01-20)
- Fix “n” and “Events” counts in regression summary tables for extended GLM families
- Improve clogit example in “Regression Modeling” vignette
- Fix errors in
condense_tablelogic in table export and forest plot functions - Fix
variable_paddingin table export functions, ensure consistent behavior withzebra_stripes - Lighten forest plot colors
- Change n/N labeling for consistency
- Expanded documentation examples for interaction effects, mixed effects, and extended GLM families
- Diversify use of
randomparameter in regression models - Documentation cleaning
summata 0.10.5 (2026-01-18)
- Add count outcomes (
ae_countandfu_count) toclintrialmock dataset - Fix color coding in forest plots
- Fix
glmforest()to correctly extract values fromMASS::glm.nb() - Fix regression functions to respect level order in categorical functions
- Fix bug in
uniscreen()where specifiedp_thresholdvalues were not generating screened outputs - Fixes to print outputs in regression functions
- Multiple
multifit()revisions, including improved “n” and “Events” column handling and interaction effect formatting
summata 0.10.2 (2026-01-12)
- Add support for various GLM families
- Add
MASSdependency forMASS::glm.nb() - Testing suite bugfixes
- Update documentation
summata 0.10.1 (2026-01-05)
- Streamline intelligent
condense_tablestring finding - Update documentation
summata 0.10.0 (2026-01-04)
- Add automatic font detection to forest plot functions
- Fix formatting for negative coefficients in forest plots
- Fix “negative zero” formatting issues
- Add safeguards to avoid multiple model types in
multifit()calls - Add intelligent handling of binary categorical variables for
condense_table
summata 0.9.4 (2026-01-02)
- Add
show_logsparameter totable2tex() - Consistent Unicode formatting for files
- Increased R version requirement to >= 4.2.0 for better Unicode compatibility
- Add
survtable()function with utilities - Minor optimizations and function cleanup, with notation standardization
summata 0.9.2 (2025-12-27)
- Expand “affirmative level” string criteria for binary categorical variables
- Add option to remove “Predictors” column in
multifit()andmultiforest() - Update documentation
summata 0.9.1 (2025-12-27)
- Ensure user-modifiable
p_digitsandconf_levelparameters across all regression and forest plot functions - Add parameter for toggling the footer in forest plot functions
- Update
uniscreen()to accept mixed-effect models - Update
autoforest()to accept lmer and glmer objects
summata 0.9.0 (2025-12-27)
- Add multivariate analysis support (
multifit()andmultiforest()) - New vignette: “Multivariate Analysis”
- Modify core forest plot functions (
lmforest(),glmforest(), andcoxforest()) to accept Summata objects or models - Add univariable screening forest plot (
uniforest()) - Rename
uscreen()touniscreen()for consistency - Update
autoforest()to handle new forest plot functions
summata 0.8.3 (2025-12-24)
- Add optimizations to descriptive statistics workflows
- Add
p_per_statparameter todesctable() - Change
add_reference_rowsparameter to justreference_rowsin regression functions
summata 0.8.0 (2025-12-20)
- Add pkgdown website
- Add testing suite
- Add NEWS
- Add README
- Add vignettes
- Add citation function
summata 0.7.14 (2025-12-20)
- Add
autotable()function
summata 0.7.13 (2025-12-19)
- Rename
digits_pparameter top_digitsand add to forest plot functions - Fix
effect_labelparameter in forest plot functions - Update/clean comments and documentation headers
summata 0.7.12 (2025-12-15)
- Add
condense_quantitativeparameter to table export functions - Modify
fit()andglmforest()to correctly display Poisson model statistics - Fix LaTeX/PDF export bugs
summata 0.7.11 (2025-12-13)
- Update R version dependency (>= 4.4.0) for built-in null coalescing operator
summata 0.7.10 (2025-12-08)
- Update MuMIn package dependency and QC statistics in lmer models
- Ensure that lme4 and coxme models work with
compfit()
summata 0.7.9 (2025-12-06)
- Fix “n” and “Events” columns for interaction effects
- Fix lmerMod compatibility with
fit()andm2dt() - Fix lmer compatibility for
lmforest() - Get interaction effects to show on forest plots
summata 0.7.8 (2025-11-24)
- Add GLM and Cox mixed-effect compatibility with
m2dt()andfit() - Add GLM and Cox mixed-effect compatibility with
glmforest()andcoxforest()
summata 0.7.7 (2025-11-20)
- Add data requirement to
m2dt()to allow for accurate per-group “n” and “events” columns for all models - Multiple
R CMD checkfixes
summata 0.7.3 (2025-11-03)
- Add coefficient table combination function for
compfit() - Global and imported variable fixes
summata 0.6.0 (2025-11-02)
- Add
flextabletable export functions with helpers - Documentation updates for existing table export functions
summata 0.5.8 (2025-10-23)
- Update forest plot functions: additive columns, zebra stripes, and units conversion
summata 0.5.5 (2025-10-11)
- Add
lmforest()andautoforest()functions
summata 0.5.3 (2025-10-10)
- Fix
desctable()ordering to follow variable levels - Add “events” columns in
glmforest()andcoxforest() - Fix outcome factor handling in
glmforest()andcoxforest() - Implement exponentiation options for “fit” functions
summata 0.5.2 (2025-10-09)
- Fix “n” and “events” columns in
uscreen(),fit(), and*summata*() - Add hyphen space fillers for “p-value”, “Uni p”, and “Multi p” columns
summata 0.5.1 (2025-10-08)
- Add N rows to
desctable() - Fix errors with “rolling” p-values in
desctable() - Fix
m2dt()edge cases
summata 0.5.0 (2025-10-06)
- Add export functions
table2pdf(),table2tex(), andtable2html()
summata 0.4.1 (2025-10-06)
- Added
compfit()function - Reorganized helper functions
- Function name cleanup
summata 0.4.0 (2025-10-05)
- Replacement of
mmodel()function withfit() - Standardization of output formats
summata 0.3.1 (2025-10-02)
- Fixes for unknown/missing rows, reporting of ranges, and non-grouped tables in
desctable()
summata 0.3.0 (2025-09-30)
- Edits to
desctable()andfit() - Addition of “raw data” outputs
- Expand internal documentation
summata 0.2.0 (2025-09-26)
- Add
desctable()function - Add
fit()function