[Rd] ?eigen documentation suggestion
maechler at stat.math.ethz.ch
Thu Nov 29 17:46:38 CET 2007
>>>>> "DD" == Dan Davison <davison at stats.ox.ac.uk>
>>>>> on Thu, 29 Nov 2007 11:34:18 +0000 writes:
DD> from ?eigen
DD> symmetric: if 'TRUE', the matrix is assumed to be symmetric (or
DD> Hermitian if complex) and only its lower triangle is used. If
DD> 'symmetric' is not specified, the matrix is inspected for
DD> I think that could mislead a naive reader as it suggests that, with symmetric=TRUE,
DD> the result of eigen() (vectors and values) depends only on the lower-triangular values,
DD> and thus not on the values on the diagonal (that's not true for the eigenvalues).
Well, that all depends on what you think when you read
For many of us, this can include the diagonal or not, and we
don't know if it is not specified further.
?lower.tri -- shows the option to include the diagonal.
Consequently, I'd suggest to replace
"only its lower triangle is used"
with "only its lower triangle (diagonal included) is used"
Martin Maechler, ETH Zurich
DD> I suggest that changing it to
DD> "... and only its lower triangle is used when computing the eigenvectors."
DD> would be more accurate, perhaps even with a reminder about the trace - sum of eigenvalues
DD> R-devel at r-project.org mailing list
More information about the R-devel