Skip to contents

Trigger the execution of the tplyr_table

Source: R/build.R
build.Rd

The functions used to assemble a tplyr_table object and each of the layers do not trigger the processing of any data. Rather, a lazy execution style is used to allow you to construct your table and then explicitly state when the data processing should happen. build triggers this event.

Usage

build(x, metadata = FALSE)

Arguments

x

A tplyr_table object

metadata

Trigger to build metadata. Defaults to FALSE

Value

An executed tplyr_table

Details

When the build command is executed, all of the data processing commences. Any pre-processing necessary within the table environment takes place first. Next, each of the layers begins executing. Once the layers complete executing, the output of each layer is stacked into the resulting data frame.

Once this process is complete, any post-processing necessary within the table environment takes place, and the final output can be delivered. Metadata and traceability information are kept within each of the layer environments, which allows an investigation into the source of the resulting datapoints. For example, numeric data from any summaries performed is maintained and accessible within a layer using get_numeric_data.

The `metadata` option of build will trigger the construction of traceability metadata for the constructed data frame. Essentially, for every "result" that Tplyr produces, Tplyr can also generate the steps necessary to obtain the source data which produced that result from the input. For more information, see vignette("metadata").

See also

tplyr_table, tplyr_layer, add_layer, add_layers, layer_constructors

Examples

# Load in Pipe
library(magrittr)

tplyr_table(iris, Species) %>%
  add_layer(
    group_desc(Sepal.Length, by = "Sepal Length")
  ) %>%
  add_layer(
    group_desc(Sepal.Width, by = "Sepal Width")
  ) %>%
  build()
#> # A tibble: 12 × 8
#>    row_label1   row_label2 var1_setosa   var1_…¹ var1_…² ord_l…³ ord_l…⁴ ord_l…⁵
#>    <chr>        <chr>      <chr>         <chr>   <chr>     <int>   <int>   <int>
#>  1 Sepal Length n          " 50"         " 50"   " 50"         1       1       1
#>  2 Sepal Length Mean (SD)  "5.01 (0.352… "5.94 … "6.59 …       1       1       2
#>  3 Sepal Length Median     "5.00"        "5.90"  "6.50"        1       1       3
#>  4 Sepal Length Q1, Q3     "4.80, 5.20"  "5.60,… "6.23,…       1       1       4
#>  5 Sepal Length Min, Max   "4.3, 5.8"    "4.9, … "4.9, …       1       1       5
#>  6 Sepal Length Missing    "  0"         "  0"   "  0"         1       1       6
#>  7 Sepal Width  n          " 50"         " 50"   " 50"         2       1       1
#>  8 Sepal Width  Mean (SD)  "3.43 (0.379… "2.77 … "2.97 …       2       1       2
#>  9 Sepal Width  Median     "3.40"        "2.80"  "3.00"        2       1       3
#> 10 Sepal Width  Q1, Q3     "3.20, 3.68"  "2.52,… "2.80,…       2       1       4
#> 11 Sepal Width  Min, Max   "2.3, 4.4"    "2.0, … "2.2, …       2       1       5
#> 12 Sepal Width  Missing    "  0"         "  0"   "  0"         2       1       6
#> # … with abbreviated variable names ¹​var1_versicolor, ²​var1_virginica,
#> #   ³​ord_layer_index, ⁴​ord_layer_1, ⁵​ord_layer_2