Developer Reference for Intel® oneAPI Math Kernel Library - C

Developer Reference

  • 2021.1
  • 12/04/2020
  • Public Content
Contents

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
.
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
.
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
.
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
-1
A
)*
Q
=
L
*
U
.
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
Refer to
cl_solver_export_c.c
 for an example using this functionality.

Product and Performance Information

1

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