README.md

In gerardgimenezadsuar/smartables: Visualize model and descriptive summary tables automatically

smartables R package

Automatically create ready-to-publish summary statistical tables from a data frame.

Let's look at an example of how it works, make sure to have the devtools package installed:

devtools::install_github("gerardgimenezadsuar/smartables")

And don't forget to load the downloaded package smartables:

library(smartables)

This first version contains two functions: create_table and modeltable.

create_table function:

Let's start with an example of how the first one works. We will be using the iris dataset, which is preloaded with R. We want to get both a statistical summary of each variable and also a stratified table by the variable "Species". We can simply type:

create_table(iris, stratify_by = "Species")

Since the function returns a list containing both data frames, you will need to store the output on a variable:

output_df <- create_table(iris, stratify_by = "Species")

To get the overall summary, just access the first item of the list:

output_df[1]

And for the stratified table, access the second one:

output_df[2]

modeltable function:

This function loads the resulting output of either INLA, GLM or HR models, and returns a ready-to-publish summary table from it.

Here's a breif example on how to use it. First, load the results of either of these models in an object.

library(INLA)
data(Seeds)
formula <- r~x1+x2+f(plate,model="iid")
result <- INLA::inla(formula,family="binomial",Ntrials=n,data=Seeds)

Once the result object is created, we can simply use smartables function modeltable:

modeltable(result, "INLA")

The output is the following table:

This is just a particular example with an Integrated Nested Laplace Approximation model (INLA), however, the same procedure should be used to obtain a summary table for either Generalized Linear Models (GLM) or Hazard Ratio models (HR).

Acknowledgements

This package has been created by GRECS (Research group in Statistics, Econometrics and Health) from the University of Girona (https://www.udg.edu/ca/grupsrecerca/GRECS). I thank Prof. Marc Saez and Prof. Maria Antonia Barceló for their support and insightful comments during its development.

gerardgimenezadsuar/smartables documentation built on Dec. 20, 2021, 10:40 a.m.