Direct Sparse Solver (DSS) Interface Routines
Intel® oneAPI Math Kernel Library
Intel® oneAPI Math Kernel Library
The DSS interface also supports the out-of-core (OOC) mode.
Table
"DSS Interface Routines"
lists the names of the routines and describes their general use.
Routine
| Description
|
---|---|
Initializes the solver and creates the basic data structures necessary for the solver. This routine must be called before any other DSS routine.
| |
Informs the solver of the locations of the non-zero elements of the matrix.
| |
Based on the non-zero structure of the matrix, computes a permutation vector to reduce fill-in during the factoring process.
| |
Computes the
LU ,
LDL T LL T | |
Computes the solution vector for a system of equations based on the factorization computed in the previous phase.
| |
Deletes all data structures created during the solving process.
| |
Returns statistics about various phases of the solving process.
|
To find a single solution vector for a single system of equations with a single right-hand side, invoke the
DSS interface routines in this order:
Intel® oneAPI Math Kernel Library
- dss_create
- dss_define_structure
- dss_reorder
- dss_factor_real, dss_factor_complex
- dss_solve_real, dss_solve_complex
- dss_delete
However, in certain applications it is necessary to produce solution vectors for multiple right-hand sides for a given factorization and/or factor several matrices with the same non-zero structure. Consequently, it is sometimes necessary to invoke the
sparse routines in an order other than that listed, which is possible using the DSS interface. The solving process is conceptually divided into six phases.Figure
Intel® oneAPI Math Kernel Library
"Typical order for invoking DSS interface routines"
indicates the typical order in which the DSS interface routines can be invoked.
Typical order for invoking DSS interface routines

See the code examples that use the DSS interface routines to solve systems of linear equations in the
installation directory (
Intel® oneAPI Math Kernel Library
dss_*.c
).
- examples/solverc/source