# MatLUFactorSymbolic
Performs symbolic LU factorization of matrix. Call this routine before calling `MatLUFactorNumeric()` and after `MatGetFactor()`. 
## Synopsis
```
#include "petscmat.h" 
PetscErrorCode MatLUFactorSymbolic(Mat fact, Mat mat, IS row, IS col, const MatFactorInfo *info)
```
Collective on fact


## Input Parameters

- ***fact -*** the factor matrix obtained with `MatGetFactor()`
- ***mat -*** the matrix
- ***row, col -*** row and column permutations
- ***info -*** options for factorization, includes


```none
          fill - expected fill as ratio of original fill. Run with the option -info to determine an optimal value to use
          dtcol - pivot tolerance (0 no pivot, 1 full column pivoting)
```





## Notes
See [Matrix Factorization](sec_matfactor) for additional information about factorizations

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


## Developer Note
The Fortran interface is not autogenerated as the
interface definition cannot be generated correctly [due to `MatFactorInfo`]


## See Also
 `Mat`, [Matrix Factorization](sec_matfactor), `MatGetFactor()`, `MatLUFactor()`, `MatLUFactorNumeric()`, `MatCholeskyFactor()`, `MatFactorInfo`, `MatFactorInfoInitialize()`

## Level
developer

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/interface/matrix.c.html#MatLUFactorSymbolic">src/mat/interface/matrix.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ksp/ksp/tutorials/ex52.c.html">src/ksp/ksp/tutorials/ex52.c.html</A><BR>

## Implementations

<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/mumps/mumps.c.html#MatLUFactorSymbolic_AIJMUMPS">MatLUFactorSymbolic_AIJMUMPS in src/mat/impls/aij/mpi/mumps/mumps.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/mumps/mumps.c.html#MatLUFactorSymbolic_BAIJMUMPS">MatLUFactorSymbolic_BAIJMUMPS in src/mat/impls/aij/mpi/mumps/mumps.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/pastix/pastix.c.html#MatLUFactorSymbolic_AIJPASTIX">MatLUFactorSymbolic_AIJPASTIX in src/mat/impls/aij/mpi/pastix/pastix.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/strumpack/strumpack.c.html#MatLUFactorSymbolic_STRUMPACK">MatLUFactorSymbolic_STRUMPACK in src/mat/impls/aij/mpi/strumpack/strumpack.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/aijfact.c.html#MatLUFactorSymbolic_SeqAIJ">MatLUFactorSymbolic_SeqAIJ in src/mat/impls/aij/seq/aijfact.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/essl/essl.c.html#MatLUFactorSymbolic_Essl">MatLUFactorSymbolic_Essl in src/mat/impls/aij/seq/essl/essl.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/klu/klu.c.html#MatLUFactorSymbolic_KLU">MatLUFactorSymbolic_KLU in src/mat/impls/aij/seq/klu/klu.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx.html#MatLUFactorSymbolic_SeqAIJKokkos">MatLUFactorSymbolic_SeqAIJKokkos in src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx.html#MatLUFactorSymbolic_SeqAIJKOKKOSDEVICE">MatLUFactorSymbolic_SeqAIJKOKKOSDEVICE in src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/lusol/lusol.c.html#MatLUFactorSymbolic_LUSOL">MatLUFactorSymbolic_LUSOL in src/mat/impls/aij/seq/lusol/lusol.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/matlab/aijmatlab.c.html#MatLUFactorSymbolic_Matlab">MatLUFactorSymbolic_Matlab in src/mat/impls/aij/seq/matlab/aijmatlab.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu.html#MatLUFactorSymbolic_SeqAIJCUSPARSE">MatLUFactorSymbolic_SeqAIJCUSPARSE in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqcusparse/aijcusparseband.cu.html#MatLUFactorSymbolic_SeqAIJCUSPARSEBAND">MatLUFactorSymbolic_SeqAIJCUSPARSEBAND in src/mat/impls/aij/seq/seqcusparse/aijcusparseband.cu</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.c.html#MatLUFactorSymbolic_SeqAIJHIPSPARSE">MatLUFactorSymbolic_SeqAIJHIPSPARSE in src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqhipsparse/aijhipsparseband.hip.c.html#MatLUFactorSymbolic_SeqAIJHIPSPARSEBAND">MatLUFactorSymbolic_SeqAIJHIPSPARSEBAND in src/mat/impls/aij/seq/seqhipsparse/aijhipsparseband.hip.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/superlu/superlu.c.html#MatLUFactorSymbolic_SuperLU">MatLUFactorSymbolic_SuperLU in src/mat/impls/aij/seq/superlu/superlu.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/umfpack/umfpack.c.html#MatLUFactorSymbolic_UMFPACK">MatLUFactorSymbolic_UMFPACK in src/mat/impls/aij/seq/umfpack/umfpack.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/baij/seq/baijfact3.c.html#MatLUFactorSymbolic_SeqBAIJ">MatLUFactorSymbolic_SeqBAIJ in src/mat/impls/baij/seq/baijfact3.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/dense/seq/dense.c.html#MatLUFactorSymbolic_SeqDense">MatLUFactorSymbolic_SeqDense in src/mat/impls/dense/seq/dense.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/elemental/matelem.cxx.html#MatLUFactorSymbolic_Elemental">MatLUFactorSymbolic_Elemental in src/mat/impls/elemental/matelem.cxx</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/scalapack/matscalapack.c.html#MatLUFactorSymbolic_ScaLAPACK">MatLUFactorSymbolic_ScaLAPACK in src/mat/impls/scalapack/matscalapack.c</A><BR>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/mat/interface/matrix.c)


[Index of all Mat routines](index.md)  
[Table of Contents for all manual pages](/docs/manualpages/index.md)  
[Index of all manual pages](/docs/manualpages/singleindex.md)  
