# MatQRFactorSymbolic
Performs symbolic QR factorization of matrix. Call this routine after `MatGetFactor()` but before calling `MatQRFactorNumeric()`. 
## Synopsis
```
#include "petscmat.h" 
PetscErrorCode MatQRFactorSymbolic(Mat fact, Mat mat, IS col, const MatFactorInfo *info)
```
Collective on fact


## Input Parameters

- ***fact -*** the factor matrix obtained with `MatGetFactor()`
- ***mat -*** the matrix
- ***col -*** column permutation
- ***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
```

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), `MatGetFactor()`, `MatFactorInfo`, `MatQRFactor()`, `MatQRFactorNumeric()`, `MatLUFactor()`, `MatFactorInfo`, `MatFactorInfoInitialize()`

## Level
developer

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

## Implementations

<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/aij/seq/spqr/aijspqr.c.html#MatQRFactorSymbolic_SPQR">MatQRFactorSymbolic_SPQR in src/mat/impls/aij/seq/spqr/aijspqr.c</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/mat/impls/dense/seq/dense.c.html#MatQRFactorSymbolic_SeqDense">MatQRFactorSymbolic_SeqDense in src/mat/impls/dense/seq/dense.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)  
