Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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

  • mkl_sparse_qr.f90

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.