-
Notifications
You must be signed in to change notification settings - Fork 1
/
genridge-package.Rd
76 lines (63 loc) · 2.88 KB
/
genridge-package.Rd
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
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/genridge-package.R
\name{genridge-package}
\alias{genridge-package}
\alias{genridge}
\alias{_PACKAGE}
\title{Generalized ridge trace plots for ridge regression}
\description{
The genridge package introduces generalizations of the standard univariate
ridge trace plot used in ridge regression and related methods (Friendly,
2012). These graphical methods show both bias (actually, shrinkage) and
precision, by plotting the covariance ellipsoids of the estimated
coefficients, rather than just the estimates themselves. 2D and 3D plotting
methods are provided, both in the space of the predictor variables and in
the transformed space of the PCA/SVD of the predictors.
}
\details{
This package provides computational support for the
graphical methods described in Friendly (2013). Ridge regression models may
be fit using the function \code{\link{ridge}}, which incorporates features
of \code{\link[MASS]{lm.ridge}}. In particular, the shrinkage factors in
ridge regression may be specified either in terms of the constant added to
the diagonal of \eqn{X^T X} matrix (\code{lambda}), or the equivalent number
of degrees of freedom.
More importantly, the \code{\link{ridge}} function also calculates and
returns the associated covariance matrices of each of the ridge estimates,
allowing precision to be studied and displayed graphically.
This provides the support for the main plotting functions in the package:
\code{\link{plot.ridge}}: Bivariate ridge trace plots
\code{\link{pairs.ridge}}: All pairwise bivariate ridge trace plots
\code{\link{plot3d.ridge}}: 3D ridge trace plots
\code{\link{traceplot}}: Traditional univariate ridge trace plots
In addition, the function \code{\link{pca.ridge}} transforms the
coefficients and covariance matrices of a \code{ridge} object from predictor
space to the equivalent, but more interesting space of the PCA of \eqn{X^T
X} or the SVD of \bold{X}. The main plotting functions also work for these
objects, of class \code{c("ridge", "pcaridge")}.
Finally, the functions \code{\link{precision}} and \code{\link{vif.ridge}}
provide other useful measures and plots.
}
\examples{
# see examples for ridge, etc.
}
\references{
Friendly, M. (2013). The Generalized Ridge Trace Plot:
Visualizing Bias \emph{and} Precision. \emph{Journal of Computational and
Graphical Statistics}, \bold{22}(1), 50-68,
doi:10.1080/10618600.2012.681237,
\url{https://www.datavis.ca/papers/genridge-jcgs.pdf}
Arthur E. Hoerl and Robert W. Kennard (1970). Ridge Regression: Biased
Estimation for Nonorthogonal Problems, \emph{Technometrics}, 12(1), pp.
55-67.
Arthur E. Hoerl and Robert W. Kennard (1970). Ridge Regression: Applications
to Nonorthogonal Problems \emph{Technometrics}, 12(1), pp. 69-82.
}
\seealso{
\code{\link[MASS]{lm.ridge}}
}
\author{
Michael Friendly
Maintainer: Michael Friendly <friendly@yorku.ca>
}
\keyword{package}