Intel® oneAPI Math Kernel Library Developer Reference - Fortran

mkl_sparse_set_qr_hint

Define the pivot strategy for further calls of mkl_sparse_?_qr.

Syntax

stat = mkl_sparse_set_qr_hint ( A, hint )

Include Files

Description

You can use this routine to enable a pivot strategy in the case of an ill-conditioned matrix.

Input Parameters

A

SPARSE_MATRIX_T

Handle containing a sparse matrix in an internal data structure.

hint

C_INT

Value specifying whether to use pivoting.

Note

The only value currently supported is SPARSE_QR_WITH_PIVOTS, which enables the use of a pivot strategy for an ill-conditioned matrix.

Output Parameters

stat

INTEGER

Value indicating whether the operation was successful, and if not, 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.