Visible to Intel only — GUID: GUID-55BAD65B-A7B7-477E-8C87-26560D339EC6
Visible to Intel only — GUID: GUID-55BAD65B-A7B7-477E-8C87-26560D339EC6
mkl_sparse_?_ev
Computes the largest/smallest eigenvalues and corresponding eigenvectors of a standard eigenvalue problem
Syntax
stat = mkl_sparse_s_ev (which, pm, A, descrA, k0, k, E, X, res);
stat = mkl_sparse_d_ev (which, pm, A, descrA, k0, k, E, X, res);
Include Files
- mkl_solvers_ee.f90
Description
The mkl_sparse_?_ev routine computes the largest/smallest eigenvalues and corresponding eigenvectors of a standard eigenvalue problem.
Ax = lambda x
where A is the real symmetric matrix.
Input Parameters
which |
CHARACTER Indicates eigenvalues for which to search:
|
||||||
pm |
C_INT Array of size 128. This array is used to pass various parameters to Extended Eigensolver routines. See • Extended Eigensolver Input Parameters for Extremal Eigenvalue Problem for a complete description of the parameters and their default values. |
||||||
A |
SPARSE_MATRIX_T Handle containing sparse matrix in internal data structure. |
||||||
descrA |
MATRIX_DESCR Structure specifying sparse matrix properties.
|
||||||
k0 |
C_INT The desired number of the largest/smallest eigenvalues to find. |
Output Parameters
k |
C_INT Number of eigenvalues found. |
E |
C_FLOAT for mkl_sparse_s_ev C_DOUBLE for mkl_sparse_d_ev Array of size k0. Contains k largest/smallest eigenvalues. |
X |
C_FLOAT for mkl_sparse_s_ev C_DOUBLE for mkl_sparse_d_ev Array of size k0*Number of columns of the matrix A. Contains k eigenvectors. |
Res |
C_FLOAT for mkl_sparse_s_ev C_DOUBLE for mkl_sparse_d_ev Array of size k0. Contains k residuals. |
Stat |
INTEGER The function returns a value indicating whether the operation was successful or not, and why. |
Return Values
SPARSE_STATUS_SUCCESS |
The operation was successful. |
SPARSE_STATUS_NOT_INITIALIZED |
The routine encountered an empty handle or matrix array. |
SPARSE_STATUS_ALLOC_FAILED |
Internal memory allocation failed. |
SPARSE_STATUS_INVALID_VALUE |
The input parameters contain an invalid value. |
SPARSE_STATUS_EXECUTION_FAILED |
Execution failed. |
SPARSE_STATUS_INTERNAL_ERROR |
An error in algorithm implementation occurred. |
SPARSE_STATUS_NOT_SUPPORTED |
The requested operation is not supported. |