| Line 1... |
Line 1... |
| 1 |
% File src/library/base/man/svd.Rd
|
1 |
% File src/library/base/man/svd.Rd
|
| 2 |
% Part of the R package, https://www.R-project.org
|
2 |
% Part of the R package, https://www.R-project.org
|
| 3 |
% Copyright 1995-2014 R Core Team
|
3 |
% Copyright 1995-2017 R Core Team
|
| 4 |
% Distributed under GPL 2 or later
|
4 |
% Distributed under GPL 2 or later
|
| 5 |
|
5 |
|
| 6 |
\name{svd}
|
6 |
\name{svd}
|
| 7 |
\alias{svd}
|
7 |
\alias{svd}
|
| 8 |
\alias{La.svd}
|
8 |
\alias{La.svd}
|
| Line 41... |
Line 41... |
| 41 |
\value{
|
41 |
\value{
|
| 42 |
The SVD decomposition of the matrix as computed by LAPACK, \deqn{
|
42 |
The SVD decomposition of the matrix as computed by LAPACK, \deqn{
|
| 43 |
\bold{X = U D V'},} where \eqn{\bold{U}} and \eqn{\bold{V}} are
|
43 |
\bold{X = U D V'},} where \eqn{\bold{U}} and \eqn{\bold{V}} are
|
| 44 |
orthogonal, \eqn{\bold{V'}} means \emph{V transposed} (and conjugated
|
44 |
orthogonal, \eqn{\bold{V'}} means \emph{V transposed} (and conjugated
|
| 45 |
for complex input), and \eqn{\bold{D}} is a diagonal matrix with the
|
45 |
for complex input), and \eqn{\bold{D}} is a diagonal matrix with the
|
| 46 |
singular values \eqn{D_{ii}}{D[i,i]}. Equivalently, \eqn{\bold{D = U'
|
46 |
(non-negative) singular values \eqn{D_{ii}}{D[i,i]} in decreasing
|
| - |
|
47 |
order. Equivalently, \eqn{\bold{D = U' X V}}, which is verified in
|
| 47 |
X V}}, which is verified in the examples.
|
48 |
the examples.
|
| 48 |
|
49 |
|
| 49 |
The returned value is a list with components
|
50 |
The returned value is a list with components
|
| 50 |
\item{d}{a vector containing the singular values of \code{x}, of
|
51 |
\item{d}{a vector containing the singular values of \code{x}, of
|
| 51 |
length \code{min(n, p)}.}
|
52 |
length \code{min(n, p)}, sorted decreasingly.}
|
| 52 |
\item{u}{a matrix whose columns contain the left singular vectors of
|
53 |
\item{u}{a matrix whose columns contain the left singular vectors of
|
| 53 |
\code{x}, present if \code{nu > 0}. Dimension \code{c(n, nu)}.}
|
54 |
\code{x}, present if \code{nu > 0}. Dimension \code{c(n, nu)}.}
|
| 54 |
\item{v}{a matrix whose columns contain the right singular vectors of
|
55 |
\item{v}{a matrix whose columns contain the right singular vectors of
|
| 55 |
\code{x}, present if \code{nv > 0}. Dimension \code{c(p, nv)}.}
|
56 |
\code{x}, present if \code{nv > 0}. Dimension \code{c(p, nv)}.}
|
| 56 |
|
57 |
|
| Line 73... |
Line 74... |
| 73 |
Anderson. E. and ten others (1999)
|
74 |
Anderson. E. and ten others (1999)
|
| 74 |
\emph{LAPACK Users' Guide}. Third Edition. SIAM.\cr
|
75 |
\emph{LAPACK Users' Guide}. Third Edition. SIAM.\cr
|
| 75 |
Available on-line at
|
76 |
Available on-line at
|
| 76 |
\url{http://www.netlib.org/lapack/lug/lapack_lug.html}.
|
77 |
\url{http://www.netlib.org/lapack/lug/lapack_lug.html}.
|
| 77 |
|
78 |
|
| - |
|
79 |
The \href{https://en.wikipedia.org/wiki/Singular-value_decomposition}{%
|
| - |
|
80 |
\sQuote{Singular-value decomposition}} Wikipedia article.
|
| - |
|
81 |
|
| 78 |
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
|
82 |
Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988)
|
| 79 |
\emph{The New S Language}.
|
83 |
\emph{The New S Language}.
|
| 80 |
Wadsworth & Brooks/Cole.
|
84 |
Wadsworth & Brooks/Cole.
|
| 81 |
}
|
85 |
}
|
| 82 |
|
86 |
|