cluster_sparse_solver

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 11/07/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-9AF71EE9-6FB0-4621-AD30-8EDF26B1F674

View Details

cluster_sparse_solver_export

Computes data corresponding to the specified decomposition (defined by export operation) and fills the pointers provided by calls to cluster_sparse_solver_set_ptr and/or cluster_sparse_solver_set_csr_ptrs.

Syntax

void cluster_sparse_solver_export (_MKL_DSS_HANDLE_t pt, _MKL_DSS_EXPORT_OPERATION operation, const int *comm, MKL_INT *error);

Include Files

mkl_cluster_sparse_solver.h

Description

This routine computes the data for the pointers of the (distributed) data to be exported (as defined the specified operation). It is assumed that the exported data will be distributed in the same way as the matrix A (as defined by iparm[39]) used in cluster_sparse_solver.

NOTE:

Only call this routine after the factorization phase (phase=22) of the cluster_sparse_solver has been called. Neither pt, nor iparm should be changed after the preceding call to cluster_sparse_solver.

NOTE:

Only call this routine after all pointers to the data required for the specified operation have been provided by means of calling cluster_sparse_solver_set_ptr and/or cluster_sparse_solver_set_csr_ptrs.

Input Parameters

pt

Array with size of 64.

Handle to internal data structure used in the prior calls to cluster_sparse_solver.

CAUTION:

Do not modify pt after the calls to cluster_sparse_solver.

operation

Specifies a particular operation which defines what data are exported

SPARSE_PTLUQT: Exporting data from decomposition P*A*Q=L*U.
SPARSE_DPTLUQT: Exporting data from decomposition from P* (D^-1A)*Q=L*U.

NOTE:

Currently, for operation=SPARSE_DPTLUQT a real (complex) unit vector is provided for the scaling matrix D. Do not turn on scaling(iparm[10]>0) or matching(iparm[12]>0) in the iparm during the call to cluster_sparse_solver for this value of operation.

comm

MPI communicator. The solver uses the Fortran MPI communicator internally. Convert the MPI communicator to Fortran using the MPI_Comm_c2f() function. See the examples in the <install_dir>/examples directory.

Output Parameters

error

The error indicator:

error: Information
0: no error
-1: pt is a null pointer
-2: invalid pt
-5: invalid operation
-6: pointers to some of the data required for the specified operation were not provided prior to calling cluster_sparse_solver_export
-9: unsupported internal code path, consider switching off non-default iparm parameters for cluster_sparse_solver
-10: unsupported case when the matrix A is distributed among processes with overlap in the preceding calls to cluster_sparse_solver
-12: internal memory error

NOTE:

Refer to cl_solver_export_c.c for an example using this functionality.

Parent topic: Parallel Direct Sparse Solver for Clusters 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

cluster_sparse_solver_export

Syntax

Include Files

Description

Input Parameters

Output Parameters