Developer Reference

Contents

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
  • mkl.h
Description
This function initializes the solver handle
pt
for
Intel® oneAPI Math Kernel Library
PARDISO with zero values (as needed for the very first call of
pardiso
) and sets default
iparm
values in accordance with the matrix type
mtype
.
The recommended way is to avoid using
pardisoinit
and to initialize
pt
and set the values of the
iparm
array manually as the default parameters might not be the best for a particular use case.
An alternative method to set default
iparm
values is to call
pardiso
in the analysis phase with
iparm(1)=0
. In this case, the solver handle
pt
must be initialized with zero values.
The
pardisoinit
routine initializes only the in-core version of
Intel® oneAPI Math Kernel Library
PARDISO. Switching to 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
.
The
pardisoinit
routine cannot be used together with the
pardiso_64
routine.
Input Parameters
mtype
Matrix type. Based on this value
pardisoinit
chooses default values for the
iparm
array. Refer to the section oneMKL PARDISO Parameters in Tabular Formfor more details about the default values of
Intel® oneAPI Math Kernel Library
PARDISO.
Output Parameters
pt
Array of size 64. Handle to internal data structure. The
pardisoinit
routine nullifies the array
pt
.
It is very important that
pt
is initialized with zero before the first call of
Intel® oneAPI Math Kernel Library
PARDISO. After that first call you must never modify the array, because it could cause a serious memory leak or a crash.
iparm
Array of size 64. This array is used to set various options for
Intel® oneAPI Math Kernel Library
PARDISO and to return some useful information after execution of the solver. The
pardisoinit
routine fills in the
iparm
array with the default values. Refer to the section oneMKL PARDISO Parameters in Tabular Form for more details about the default values of
Intel® oneAPI Math Kernel Library
PARDISO.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.