Description Usage Arguments Details Value See Also Examples
fit()
and fit_xy()
take a model specification, translate the required
code by substituting arguments, and execute the model fit
routine.
1 2 3 4 5  ## S3 method for class 'model_spec'
fit(object, formula, data, control = control_parsnip(), ...)
## S3 method for class 'model_spec'
fit_xy(object, x, y, control = control_parsnip(), ...)

object 
An object of class 
formula 
An object of class "formula" (or one that can be coerced to that class): a symbolic description of the model to be fitted. 
data 
Optional, depending on the interface (see Details below). A data frame containing all relevant variables (e.g. outcome(s), predictors, case weights, etc). Note: when needed, a named argument should be used. 
control 
A named list with elements 
... 
Not currently used; values passed here will be
ignored. Other options required to fit the model should be
passed using 
x 
A matrix or data frame of predictors. 
y 
A vector, matrix or data frame of outcome data. 
fit()
and fit_xy()
substitute the current arguments in the model
specification into the computational engine's code, checks them
for validity, then fits the model using the data and the
enginespecific code. Different model functions have different
interfaces (e.g. formula or x
/y
) and these functions translate
between the interface used when fit()
or fit_xy()
were invoked and the one
required by the underlying model.
When possible, these functions attempt to avoid making copies of the
data. For example, if the underlying model uses a formula and
fit()
is invoked, the original data are references
when the model is fit. However, if the underlying model uses
something else, such as x
/y
, the formula is evaluated and
the data are converted to the required format. In this case, any
calls in the resulting model objects reference the temporary
objects used to fit the model.
If the model engine has not been set, the model's default engine will be used
(as discussed on each model page). If the verbosity
option of
control_parsnip()
is greater than zero, a warning will be produced.
A model_fit
object that contains several elements:
lvl
: If the outcome is a factor, this contains
the factor levels at the time of model fitting.
spec
: The model specification object
(object
in the call to fit
)
fit
: when the model is executed without error,
this is the model object. Otherwise, it is a tryerror
object with the error message.
preproc
: any objects needed to convert between
a formula and nonformula interface (such as the terms
object)
The return value will also have a class related to the fitted model (e.g.
"_glm"
) before the base class of "model_fit"
.
set_engine()
, control_parsnip()
, model_spec
, model_fit
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22  # Although `glm()` only has a formula interface, different
# methods for specifying the model can be used
library(dplyr)
library(modeldata)
data("lending_club")
lr_mod < logistic_reg()
using_formula <
lr_mod %>%
set_engine("glm") %>%
fit(Class ~ funded_amnt + int_rate, data = lending_club)
using_xy <
lr_mod %>%
set_engine("glm") %>%
fit_xy(x = lending_club[, c("funded_amnt", "int_rate")],
y = lending_club$Class)
using_formula
using_xy

Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.