diff --git a/doc/TopicLinearAlgebraDecompositions.dox b/doc/TopicLinearAlgebraDecompositions.dox new file mode 100644 index 000000000..5065be70a --- /dev/null +++ b/doc/TopicLinearAlgebraDecompositions.dox @@ -0,0 +1,223 @@ +namespace Eigen { + +/** \page TopicLinearAlgebraDecompositions Linear algebra and decompositions + + +\section TopicLinAlgBigTable Catalogue of decompositions offered by Eigen + +
| + | Generic information, not Eigen-specific | +Eigen-specific | +|||||
| Decomposition | +Requirements on the matrix | +Speed | +Algorithm reliability and accuracy | +Rank-revealing | +Allows to compute (besides linear solving) | +Linear solver provided by Eigen | +Maturity of Eigen's implementation | +
| PartialPivLU | +Invertible | +Fast | +Depends on condition number | +- | +- | +Yes | +Excellent | +
| FullPivLU | +- | +Slow | +Proven | +Yes | +- | +Yes | +Excellent | +
| HouseholderQR | +- | +Fast | +Average | +Depends on condition number | +Orthogonalization | +Yes | +Excellent | +
| ColPivHouseholderQR | +- | +Fast | +Good | +Yes | +Orthogonalization | +Yes | +Excellent | +
| FullPivHouseholderQR | +- | +Slow | +Proven | +Yes | +Orthogonalization | +Yes | +Average | +
| LLT | +Positive definite | +Very fast | +Depends on condition number | +- | +- | +Yes | +TODO Gael answer this | +
| LDLT | +Positive or negative semidefinite | +Very fast | +Good | +- | +- | +Yes | +TODO Gael answer this | +
| SVD | +- | +Average | +Good | +Yes | +Singular values/vectors, least squares | +Yes | +Average | +
| JacobiSVD | +- | +Slow (but fast for small matrices) | +Proven | +Yes | +Singular values/vectors, least squares | +- | +Excellent | +
| SelfAdjointEigenSolver | +Self-adjoint | +Average | +Good | +Yes | +Eigenvalues/vectors | +- | +TODO Gael/Jitse answer this | +
| ComplexEigenSolver | +Square | +TODO Gael/Jitse answer this | +TODO Gael/Jitse answer this | +Yes | +Eigenvalues/vectors | +- | +TODO Gael/Jitse answer this | +
| EigenSolver | +Square and real | +TODO Gael/Jitse answer this | +TODO Gael/Jitse answer this | +Yes | +Eigenvalues/vectors | +- | +TODO Gael/Jitse answer this | +
| GeneralizedSelfAdjointEigenSolver | +Square | +TODO Gael/Jitse answer this | +TODO Gael/Jitse answer this | +- | +Generalized eigenvalues/vectors | +- | +TODO Gael/Jitse answer this | +
| RealSchur | +Square and real | +TODO Gael/Jitse answer this | +TODO Gael/Jitse answer this | +Yes | +- | +- | +TODO Gael/Jitse answer this | +
| UpperBidiagonalization | +rows >= columns | +Fast | +Good | +- | +- | +- | +Good | +
| Tridiagonalization | +Self-adjoint | +Fast | +Good | +- | +- | +- | +Good | +
| HessenbergDecomposition | +- | +TODO Gael/Jitse answer this | +TODO Gael/Jitse answer this | +- | +- | +- | +TODO Gael/Jitse answer this | +