cluster_sparse_solver_export
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
() of the
phase
=22cluster_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 tocluster_sparse_solver.Do not modifyptafter the calls tocluster_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
Currently, foroperation=SPARSE_DPTLUQTa real (complex) unit vector is provided for the scaling matrixD. Do not turn on scaling(iparm[10]>0) or matching(iparm[12]>0) in theiparmduring the call tocluster_sparse_solverfor this value ofoperation. - comm
- MPI communicator. The solver uses the Fortran MPI communicator internally. Convert the MPI communicator to Fortran using theMPI_Comm_c2f()function. See the examples in the<install_dir>/examplesdirectory.
Output Parameters
- error
- The error indicator:
- error
- Information
- 0
- no error
- -1
- ptis a null pointer
- -2
- invalidpt
- -5
- invalidoperation
- -6
- pointers to some of the data required for the specifiedoperationwere not provided prior to callingcluster_sparse_solver_export
- -9
- unsupported internal code path, consider switching off non-defaultiparmparameters forcluster_sparse_solver
- -10
- unsupported case when the matrixAis distributed among processes with overlap in the preceding calls tocluster_sparse_solver
- -12
- internal memory error
Refer to
cl_solver_export_c.c
for an example using this
functionality.