Skip to main content
`Ctrl`+`K`

# MatLUFactorNumeric

Performs numeric LU factorization of a matrix. Call this routine after first calling `MatLUFactorSymbolic()` and `MatGetFactor()`.

## Synopsis

    #include "petscmat.h"
    PetscErrorCode MatLUFactorNumeric(Mat fact, Mat mat, const MatFactorInfo *info)

Collective

## Input Parameters

- fact - the factor matrix obtained with `MatGetFactor()`

- mat - the matrix

- info - options for factorization

## Notes

See `MatLUFactor()` for in-place factorization. See `MatCholeskyFactorNumeric()` for the symmetric, positive definite case.

Most users should employ the `KSP` interface for linear solvers instead of working directly with matrix algebra routines such as this. See, e.g., `KSPCreate()`.

## Fortran Note

A valid (non-null) `info` argument must be provided

## See Also

Matrices, `Mat`, Matrix Factorization, `MatGetFactor()`, `MatFactorInfo`, `MatLUFactorSymbolic()`, `MatLUFactor()`, `MatCholeskyFactor()`

## Level

developer

## Location

src/mat/interface/matrix.c

## Implementations

MatLUFactorNumeric_PaStiX() in src/mat/impls/aij/mpi/pastix/pastix.c
MatLUFactorNumeric_STRUMPACK() in src/mat/impls/aij/mpi/strumpack/strumpack.c
MatLUFactorNumeric_SuperLU_DIST() in src/mat/impls/aij/mpi/superlu_dist/superlu_dist.c
MatLUFactorNumeric_SeqAIJ() in src/mat/impls/aij/seq/aijfact.c
MatLUFactorNumeric_Essl() in src/mat/impls/aij/seq/essl/essl.c
MatLUFactorNumeric_KLU() in src/mat/impls/aij/seq/klu/klu.c
MatLUFactorNumeric_SeqAIJKokkos() in src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx
MatLUFactorNumeric_LUSOL() in src/mat/impls/aij/seq/lusol/lusol.c
MatLUFactorNumeric_Matlab() in src/mat/impls/aij/seq/matlab/aijmatlab.c
MatLUFactorNumeric_SeqAIJCUSPARSE() in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu
MatLUFactorNumeric_SeqAIJHIPSPARSE() in src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.cxx
MatLUFactorNumeric_SuperLU() in src/mat/impls/aij/seq/superlu/superlu.c
MatLUFactorNumeric_UMFPACK() in src/mat/impls/aij/seq/umfpack/umfpack.c
MatLUFactorNumeric_SeqDense() in src/mat/impls/dense/seq/dense.c
MatLUFactorNumeric_Elemental() in src/mat/impls/elemental/matelem.cxx
MatLUFactorNumeric_ScaLAPACK() in src/mat/impls/scalapack/matscalapack.c
MatLUFactorNumeric_HT() in src/mat/impls/transpose/htransm.c
MatLUFactorNumeric_Transpose() in src/mat/impls/transpose/transm.c

Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages