Computes forward, backward sweeps or a symmetric successive over-relaxation preconditioner operation.
stat = sparse_status_t mkl_sparse_s_sorv(type, descrA, A, omega, alpha, x, b)
stat = sparse_status_t mkl_sparse_d_sorv(type, descrA, A, omega, alpha, x, b)
The mkl_sparse_?_sorv routine performs one of the following operations:
SPARSE_SOR_FORWARD:
SPARSE_SOR_BACKWARD:
SPARSE_SOR_SYMMETRIC: Performs application of a
preconditioner.
where A = L + D + U and x^0 is an input vector x scaled by input parameter alpha vector and x^1 is an output stored in vector x.
Currently this routine only supports the following configuration:
Currently, this routine is optimized only for sequential threading execution mode.
Product and Performance Information |
---|
Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex. Notice revision #20201201 |
SPARSE_MATRIX_T.
Specifies the operation performed by the SORV preconditioner.
SPARSE_SOR_FORWARD |
Performs forward sweep as defined by: |
SPARSE_SOR_BACKWARD |
Performs backward sweep as defined by: |
SPARSE_SOR_SYMMETRIC |
Preconditioner matrix could be expressed as: |
MATRIX_DESCR.
Structure specifying sparse matrix properties.
SPARSE_MATRIX_T type |
Specifies the type of a sparse matrix:
|
C_INT mode |
Specifies the triangular matrix part for symmetric, Hermitian, triangular, and block-triangular matrices:
|
SPARSE_MATRIX_TYPE_DIAGONAL diag |
Specifies diagonal type for non-general matrices:
|
SPARSE_MATRIX_T.
Handle containing internal data.
C_FLOAT.
Relaxation factor.
C_FLOAT.
Parameter that could be used to normalize or set to zero the vector x that holds the initial guess.
C_FLOAT.
Initial guess on input.
C_FLOAT.
Right-hand side.
C_FLOAT.
Solution vector on output.
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. |