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

Input Parameters#

  • fact - the factor matrix obtained with MatGetFactor()

  • mat - the matrix

  • col - column permutation

  • info - options for factorization, includes

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

Note#

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 interface definition cannot be generated correctly [due to MatFactorInfo]

See Also#

Matrices, Mat, Matrix Factorization, MatGetFactor(), MatFactorInfo, MatQRFactor(), MatQRFactorNumeric(), MatLUFactor(), MatFactorInfoInitialize()

Level#

developer

Location#

src/mat/interface/matrix.c

Implementations#

MatQRFactorSymbolic_SPQR() in src/mat/impls/aij/seq/spqr/aijspqr.c
MatQRFactorSymbolic_SeqDense() in src/mat/impls/dense/seq/dense.c


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