Computes eigenvalues and eigenvectors of general complex matrices. More...
#include <ComplexEigenSolver.h>
Public Types | |
enum | { RowsAtCompileTime = MatrixType::RowsAtCompileTime, ColsAtCompileTime = MatrixType::ColsAtCompileTime, Options = MatrixType::Options, MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime } |
typedef std::complex< RealScalar > | ComplexScalar |
Complex scalar type for MatrixType. More... | |
typedef Matrix< ComplexScalar, ColsAtCompileTime, 1, Options &(~RowMajor), MaxColsAtCompileTime, 1 > | EigenvalueType |
Type for vector of eigenvalues as returned by eigenvalues(). More... | |
typedef Matrix< ComplexScalar, RowsAtCompileTime, ColsAtCompileTime, Options, MaxRowsAtCompileTime, MaxColsAtCompileTime > | EigenvectorType |
Type for matrix of eigenvectors as returned by eigenvectors(). More... | |
typedef Eigen::Index | Index |
typedef _MatrixType | MatrixType |
Synonym for the template parameter _MatrixType . More... | |
typedef NumTraits< Scalar >::Real | RealScalar |
typedef MatrixType::Scalar | Scalar |
Scalar type for matrices of type MatrixType. More... | |
Public Member Functions | |
ComplexEigenSolver () | |
Default constructor. More... | |
template<typename InputType > | |
ComplexEigenSolver (const EigenBase< InputType > &matrix, bool computeEigenvectors=true) | |
Constructor; computes eigendecomposition of given matrix. More... | |
ComplexEigenSolver (Index size) | |
Default Constructor with memory preallocation. More... | |
template<typename InputType > | |
ComplexEigenSolver< MatrixType > & | compute (const EigenBase< InputType > &matrix, bool computeEigenvectors) |
template<typename InputType > | |
ComplexEigenSolver & | compute (const EigenBase< InputType > &matrix, bool computeEigenvectors=true) |
Computes eigendecomposition of given matrix. More... | |
const EigenvalueType & | eigenvalues () const |
Returns the eigenvalues of given matrix. More... | |
const EigenvectorType & | eigenvectors () const |
Returns the eigenvectors of given matrix. More... | |
Index | getMaxIterations () |
Returns the maximum number of iterations. More... | |
ComputationInfo | info () const |
Reports whether previous computation was successful. More... | |
ComplexEigenSolver & | setMaxIterations (Index maxIters) |
Sets the maximum number of iterations allowed. More... | |
Static Protected Member Functions | |
static void | check_template_parameters () |
Protected Attributes | |
bool | m_eigenvectorsOk |
EigenvalueType | m_eivalues |
EigenvectorType | m_eivec |
bool | m_isInitialized |
EigenvectorType | m_matX |
ComplexSchur< MatrixType > | m_schur |
Private Member Functions | |
void | doComputeEigenvectors (RealScalar matrixnorm) |
void | sortEigenvalues (bool computeEigenvectors) |
Computes eigenvalues and eigenvectors of general complex matrices.
\eigenvalues_module
_MatrixType | the type of the matrix of which we are computing the eigendecomposition; this is expected to be an instantiation of the Matrix class template. |
The eigenvalues and eigenvectors of a matrix are scalars and vectors such that . If is a diagonal matrix with the eigenvalues on the diagonal, and is a matrix with the eigenvectors as its columns, then . The matrix is almost always invertible, in which case we have . This is called the eigendecomposition.
The main function in this class is compute(), which computes the eigenvalues and eigenvectors of a given function. The documentation for that function contains an example showing the main features of the class.
Definition at line 45 of file ComplexEigenSolver.h.
typedef std::complex<RealScalar> Eigen::ComplexEigenSolver< _MatrixType >::ComplexScalar |
Complex scalar type for MatrixType.
This is std::complex<Scalar>
if Scalar is real (e.g., float
or double
) and just Scalar
if Scalar is complex.
Definition at line 71 of file ComplexEigenSolver.h.
typedef Matrix<ComplexScalar, ColsAtCompileTime, 1, Options&(~RowMajor), MaxColsAtCompileTime, 1> Eigen::ComplexEigenSolver< _MatrixType >::EigenvalueType |
Type for vector of eigenvalues as returned by eigenvalues().
This is a column vector with entries of type ComplexScalar. The length of the vector is the size of MatrixType.
Definition at line 78 of file ComplexEigenSolver.h.
typedef Matrix<ComplexScalar, RowsAtCompileTime, ColsAtCompileTime, Options, MaxRowsAtCompileTime, MaxColsAtCompileTime> Eigen::ComplexEigenSolver< _MatrixType >::EigenvectorType |
Type for matrix of eigenvectors as returned by eigenvectors().
This is a square matrix with entries of type ComplexScalar. The size is the same as the size of MatrixType.
Definition at line 85 of file ComplexEigenSolver.h.
typedef Eigen::Index Eigen::ComplexEigenSolver< _MatrixType >::Index |
Definition at line 63 of file ComplexEigenSolver.h.
typedef _MatrixType Eigen::ComplexEigenSolver< _MatrixType >::MatrixType |
Synonym for the template parameter _MatrixType
.
Definition at line 50 of file ComplexEigenSolver.h.
typedef NumTraits<Scalar>::Real Eigen::ComplexEigenSolver< _MatrixType >::RealScalar |
Definition at line 62 of file ComplexEigenSolver.h.
typedef MatrixType::Scalar Eigen::ComplexEigenSolver< _MatrixType >::Scalar |
Scalar type for matrices of type MatrixType.
Definition at line 61 of file ComplexEigenSolver.h.
anonymous enum |
Enumerator | |
---|---|
RowsAtCompileTime | |
ColsAtCompileTime | |
Options | |
MaxRowsAtCompileTime | |
MaxColsAtCompileTime |
Definition at line 52 of file ComplexEigenSolver.h.
|
inline |
Default constructor.
The default constructor is useful in cases in which the user intends to perform decompositions via compute().
Definition at line 92 of file ComplexEigenSolver.h.
|
inlineexplicit |
Default Constructor with memory preallocation.
Like the default constructor but with preallocation of the internal data according to the specified problem size.
Definition at line 107 of file ComplexEigenSolver.h.
|
inlineexplicit |
Constructor; computes eigendecomposition of given matrix.
[in] | matrix | Square matrix whose eigendecomposition is to be computed. |
[in] | computeEigenvectors | If true, both the eigenvectors and the eigenvalues are computed; if false, only the eigenvalues are computed. |
This constructor calls compute() to compute the eigendecomposition.
Definition at line 126 of file ComplexEigenSolver.h.
|
inlinestaticprotected |
Definition at line 240 of file ComplexEigenSolver.h.
ComplexEigenSolver<MatrixType>& Eigen::ComplexEigenSolver< _MatrixType >::compute | ( | const EigenBase< InputType > & | matrix, |
bool | computeEigenvectors | ||
) |
Definition at line 261 of file ComplexEigenSolver.h.
ComplexEigenSolver& Eigen::ComplexEigenSolver< _MatrixType >::compute | ( | const EigenBase< InputType > & | matrix, |
bool | computeEigenvectors = true |
||
) |
Computes eigendecomposition of given matrix.
[in] | matrix | Square matrix whose eigendecomposition is to be computed. |
[in] | computeEigenvectors | If true, both the eigenvectors and the eigenvalues are computed; if false, only the eigenvalues are computed. |
*this
This function computes the eigenvalues of the complex matrix matrix
. The eigenvalues() function can be used to retrieve them. If computeEigenvectors
is true, then the eigenvectors are also computed and can be retrieved by calling eigenvectors().
The matrix is first reduced to Schur form using the ComplexSchur class. The Schur decomposition is then used to compute the eigenvalues and eigenvectors.
The cost of the computation is dominated by the cost of the Schur decomposition, which is where is the size of the matrix.
Example:
Output:
|
private |
Definition at line 287 of file ComplexEigenSolver.h.
|
inline |
Returns the eigenvalues of given matrix.
This function returns a column vector containing the eigenvalues. Eigenvalues are repeated according to their algebraic multiplicity, so there are as many eigenvalues as rows in the matrix. The eigenvalues are not sorted in any particular order.
Example:
Output:
Definition at line 182 of file ComplexEigenSolver.h.
|
inline |
Returns the eigenvectors of given matrix.
computeEigenvectors
was set to true (the default).This function returns a matrix whose columns are the eigenvectors. Column is an eigenvector corresponding to eigenvalue number as returned by eigenvalues(). The eigenvectors are normalized to have (Euclidean) norm equal to one. The matrix returned by this function is the matrix in the eigendecomposition , if it exists.
Example:
Output:
Definition at line 157 of file ComplexEigenSolver.h.
|
inline |
Returns the maximum number of iterations.
Definition at line 233 of file ComplexEigenSolver.h.
|
inline |
Reports whether previous computation was successful.
Success
if computation was successful, NoConvergence
otherwise. Definition at line 219 of file ComplexEigenSolver.h.
|
inline |
Sets the maximum number of iterations allowed.
Definition at line 226 of file ComplexEigenSolver.h.
|
private |
Definition at line 327 of file ComplexEigenSolver.h.
|
protected |
Definition at line 249 of file ComplexEigenSolver.h.
|
protected |
Definition at line 246 of file ComplexEigenSolver.h.
|
protected |
Definition at line 245 of file ComplexEigenSolver.h.
|
protected |
Definition at line 248 of file ComplexEigenSolver.h.
|
protected |
Definition at line 250 of file ComplexEigenSolver.h.
|
protected |
Definition at line 247 of file ComplexEigenSolver.h.