dss_factor_real , dss_factor

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

dss_factor_real , dss_factor_complex

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

Syntax

MKL_INTdss_factor_real ( _MKL_DSS_HANDLE_t *handle , MKL_INT const *opt , void const *rValues )

MKL_INTdss_factor_complex ( _MKL_DSS_HANDLE_t *handle , MKL_INT const *opt , void const *cValues )

Include Files

mkl.h

Description

dss_factor_real dss_factor_complex dss_factor These routines compute factorization of the matrix whose non-zero locations were previously specified by a call to dss_define_structure (Communicates locations of non-zero elements in the matrix to the solver.) 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 .

NOTE:

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: TYPE (MKL_DSS_HANDLE) , INTENT(INOUT) Pointer to the data structure storing internal DSS results ( MKL_DSS_HANDLE ).
opt: INTEGER , INTENT(IN) Parameter to pass the DSS options. The default value is MKL_DSS_POSITIVE_DEFINITE .
rValues: REAL*8 REAL(KIND=4) , INTENT(IN) or REAL(KIND=8) , INTENT(IN) 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: COMPLEX*16 COMPLEX(KIND=4) , INTENT(IN) or COMPLEX(KIND=8) , INTENT(IN) 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 .
Values: REAL(KIND=4) , INTENT(OUT) , or REAL(KIND=8) , INTENT(OUT) , or COMPLEX(KIND=4) , INTENT(OUT) , or COMPLEX(KIND=8) , INTENT(OUT) Array of elements of the matrix A . Real or 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

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in