Skip to content

eigenvalues_symmetric_matrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrixeigenvalues_symmetric_matrixT_eigenvalues_symmetric_matrix๐Ÿ”—

Short description๐Ÿ”—

eigenvalues_symmetric_matrixeigenvalues_symmetric_matrixEigenvaluesSymmetricMatrixEigenvaluesSymmetricMatrixeigenvalues_symmetric_matrixT_eigenvalues_symmetric_matrix โ€” Compute the eigenvalues and optionally eigenvectors of a symmetric matrix.

Signature๐Ÿ”—

eigenvalues_symmetric_matrix( matrix MatrixID, string ComputeEigenvectors, out matrix EigenvaluesID, out matrix EigenvectorsID )eigenvalues_symmetric_matrix( : : MatrixID, ComputeEigenvectors : EigenvaluesID, EigenvectorsID )void EigenvaluesSymmetricMatrix( const HTuple& MatrixID, const HTuple& ComputeEigenvectors, HTuple* EigenvaluesID, HTuple* EigenvectorsID )static void HOperatorSet.EigenvaluesSymmetricMatrix( HTuple matrixID, HTuple computeEigenvectors, out HTuple eigenvaluesID, out HTuple eigenvectorsID )def eigenvalues_symmetric_matrix( matrix_id: HHandle, compute_eigenvectors: str ) -> Tuple[HHandle, HHandle]

Herror T_eigenvalues_symmetric_matrix( const Htuple MatrixID, const Htuple ComputeEigenvectors, Htuple* EigenvaluesID, Htuple* EigenvectorsID )

HMatrix HMatrix::EigenvaluesSymmetricMatrix( const HString& ComputeEigenvectors, HMatrix* EigenvectorsID ) const

HMatrix HMatrix::EigenvaluesSymmetricMatrix( const char* ComputeEigenvectors, HMatrix* EigenvectorsID ) const

HMatrix HMatrix::EigenvaluesSymmetricMatrix( const wchar_t* ComputeEigenvectors, HMatrix* EigenvectorsID ) const (Windows only)

HMatrix HMatrix.EigenvaluesSymmetricMatrix( string computeEigenvectors, out HMatrix eigenvectorsID )

Description๐Ÿ”—

The operator eigenvalues_symmetric_matrixEigenvaluesSymmetricMatrix computes all eigenvalues and, optionally, eigenvectors of the symmetric Matrix. The matrix is defined by the matrix handle MatrixIDmatrixIDmatrix_id. On output, a new matrix Eigenvalues with the eigenvalues in ascending order and, optionally, a new matrix Eigenvectors with the eigenvectors is created. The operator returns the matrix handles EigenvaluesIDeigenvaluesIDeigenvalues_id and EigenvectorsIDeigenvectorsIDeigenvectors_id of the matrices Eigenvalues and Eigenvectors. Access to the elements of the matrices is possible e.g., with the operator get_full_matrixGetFullMatrix.

The computation of eigenvectors can be selected via ComputeEigenvectorscomputeEigenvectorscompute_eigenvectors = 'true'"true" or ComputeEigenvectorscomputeEigenvectorscompute_eigenvectors = 'false'"false".

Example:

ComputeEigenvectorscomputeEigenvectorscompute_eigenvectors = 'true'"true"

\[\begin{eqnarray*} \texttt{Matrix} = \left[ \begin{array}{rrr} 6.0 & 5.0 & 3.0 \\ 5.0 & 7.0 & 3.0 \\ 3.0 & 3.0 & 4.0 \end{array} \right] \end{eqnarray*}\]
\[\begin{eqnarray*} \to \qquad \texttt{Eigenvalues} = \left[ \begin{array}{r} 1.4195 \\ 2.1507 \\ 13.4298 \end{array} \right] \qquad \texttt{Eigenvectors} = \left[ \begin{array}{rrr} 0.7842 & 0.0626 & 0.6174 \\ -0.5667 & 0.4776 & 0.6714 \\ -0.2529 & -0.8763 & 0.4100 \end{array} \right] \end{eqnarray*}\]

Attention๐Ÿ”—

The upper triangular part of the input Matrix must contain the relevant information of the matrix. The strictly lower triangular part of the matrix is not referenced. If the referenced part of the input Matrix is not of the specified type, an exception is raised.

Execution information๐Ÿ”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters๐Ÿ”—

MatrixIDmatrixIDmatrix_id (input_control) matrix โ†’ (handle)(handle)HTuple (HHandle)HMatrix, HTuple (IntPtr)HHandleHtuple (handle)

Matrix handle of the input matrix.

ComputeEigenvectorscomputeEigenvectorscompute_eigenvectors (input_control) string โ†’ (string)(string)HTuple (HString)HTuple (string)strHtuple (char*)

Computation of the eigenvectors.

Default: 'false'"false"
List of values: 'false', 'true'"false", "true"

EigenvaluesIDeigenvaluesIDeigenvalues_id (output_control) matrix โ†’ (handle)(handle)HTuple (HHandle)HMatrix, HTuple (IntPtr)HHandleHtuple (handle)

Matrix handle with the eigenvalues.

EigenvectorsIDeigenvectorsIDeigenvectors_id (output_control) matrix โ†’ (handle)(handle)HTuple (HHandle)HMatrix, HTuple (IntPtr)HHandleHtuple (handle)

Matrix handle with the eigenvectors.

Result๐Ÿ”—

If the parameters are valid, the operator eigenvalues_symmetric_matrixEigenvaluesSymmetricMatrix returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Combinations with other operators๐Ÿ”—

Combinations

Possible predecessors

create_matrixCreateMatrix

Possible successors

get_full_matrixGetFullMatrix, get_value_matrixGetValueMatrix

Alternatives

eigenvalues_general_matrixEigenvaluesGeneralMatrix

See also

generalized_eigenvalues_symmetric_matrixGeneralizedEigenvaluesSymmetricMatrix, generalized_eigenvalues_general_matrixGeneralizedEigenvaluesGeneralMatrix

References๐Ÿ”—

David Poole: โ€œLinear Algebra: A Modern Introductionโ€; Thomson; Belmont; 2006.

Gene H. Golub, Charles F. van Loan: โ€œMatrix Computationsโ€; The Johns Hopkins University Press; Baltimore and London; 1996.

Module๐Ÿ”—

Foundation