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
Input Parameters#
fact - the factor matrix obtained with
MatGetFactor()mat - the matrix
perm - row and column permutations
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
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().
Fortran Note#
A valid (non-null) info argument must be provided
See Also#
Matrices, Mat, Matrix Factorization, MatFactorInfo, MatGetFactor(), MatLUFactorSymbolic(), MatCholeskyFactor(), MatCholeskyFactorNumeric()
MatGetOrdering()
Level#
developer
Location#
Implementations#
MatCholeskyFactorSymbolic_MUMPS() in src/mat/impls/aij/mpi/mumps/mumps.c
MatCholeskyFactorSymbolic_PaStiX() in src/mat/impls/aij/mpi/pastix/pastix.c
MatCholeskyFactorSymbolic_SuperLU_DIST() in src/mat/impls/aij/mpi/superlu_dist/superlu_dist.c
MatCholeskyFactorSymbolic_SeqAIJ() in src/mat/impls/aij/seq/aijfact.c
MatCholeskyFactorSymbolic_SeqAIJKokkos() in src/mat/impls/aij/seq/kokkos/aijkok.kokkos.cxx
MatCholeskyFactorSymbolic_SeqAIJCUSPARSE() in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu
MatCholeskyFactorSymbolic_SeqAIJHIPSPARSE() in src/mat/impls/aij/seq/seqhipsparse/aijhipsparse.hip.c
MatCholeskyFactorSymbolic_SeqBAIJ() in src/mat/impls/baij/seq/baijfact.c
MatCholeskyFactorSymbolic_SeqDense() in src/mat/impls/dense/seq/dense.c
MatCholeskyFactorSymbolic_Elemental() in src/mat/impls/elemental/matelem.cxx
MatCholeskyFactorSymbolic_Htool() in src/mat/impls/htool/htool.cxx
MatCholeskyFactorSymbolic_CHOLMOD() in src/mat/impls/sbaij/seq/cholmod/sbaijcholmod.c
MatCholeskyFactorSymbolic_SeqSBAIJ() in src/mat/impls/sbaij/seq/sbaijfact.c
MatCholeskyFactorSymbolic_ScaLAPACK() in src/mat/impls/scalapack/matscalapack.c
MatCholeskyFactorSymbolic_HT() in src/mat/impls/transpose/htransm.c
MatCholeskyFactorSymbolic_Transpose() in src/mat/impls/transpose/transm.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages