pardiso_export

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 6/30/2025

Version

Public

pardiso_export

Places pointers dedicated for sparse representation of a requested matrix (values, rows, and columns) into MKL PARDISO

Syntax

void pardiso_export (const _MKL_DSS_HANDLE_t pt, void* values, MKL_INT* rows, MKL_INT* columns, MKL_INT* step, MKL_INT* iparm, MKL_INT* error);

Include Files

mkl.h

Description

This auxiliary routine places pointers dedicated for sparse representation of a requested matrix (values, rows, and columns) into MKL PARDISO. The matrix will be stored in the three-array variant of the compressed sparse row (CSR3 format) with 0-based indexing.

NOTE:

Currently, this routine can be used only for a sparse Schur complement matrix. All parameters related to the Schur complement matrix (perm, iparm) must be set before the reordering stage of MKL PARDISO (phase = 11) is called.

Input Parameters

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.

iparm

This array is used to pass various parameters to Intel^® MKL PARDISO and to return some useful information after execution of the solver.

step

Stage indicator. These are the currently supported values:

Step value	Notes
`1`	Used to place pointers related to a Schur complement matrix in MKL PARDISO. The routine with step equal to 1 must be called between the reordering and factorization phases of MKL PARDISO.
`−1`	Used to clean the internal handle.

Input/Output Parameters

values	Parameter type: input/output parameter. This array contains the non-zero elements of the requested matrix.
rows	Parameter type: input/output parameter. `Array of size (size + 1)` For CSR3 format, `rows[i] ( i < size )` points to the first column index of row i in the array columns; that is, `rows[i]` gives the index of the element in the array values that contains the first non-zero element from row `i` of the sparse matrix. The last element, `rows[size]`, is equal to the number of non-zero elements in the sparse matrix.
columns	Parameter type: input/output parameter. This array contains the column indices for the non-zero elements of the requested matrix.
error	Parameter type: output parameter. The error status: `0` indicates no error. `1` indicates inconsistent input data.

Usage Example

The following C-style example demonstrates how to use the pardiso_export routine to get the sparse representation (that is, three-array CSR format) of a Schur complement matrix.

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

pardiso_export

Syntax

Include Files

Description

Input Parameters

Input/Output Parameters

Usage Example