Intel® oneAPI Math Kernel Library Developer Reference - Fortran
Creates a copy of a matrix handle.
stat = mkl_sparse_copy (source, descr, dest)
The mkl_sparse_copy routine creates a copy of a matrix handle.
Currently, the mkl_sparse_copy routine does not support the descriptor argument and creates an exact (deep) copy of the input matrix.
SPARSE_MATRIX_T.
Specifies handle containing internal data.
MATRIX_DESCR.
Descriptor specifying sparse matrix properties.
type - Specifies the type of a sparse matrix:
SPARSE_MATRIX_TYPE_GENERAL |
The matrix is processed as is. |
SPARSE_MATRIX_TYPE_SYMMETRIC |
The matrix is symmetric (only the requested triangle is processed). |
SPARSE_MATRIX_TYPE_HERMITIAN |
The matrix is Hermitian (only the requested triangle is processed). |
SPARSE_MATRIX_TYPE_TRIANGULAR |
The matrix is triangular (only the requested triangle is processed). |
SPARSE_MATRIX_TYPE_DIAGONAL |
The matrix is diagonal (only diagonal elements are processed). |
SPARSE_MATRIX_TYPE_BLOCK_TRIANGULAR |
The matrix is block-triangular (only requested triangle is processed). Applies to BSR format only. |
SPARSE_MATRIX_TYPE_BLOCK_DIAGONAL |
The matrix is block-diagonal (only diagonal blocks are processed). Applies to BSR format only. |
mode - Specifies the triangular matrix part for symmetric, Hermitian, triangular, and block-triangular matrices:
SPARSE_FILL_MODE_LOWER |
The lower triangular matrix part is processed. |
SPARSE_FILL_MODE_UPPER |
The upper triangular matrix part is processed. |
diag - Specifies diagonal type for non-general matrices:
SPARSE_DIAG_NON_UNIT |
Diagonal elements might not be equal to one. |
SPARSE_DIAG_UNIT |
Diagonal elements are equal to one. |
SPARSE_MATRIX_T for mkl_sparse_copy
Handle containing internal data.
INTEGER
Value indicating whether the operation was successful or not, and why:
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. |