Package: gtregression 1.1.0

Rubeshkumar Polani

gtregression: Tools for Creating Publication-Ready Regression Tables

Simplifies regression modeling in R by integrating multiple modeling and summarization tools into a cohesive, user-friendly interface. Designed to be accessible for researchers, particularly those in Low- and Middle-Income Countries (LMIC). Built upon widely accepted statistical methods, including logistic regression (Hosmer et al. 2013, ISBN:9781118548429), log-binomial regression (Spiegelman and Hertzmark 2005 <doi:10.1093/aje/kwi188>), Firth penalized logistic regression (Firth 1993 <doi:10.1093/biomet/80.1.27>), Poisson and robust Poisson regression (Zou 2004 <doi:10.1093/aje/kwh090>), negative binomial regression (Hilbe 2011, ISBN:9780521179515), Cox proportional hazards regression, parametric survival regression, causal mediation analysis, and linear regression (Kutner et al. 2005, ISBN:9780071122214). Leverages multiple dependencies to ensure high-quality output and generate reproducible, publication-ready tables in alignment with best practices in epidemiology and applied statistics.

Authors:Rubeshkumar Polani [aut, cre], Salin K Eliyas [aut], Manikandanesan Sakthivel [aut], Mogan Kaviprawin [aut], Yuvaraj Krishnamoorthy [aut], Marie Gilbert Majella [aut]

gtregression_1.1.0.tar.gz
gtregression_1.1.0.zip(r-4.7-any)gtregression_1.1.0.zip(r-4.6-any)gtregression_1.1.0.zip(r-4.5-any)
gtregression_1.1.0.tgz(r-4.6-any)gtregression_1.1.0.tgz(r-4.5-any)
gtregression_1.1.0.tar.gz(r-4.7-any)gtregression_1.1.0.tar.gz(r-4.6-any)
gtregression_1.1.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html
DESCRIPTION |NEWS
card.svg |card.png
gtregression/json (API)

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

Bug tracker:https://github.com/thinkdenominator/gtregression/issues

Pkgdown/docs site:https://gtregression.thinkdenominator.com

Datasets:

On CRAN:

Conda:

6.27 score 31 scripts 246 downloads 39 exports 135 dependencies

Last updated from:cba5a5e461. Checks:1 ERROR, 8 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develERROR303
source / vignettesOK300
linux-releaseOK363
macos-releaseOK223
macos-oldrelOK219
windows-develOK305
windows-releaseOK308
windows-oldrelOK295
wasm-releaseOK184

Exports:check_collinearitycheck_convergencecheck_phcompare_modelscox_regdescriptive_tabledissectforest_dfforest_reggtregression_appidentify_confounderinteraction_modelskm_plotkm_risk_tablelogrank_testmediation_analysismerge_tablesmodify_tablemulti_regplot_mediationplot_model_fitplot_regplot_reg_combineplot_surv_fitrmst_tablesave_docxsave_forestsave_plotsave_tableselect_modelsstratified_multi_regstratified_uni_regsurv_model_comparesurv_predictsurv_regsurvival_probsurvival_quantilessurvival_summaryuni_reg

Dependencies:askpassbackportsbase64encbcabootbigDbitbit64bitopsbootbroombroom.helpersbslibcachemcardsclicliprcodetoolscommonmarkcpp11crayoncurldata.tabledigestdplyrevaluatefarverfastmapflextablefontawesomefontBitstreamVerafontLiberationfontquiverforcatsforeachforestploterformula.toolsfsgdtoolsgenericsggplot2glmnetgluegridExtragtgtablehavenhighrhmshtmltoolshtmlwidgetsisobanditeratorsjomojquerylibjsonlitejuicyjuiceknitrlabelinglabelledlatticelifecyclelitedownlme4lmtestlogistfmagrittrmarkdownMASSMatrixmemoisemgcvmicemimeminqamitmlnlmenloptrnnetnumDerivofficeropenssloperator.toolsordinalpanpatchworkpillarpkgconfigprettyunitsprogresspurrrR6raggrappdirsrbibutilsRColorBrewerRcppRcppEigenRdpackreactablereactRreadrreformulasrisksrlangrmarkdownrpartS7sandwichsassscalesshapestringistringrsurvivalsyssystemfontstextshapingtibbletidyrtidyselecttinytextzdbucminfutf8uuidV8vctrsviridisLitevroomwithrxfunxml2yamlzipzoo

Causal Mediation Analysis
Example Question | Logistic Outcome | Path Diagram | Quoted Names | Linear Outcome | How To Report | What Not To Claim

Last update: 2026-08-20
Started: 2026-07-29

Confounding and Interaction
Which Function Should I Use? | How the Interaction Tests Differ | Identify Confounders | Mantel-Haenszel Estimate | Test Interaction | Survival Confounding and Interaction | Causal Mediation | Overlap and Difference | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Customize, Merge, and Export
Customize Labels | Customisation Options At A Glance | Merge Tables | Keep Binary Rows Consistent | Save Outputs | Word Reports | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Descriptive Tables
Column Percentages | Row Percentages | Summary Choices | Output Format | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Diagnostics and Model Selection
Convergence Screening | Collinearity Screening | Model Fit Plots | Proportional Hazards Screening | Stepwise Model Selection | Build Candidates in the App | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Function Options
Function Options at a Glance | Common Choices | Describe and Inspect Data | descriptive_table() | dissect() | Regression Tables | uni_reg() | multi_reg() | stratified_uni_reg() | stratified_multi_reg() | Cox and Parametric Survival Regression | cox_reg() | surv_reg() | Kaplan-Meier and Survival Summaries | km_plot() | survival_summary() | survival_quantiles() | survival_prob() and km_risk_table() | logrank_test() | rmst_table() | Parametric survival helpers | Regression Plots and Model Fit | plot_reg() | plot_reg_combine() | plot_model_fit() | Forest Tables and Forest Plots | forest_df() | forest_reg() | save_forest() | Diagnostics, Selection, and Model Comparison | check_convergence() | check_collinearity() | select_models() | compare_models() | Compare Models in the gtregression App | Confounding, Interaction, and Mediation | identify_confounder() | interaction_models() | mediation_analysis() | plot_mediation() | Merge, Modify, and Export | merge_tables() | modify_table() | Save helpers | Practical Defaults

Last update: 2026-08-20
Started: 2026-08-07

Regression Tables
Univariable Models | Multivariable Models | Exposure-Specific Adjusted Models | Optional Model Statistics | Other Effect Measures | Cox Survival Models | Parametric Survival Models | Continuous Outcomes | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Start Here: Model to Manuscript
gtregression | What You Can Make | What Powers the Package | Install | Prepare Example Data | Five-Minute Workflow | Describe | Model | Visualise | Merge and Polish | Where To Go Next

Last update: 2026-08-20
Started: 2025-05-25

Using the gtregression App
gtregression App Manual | Launch the App | Close the App Safely | App Dependencies | Recommended Workflow | Core and Additional Options | Quick-Start Templates | Workflow Guide | Live Analysis Status and Preflight Checks | Select and Clear Variable Buttons | Data Tab | Data Prep Tab | Descriptive Tab | Binary Variables | Numeric Statistic Overrides | Regression Tab | Reference Categories | Model Statistics | Stratified Regression | Survival Tab | Kaplan-Meier Plots | Visualise & Export Tab | Model Fit | Export Size Presets | Forest Plot Controls | Download Formats | Session Code | Merge Tables | Regression Plots | Modify Table | Forest Tables | Advanced Tab | Build and Compare Candidate Models | Birth Weight Example | Cox and Parametric Survival Examples | Reading the Comparison | Model Selection and Comparison | Role Checks | Confounding and Interaction | Mediation Tab | Saving Outputs | Troubleshooting | The App Does Not Open | The Browser Preview Looks Cramped | Forest Plot X-Axis Labels Overlap | Forest Plot Columns Feel Too Narrow | Kaplan-Meier Curves Look Almost Flat | Merged Tables Do Not Align as Expected | Chrome or Browser Crashes | Nothing Appears After Clicking a Button | Beginner Case Study: Birth Weight | Best Practice

Last update: 2026-08-20
Started: 2026-08-14

Visualise Regression Results
Kaplan-Meier Curve | Risk Table | Restricted Mean Survival Time | Kaplan-Meier Summary | Survival Quantiles | Survival Probabilities | Log-Rank Test | Parametric Survival Model Comparison | Parametric Survival Fit Plot | Parametric Survival Prediction | One Regression Plot | Adjusted Regression Plot | Compact Binary Predictors | Log Axis and Tick Marks | Compare Crude and Adjusted Effects | Publication-Style Forest Table | Fine-Tune Forest Tables | What To Inspect

Last update: 2026-08-20
Started: 2026-07-22

Stratified Analysis
Describe by Stratum | Univariable by Stratum | Full Multivariable Model by Stratum | Exposure-Specific Adjusted Models by Stratum | Forest Plot by Stratum | What To Inspect

Last update: 2026-08-07
Started: 2026-07-22

Survival Analysis
1. Describe The Cohort | 2. Show Observed Survival | 3. Compare Survival Curves | 4. Fit Cox Regression | 5. Fit Parametric Survival Regression | 6. Predict Survival Probabilities | 7. Visualise And Export Model Results | Survival Workflow Map

Last update: 2026-07-31
Started: 2026-07-27

Readme and manuals

Help Manual

Help pageTopics
Access fields on gtregression objects with `$`$.gtregression
Check collinearity using VIF for fitted modelscheck_collinearity
Check regression model convergencecheck_convergence
Check proportional hazards assumption for Cox modelscheck_ph
Compare Prespecified Regression Modelscompare_models
Cox proportional hazards regressioncox_reg
Birth Weight Datadata_birthwt
Diabetes Mediation Teaching Datasetdata_diabetes_mediation
Endometrial Cancer Histology Grade Datadata_endometrial
Epilepsy Treatment and Seizure Countsdata_epilepsy
Student Absenteeism in Rural Schoolsdata_gt_quin
Infertility Matched Case-Control Studydata_infertility
Lung Cancer Trial Datadata_lungcancer
Synthetic Diabetes Datasetdata_SynthDiabetes
Descriptive Summary Table (no gtsummary) using gt/flextabledescriptive_table
Dissect a dataset before regressiondissect
Build a compatible data frame for forest plotsforest_df
Draw a forest table from regression outputsforest_reg
Launch the gtregression appgtregression_app
Identify confounders and effect modifiersidentify_confounder
Compare Models With and Without an Interaction Terminteraction_models
Kaplan-Meier survival plotkm_plot
Kaplan-Meier risk tablekm_risk_table
Log-rank test for Kaplan-Meier survival curveslogrank_test
Causal mediation analysismediation_analysis
Merge gtregression tables and preserve structure and notesmerge_tables
Modify Regression/Descriptive Tables (labels, headers, caption, notes)modify_table
Multivariable regressionmulti_reg
Plot mediation pathsplot_mediation
Plot model-fit diagnosticsplot_model_fit
Plot regression estimatesplot_reg
Side-by-side forest plots: univariate vs multivariableplot_reg_combine
Plot observed and fitted parametric survival curvesplot_surv_fit
Print gtregression objects (unified)print.gtregression
Restricted mean survival time tablermst_table
Save multiple tables and plots to a Word documentsave_docx
Save a forest_reg() outputsave_forest
Save a single plotsave_plot
Save a single regression or summary tablesave_table
Stepwise model selection with fit metricsselect_models
Stratified multivariable regressionstratified_multi_reg
Stratified univariable regressionstratified_uni_reg
Compare parametric survival model distributionssurv_model_compare
Predict survival probabilities from a parametric survival modelsurv_predict
Parametric survival regressionsurv_reg
Kaplan-Meier survival probability tablesurvival_prob
Kaplan-Meier survival quantile tablesurvival_quantiles
Kaplan-Meier survival summary tablesurvival_summary
Univariate regressionuni_reg