pardisoinit

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 3/31/2023

Version

Public

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

Visible to Intel only — GUID: GUID-C16BFBCA-EF1C-4CDB-BC73-41655B6DD8F5

View Details

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.

NOTE:

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. Thepardisoinit 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.

Parent topic: oneMKL PARDISO - Parallel Direct Sparse Solver Interface

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for C

pardisoinit