Intel® Math Kernel Library 2018 Developer Reference - C

pardiso_getdiag

Returns diagonal elements of initial and factorized matrix.

Syntax

void pardiso_getdiag (const _MKL_DSS_HANDLE_t pt, void *df, void *da, const MKL_INT *mnum, MKL_INT *error);

Include Files

Description

This routine returns the diagonal elements of the initial and factorized matrix for a real or Hermitian matrix.

Note

In order to use this routine, you must set iparm[55] to 1 before the main pardiso loop.

Input Parameters

pt

Array with a size of 64. Handle to internal data structure for the Intel MKL PARDISO solver. The entries must be set to zero prior to the first call to pardiso. Unique for factorization.

mnum

Indicates the actual matrix for the solution phase of the Intel MKL PARDISO solver. With this scalar you can define the diagonal elements of the factorized matrix that you want to obtain. The value must be: 1 ≤ mnummaxfct. In most applications this value is 1.

Output Parameters

df

Array with a dimension of n. Contains diagonal elements of the factorized matrix after factorization.

Note

Elements of df correspond to diagonal elements of matrix L computed during phase 22. Because during phase 22 Intel MKL PARDISO makes additional permutations to improve stability, it is possible that array df is not in line with the perm array computed during phase 11.

da

Array with a dimension of n. Contains diagonal elements of the initial matrix.

Note

Elements of da correspond to diagonal elements of matrix L computed during phase 22. Because during phase 22 Intel MKL PARDISO makes additional permutations to improve stability, it is possible that array da is not in line with the perm array computed during phase 11.

error

The error indicator.

error
Information
0

no error

-1

Diagonal information not turned on before pardiso main loop (iparm[55]=0).