Developer Reference for Intel® oneAPI Math Kernel Library for C
mkl_sparse_order
Performs sorting of matrix data in matrix handle according to the specified matrix format. Supports CSR, CSC and BSR formats.
Syntax
sparse_status_t mkl_sparse_order ( const sparse_matrix_t A );
Include Files
mkl_spblas.h
Description
Use the mkl_sparse_order routine to perform ordering of the data in the provided matrix according to the specified matrix format:
Matrix format |
Description of sorting performed |
|---|---|
CSR |
Sorts column indices and values within each row of the matrix. |
CSC |
Sorts column indices and values within each column of the matrix. |
BSR |
Sorts block column indices and block of values within each row of the matrix. |
COO |
SPARSE_STATUS_NOT_SUPPORTED |
Input Parameters
A
Handle to the matrix to be ordered.
Output Parameters
A
Handle containing modified internal data.
Return Values
The function returns a 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. |