Function

SparseFactor

Returns the factorization of a sparse matrix of double-precision values corresponding to the supplied symbolic factorization using specified options.

Declaration

SparseOpaqueFactorization_Double SparseFactor(SparseOpaqueSymbolicFactorization symbolicFactor, SparseMatrix_Double Matrix, SparseNumericFactorOptions nfoptions, void *factorStorage, void *workspace);

Parameters

SymbolicFactor

A symbolic factorization, as returned by a call of the form SparseFactor.

Matrix

The matrix to factorize.

nfoptions

Numeric factor options, for example for example pivoting parameters.

factorStorage

A pointer to space used to store the factorization of size at least factorSize_Double bytes. This storage should not be altered by the user during the lifetime of the return value.

workspace

A pointer to a workspace of size at least workspaceSize_Double bytes. This workspace may be reused or destroyed by the user as soon as the function returns.

Return Value

A SparseOpaqueFactorization_Double structure representing the matrix factorization.

Discussion

Note that internal memory allocations may occur in the case of pivoted factorizations that result in delayed pivots. If you require closer control over memory allocations, supply a malloc function that implements the required behavior, or use an alternative non-pivoted factorization returns. Note that if malloc returns NULL the factorization will abort immediately.

See Also

Matrix Factorizations with User-Defined Workspace

SparseFactor

Returns the factorization of a sparse matrix of single-precision values corresponding to the supplied symbolic factorization using specified options.