File: modelLookup.Rd

package info (click to toggle)
r-cran-caret 7.0-1%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,036 kB
  • sloc: ansic: 210; sh: 10; makefile: 2
file content (83 lines) | stat: -rw-r--r-- 2,558 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/modelLookup.R
\name{modelLookup}
\alias{modelLookup}
\alias{getModelInfo}
\alias{checkInstall}
\title{Tools for Models Available in \code{train}}
\usage{
modelLookup(model = NULL)

checkInstall(pkg)

getModelInfo(model = NULL, regex = TRUE, ...)
}
\arguments{
\item{model}{a character string associated with the \code{method} argument
of \code{\link{train}}. If no value is passed, all models are returned. For
\code{getModelInfo}, regular expressions can be used.}

\item{pkg}{a character string of package names.}

\item{regex}{a logical: should a regular expressions be used? If
\code{FALSE}, a simple match is conducted against the whole name of the
model.}

\item{...}{options to pass to \code{\link[base]{grepl}}}
}
\value{
\code{modelLookup} produces a data frame with columns \item{model
}{a character string for the model code} \item{parameter }{the tuning
parameter name} \item{label }{a tuning parameter label (used in plots)}
\item{forReg }{a logical; can the model be used for regression?}
\item{forClass }{a logical; can the model be used for classification?}
\item{probModel }{a logical; does the model produce class probabilities?}

\code{getModelInfo} returns a list containing one or more lists of the
standard model information.

\code{checkInstall} returns not value.
}
\description{
These function show information about models and packages that are
accessible via \code{\link{train}}
}
\details{
\code{modelLookup} is good for getting information related to the tuning
parameters for a model. \code{getModelInfo} will return all the functions
and metadata associated with a model. Both of these functions will only
search within the models bundled in this package.

\code{checkInstall} will check to see if packages are installed. If they are
not and the session is interactive, an option is given to install the
packages using \code{\link[utils]{install.packages}} using that functions
default arguments (the missing packages are listed if you would like to
install them with other options). If the session is not interactive, an
error is thrown.
}
\note{
The column \code{seq} is no longer included in the output of
\code{modelLookup}.
}
\examples{

\dontrun{
modelLookup()
modelLookup("gbm")

getModelInfo("pls")
getModelInfo("^pls")
getModelInfo("pls", regex = FALSE)

checkInstall(getModelInfo("pls")$library)
}

}
\seealso{
\code{\link{train}}, \code{\link[utils]{install.packages}},
\code{\link[base]{grepl}}
}
\author{
Max Kuhn
}
\keyword{utilities}