recipes: prep – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

prep

Train a Data Recipe

Description

For a recipe with at least one preprocessing operation, estimate the required parameters from a training set that can be later applied to other data sets.

Usage

prep(x, ...)

## S3 method for class 'recipe'
prep(
  x,
  training = NULL,
  fresh = FALSE,
  verbose = FALSE,
  retain = TRUE,
  log_changes = FALSE,
  strings_as_factors = TRUE,
  ...
)

Arguments

`x`	an object
`...`	further arguments passed to or from other methods (not currently used).
`training`	A data frame or tibble that will be used to estimate parameters for preprocessing.
`fresh`	A logical indicating whether already trained operation should be re-trained. If `TRUE`, you should pass in a data set to the argument `training`.
`verbose`	A logical that controls whether progress is reported as operations are executed.
`retain`	A logical: should the preprocessed training set be saved into the `template` slot of the recipe after training? This is a good idea if you want to add more steps later but want to avoid re-training the existing steps. Also, it is advisable to use `retain = TRUE` if any steps use the option `skip = FALSE`. Note that this can make the final recipe size large. When `verbose = TRUE`, a message is written with the approximate object size in memory but may be an underestimate since it does not take environments into account.
`log_changes`	A logical for printing a summary for each step regarding which (if any) columns were added or removed during training.
`strings_as_factors`	A logical: should character columns be converted to factors? This affects the preprocessed training set (when `retain = TRUE`) as well as the results of `bake.recipe`.

Details

Given a data set, this function estimates the required quantities and statistics required by any operations.

prep() returns an updated recipe with the estimates.

Note that missing data handling is handled in the steps; there is no global na.rm option at the recipe-level or in prep().

Also, if a recipe has been trained using prep() and then steps are added, prep() will only update the new operations. If fresh = TRUE, all of the operations will be (re)estimated.

As the steps are executed, the training set is updated. For example, if the first step is to center the data and the second is to scale the data, the step for scaling is given the centered data.

Value

A recipe whose step objects have been updated with the required quantities (e.g. parameter estimates, model objects, etc). Also, the term_info object is likely to be modified as the operations are executed.

Author(s)

Max Kuhn

Examples

data(ames, package = "modeldata")

library(dplyr)

ames <- mutate(ames, Sale_Price = log10(Sale_Price))

ames_rec <-
  recipe(
    Sale_Price ~ Longitude + Latitude + Neighborhood + Year_Built + Central_Air,
    data = ames
  ) %>%
  step_other(Neighborhood, threshold = 0.05) %>%
  step_dummy(all_nominal()) %>%
  step_interact(~ starts_with("Central_Air"):Year_Built) %>%
  step_ns(Longitude, Latitude, deg_free = 5)

prep(ames_rec, verbose = TRUE)

prep(ames_rec, log_changes = TRUE)

recipes

Preprocessing Tools to Create Design Matrices

v0.1.16

MIT + file LICENSE

Authors

Max Kuhn [aut, cre], Hadley Wickham [aut], RStudio [cph]

Initial release