The tplyr_table object is the main container upon which a Tplyr table is constructed. Tplyr tables are made up of one or more layers. Each layer contains an instruction for a summary to be performed. The tplyr_table object contains those layers, and the general data, metadata, and logic necessary.

tplyr_table(target, treat_var, where = TRUE, cols = vars())



Dataset upon which summaries will be performed


Variable containing treatment group assignments. Supply unquoted.


A general subset to be applied to all layers. Supply as programming logic (i.e. x < 5 & y == 10)


A grouping variable to summarize data by column (in addition to treat_var). Provide multiple column variables by using vars


A tplyr_table object


When a tplyr_table is created, it will contain the following bindings:

  • target - The dataset upon which summaries will be performed

  • pop_data - The data containing population information. This defaults to the target dataset

  • cols - A categorical variable to present summaries grouped by column (in addition to treat_var)

  • table_where - The where parameter provided, used to subset the target data

  • treat_var - Variable used to distinguish treatment groups.

  • header_n - Default header N values based on treat_var

  • pop_treat_var - The treatment variable for pop_data (if different)

  • layers - The container for individual layers of a tplyr_table

  • treat_grps - Additional treatment groups to be added to the summary (i.e. Total)

tplyr_table allows you a basic interface to instantiate the object. Modifier functions are available to change individual parameters catered to your analysis. For example, to add a total group, you can use the add_total_group.

In future releases, we will provide vigenttes to fully demonstrate these capabilities.


tab <- tplyr_table(iris, Species, where = Sepal.Length < 5.8)