foldControl: Control object for cross-validation folds
Description
Generate an object that controls how to split $n$
observations or groups of observations into $K$ folds
to be used for (repeated) $K$-fold cross-validation.
$K$ should thereby be chosen such that all folds are
of approximately equal size.
Usage
foldControl(K = 5, R = 1,
type = c("random", "consecutive", "interleaved"),
grouping = NULL)
Arguments
K
an integer giving the number of folds into which
the observations should be split (the default is five).
R
an integer giving the number of replications for
repeated $K$-fold cross-validation.
type
a character string specifying the type of
folds to be generated. Possible values are
"random" (the default), "consecutive" or
"interleaved".
grouping
a factor specifying groups of
observations.
Value
An object of class "foldControl" with the
following components:
Kan integer giving the number of folds. A value
of K equal to the number of observations or groups
yields leave-one-out cross-validation.
Ran integer giving the number of replications.
This will be ignored for for leave-one-out
cross-validation and other non-random splits of the
data.
typea character string specifying the type of
folds.
groupingif supplied, a factor specifying groups
of observations. The data will then be split according
to the groups rather than individual observations such
that all observations within a group belong to the same
fold.