# MatCholeskyFactorSymbolic
Performs symbolic Cholesky factorization of a symmetric matrix. 
## Synopsis
```
#include "petscmat.h" 
PetscErrorCode MatCholeskyFactorSymbolic(Mat fact, Mat mat, IS perm, const MatFactorInfo *info)
```
Collective on fact


## Input Parameters

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


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


## Notes
See `MatLUFactorSymbolic()` for the nonsymmetric case.  See also
`MatCholeskyFactor()` and `MatCholeskyFactorNumeric()`.

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()`.




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


## See Also
 [Matrix Factorization](sec_matfactor), `MatFactorInfo`, `MatGetFactor()`, `MatLUFactorSymbolic()`, `MatCholeskyFactor()`, `MatCholeskyFactorNumeric()`
`MatGetOrdering()`

## Level
developer

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

## Implementations

<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/clique/clique.cxx.html#MatCholeskyFactorSymbolic_SparseElemental">MatCholeskyFactorSymbolic_SparseElemental in src/mat/impls/aij/mpi/clique/clique.cxx</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/mpi/mumps/mumps.c.html#MatCholeskyFactorSymbolic_MUMPS">MatCholeskyFactorSymbolic_MUMPS 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#MatCholeskyFactorSymbolic_SBAIJPASTIX">MatCholeskyFactorSymbolic_SBAIJPASTIX in src/mat/impls/aij/mpi/pastix/pastix.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/aijfact.c.html#MatCholeskyFactorSymbolic_SeqAIJ">MatCholeskyFactorSymbolic_SeqAIJ in src/mat/impls/aij/seq/aijfact.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu.html#MatCholeskyFactorSymbolic_SeqAIJCUSPARSE">MatCholeskyFactorSymbolic_SeqAIJCUSPARSE in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.c.html#MatCholeskyFactorSymbolic_SeqAIJHIPSPARSE">MatCholeskyFactorSymbolic_SeqAIJHIPSPARSE in src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/baij/seq/baijfact.c.html#MatCholeskyFactorSymbolic_SeqBAIJ">MatCholeskyFactorSymbolic_SeqBAIJ in src/mat/impls/baij/seq/baijfact.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/dense/seq/dense.c.html#MatCholeskyFactorSymbolic_SeqDense">MatCholeskyFactorSymbolic_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#MatCholeskyFactorSymbolic_Elemental">MatCholeskyFactorSymbolic_Elemental in src/mat/impls/elemental/matelem.cxx</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/sbaij/seq/cholmod/sbaijcholmod.c.html#MatCholeskyFactorSymbolic_CHOLMOD">MatCholeskyFactorSymbolic_CHOLMOD in src/mat/impls/sbaij/seq/cholmod/sbaijcholmod.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/sbaij/seq/sbaijfact.c.html#MatCholeskyFactorSymbolic_SeqSBAIJ">MatCholeskyFactorSymbolic_SeqSBAIJ in src/mat/impls/sbaij/seq/sbaijfact.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/scalapack/matscalapack.c.html#MatCholeskyFactorSymbolic_ScaLAPACK">MatCholeskyFactorSymbolic_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)  
