Developer Reference

Contents

cluster_sparse_solver_set_ptr

Internally saves a provided pointer to the data corresponding to the specified name.

Syntax

void
cluster_sparse_solver_set_ptr
(
_MKL_DSS_HANDLE_t
pt
,
_MKL_DSS_EXPORT_DATA
name
,
void
*
ptr
,
const int
*
comm
,
MKL_INT
*
error
);
Include Files
  • mkl_cluster_sparse_solver.h
Description
This routine internally saves the input pointer,
ptr
, of the data which correspond to the provided
name
. The saved pointer can then be used for exporting corresponding data by means of
cluster_sparse_solver_export
.
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
.
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
.
name
Specifies the data for which the pointer is provided.
SPARSE_PTLUQT_P
Permutation
P
from
P
*
A
*
Q
=
L
*
U
.
SPARSE_PTLUQT_Q
Permutation
Q
from
P
*
A
*
Q
=
L
*
U
.
SPARSE_DPTLUQT_P
Permutation
P
from
P
* (
D
-1
A
)*
Q
=
L
*
U
.
SPARSE_DPTLUQT_Q
Permutation
Q
from
P
* (
D
-1
A
)*
Q
=
L
*
U
.
SPARSE_DPTLUQT_D
Scaling (diagonal)
D
from
P
* (
D
-1
A
)*
Q
=
L
*
U
.
vals
Array containing elements of the vector representation for the data which corresponds to the
name
. Its length should be at least
local_nrows
, where
local_nrows
is the local number of rows in a corresponding matrix (obtained from
cluster_sparse_solver_get_csr_size
, for example).
For permutations
P
and
Q
,
vals
is interpreted as
MKL_INT*
, while for the scaling it is interpreted as
float*
/
double*
(
MKL_Complex8*
/
MKL_Complex16*
) depending on
mtype
(type of the matrix
A
) and
iparm[27]
(precision) specified in the preceding call to
cluster_sparse_solver
.
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
-3
invalid
name
-4
unsupported
name
-9
unsupported internal code path, consider switching off non-default
iparm
parameters for
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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804