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

sparse_matrix_checker_init

Initializes handle for sparse matrix checker.

Syntax

call sparse_matrix_checker_init (handle)

Include Files

  • mkl_sparse_handle.fi, mkl_sparse_handle.f90

Description

The sparse_matrix_checker_init routine initializes the handle for the sparse_matrix_checker routine. The handle variable contains this data:

Description of sparse_matrix_checkerhandle Data
Field Type Possible Values Meaning

n

INTEGER

Order of the matrix stored in sparse array.

csr_ia

INTEGER (C_INTPTR_T)

Pointer to ia array for matrix_format = MKL_CSR

 

csr_ja

INTEGER (C_INTPTR_T)

Pointer to ja array for matrix_format = MKL_CSR

 

check_result(3)

INTEGER (KIND=4)

See Sparse Matrix Checker Error Values for a description of the values returned in check_result.

Indicates location of problem in array when message_level = MKL_NO_PRINT.

indexing

INTEGER (KIND=4)

MKL_ZERO_BASED

MKL_ONE_BASED

Indexing style used in array.

matrix_structure

INTEGER (KIND=4)

MKL_GENERAL_STRUCTURE

MKL_UPPER_TRIANGULAR

MKL_LOWER_TRIANGULAR

MKL_STRUCTURAL_SYMMETRIC

Type of sparse matrix stored in array.

matrix_format

INTEGER (KIND=4)

MKL_CSR

Format of array used for sparse matrix storage.

message_level

INTEGER (KIND=4)

MKL_NO_PRINT

MKL_PRINT

Determines whether or not feedback is provided on the screen.

print_style

INTEGER (KIND=4)

MKL_C_STYLE

MKL_FORTRAN_STYLE

Determines style of messages when message_level = MKL_PRINT.

Input Parameters

handle

TYPE (SPARSE_STRUCT), INTENT(INOUT)

Pointer to the data structure describing the sparse array to check.

Output Parameters

handle

Pointer to the initialized data structure.