Intel® oneAPI Math Kernel Library Developer Reference - C

pardisoinit

Initialize Intel® oneAPI Math Kernel Library PARDISO with default parameters in accordance with the matrix type.

Syntax

void pardisoinit (_MKL_DSS_HANDLE_t pt, const MKL_INT *mtype, MKL_INT *iparm );

Include Files

Description

This function initializes Intel® oneAPI Math Kernel Library PARDISO internal address pointerpt with zero values (as needed for the very first call of pardiso) and sets default iparmvalues in accordance with the matrix type. Intel® oneAPI Math Kernel Library supplies the pardisoinit routine to be compatible with PARDISO 3.2 or lower.

Note

An alternative way to set default iparm values is to call pardiso in the analysis phase with iparm(1)=0. In this case you must initialize the internal address pointer pt with zero values manually.

Note

The pardisoinitroutine initializes only the in-core version of Intel® oneAPI Math Kernel Library PARDISO. Switching on the out-of core version of Intel® oneAPI Math Kernel Library PARDISO as well as changing default iparm values can be done after the call to pardisoinit but before the first call to pardiso.

Input Parameters

perm

Ignored.

mtype

This scalar value defines the matrix type. Based on this value pardisoinit sets default values for the iparm array. Refer to the section Intel MKL PARDISO Parameters in Tabular Formfor more details about the default values of Intel® oneAPI Math Kernel Library PARDISO

Output Parameters

pt

Array with a dimension of 64. Solver internal data address pointer. These addresses are passed to the solver, and all related internal memory management is organized through this array. The pardisoinit routine nullifies the array pt.

Note

It is very important that the pointer ptis initialized with zero before the first call of Intel® oneAPI Math Kernel Library PARDISO. After that first call you should never modify the pointer, because it could cause a serious memory leak or a crash.

iparm

Array with a dimension of 64. This array is used to pass various parameters to Intel® oneAPI Math Kernel Library PARDISO and to return some useful information after execution of the solver. Thepardisoinit routine fills-in the iparm array with the default values. Refer to the section Intel MKL PARDISO Parameters in Tabular Formfor more details about the default values of Intel® oneAPI Math Kernel Library PARDISO.