Developer Reference

Contents

dss_factor_real
,
dss_factor_complex

Compute factorization of the matrix with previously specified location of non-zero elements.

Syntax

MKL_INT
dss_factor_real
(
_MKL_DSS_HANDLE_t *
handle
,
MKL_INT const *
opt
,
void const *
rValues
)
MKL_INT
dss_factor_complex
(
_MKL_DSS_HANDLE_t *
handle
,
MKL_INT const *
opt
,
void const *
cValues
)
Include Files
  • mkl.h
Description
These routines compute factorization of the matrix whose non-zero locations were previously specified by a call to
dss_define_structure
and whose non-zero values are given in the array
rValues
,
cValues
or
Values
. Data type These arrays must be of length
nNonZeros
as defined in a previous call to
dss_define_structure
.
The data type (single or double precision) of
rValues
,
cValues
,
Values
must be in correspondence with precision specified by the parameter
opt
in the routine
dss_create
.
The
opt
argument can contain one of the following options:
  • MKL_DSS_POSITIVE_DEFINITE
  • MKL_DSS_INDEFINITE
  • MKL_DSS_HERMITIAN_POSITIVE_DEFINITE
  • MKL_DSS_HERMITIAN_INDEFINITE
depending on your matrix's type.
This routine supports the Progress Routine feature. See Progress Function for details.
Input Parameters
handle
Pointer to the data structure storing internal DSS results (
MKL_DSS_HANDLE
).
opt
Parameter to pass the DSS options. The default value is
MKL_DSS_POSITIVE_DEFINITE
.
rValues
Array of elements of the matrix
A
. Real data, single or double precision as it is specified by the parameter
opt
in the routine
dss_create
.
cValues
Array of elements of the matrix
A
. Complex data, single or double precision as it is specified by the parameter
opt
in the routine
dss_create
.
Return Values
MKL_DSS_SUCCESS
MKL_DSS_STATE_ERR
MKL_DSS_INVALID_OPTION
MKL_DSS_OPTION_CONFLICT
MKL_DSS_VALUES_ERR
MKL_DSS_OUT_OF_MEMORY
MKL_DSS_ZERO_PIVOT
MKL_DSS_FAILURE
MKL_DSS_MSG_LVL_ERR
MKL_DSS_TERM_LVL_ERR
MKL_DSS_OOC_MEM_ERR
MKL_DSS_OOC_OC_ERR
MKL_DSS_OOC_RW_ERR

Product and Performance Information

1

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