Developer Reference

  • 0.9
  • 09/09/2020
  • Public Content
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

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