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#
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