method: a string specifying the method to apply; can be abbreviated.
symmetric: logical, simply passed to eigen (unless eigen.m is specified); currently, we do not see any reason for not using TRUE.
eigen.m: the eigen value decomposition of m, can be specified in case it is already available.
eps.ev: number specifying the tolerance to use, see Details below.
Details
We form the eigen decomposition
m=VΛV′m=VLV′
where L is the diagonal matrix of eigenvalues, c("L[j,j]\n", "=l[j]"), with decreasing eigenvalues l[1]>=l[2]>=...>=l[n].
When the smallest eigenvalue l[n] are less than Eps <- eps.ev * abs(lambda[1]), i.e., negative or almost zero , some or all eigenvalues are replaced by positive
(>= Eps) values, L[j,j]=l[j]. Then, m=VLV′ is computed and rescaled in order to keep the original diagonal (where that is >= Eps).
Returns
a matrix of the same dimensions and the same diagonal (i.e. diag) as m but with the property to be positive definite.
Author(s)
Martin Maechler, July 2004
Note
As we found out, there are more sophisticated algorithms to solve this and related problems. See the references and the nearPD() function in the list("Matrix") package. We consider nearPD() to also be the successor of this package's nearcor().
References
Section 4.4.2 of Gill, P.~E., Murray, W. and Wright, M.~H. (1981) Practical Optimization, Academic Press.
Cheng, Sheung Hun and Higham, Nick (1998) A Modified Cholesky Algorithm Based on a Symmetric Indefinite Factorization; SIAM J. Matrix Anal.\ Appl., 19 , 1097--1110.
Knol DL, ten Berge JMF (1989) Least-squares approximation of an improper correlation matrix by a proper one. Psychometrika 54 , 53--61.
Highham (2002) Computing the nearest correlation matrix - a problem from finance; IMA Journal of Numerical Analysis 22 , 329--343.
Lucas (2001) Computing nearest covariance and correlation matrices. A thesis submitted to the University of Manchester for the degree of Master of Science in the Faculty of Science and Engeneering.
See Also
eigen on which the current methods rely. nearPD() in the list("Matrix") package. (Further, the deprecated nearcor() from this package.)
Examples
set.seed(12) m <- matrix(round(rnorm(25),2),5,5); m <-1+ m + t(m); diag(m)<- diag(m)+4 m
posdefify(m)1000* zapsmall(m - posdefify(m))