petsc-3.14.6 2021-03-30
MatLUFactorSymbolic
Performs symbolic LU factorization of matrix. Call this routine before calling MatLUFactorNumeric().
Synopsis
#include "petscmat.h"
PetscErrorCode MatLUFactorSymbolic(Mat fact,Mat mat,IS row,IS col,const MatFactorInfo *info)
Collective on Mat
Input Parameters
| fact | - the factor matrix obtained with MatGetFactor()
|
| mat | - the matrix
|
| row, col | - 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 Users-Manual: ch_mat for additional information about choosing the fill factor for better efficiency.
Most users should employ the simplified KSP interface for linear solvers
instead of working directly with matrix algebra routines such as this.
See, e.g., KSPCreate().
See Also
MatLUFactor(), MatLUFactorNumeric(), MatCholeskyFactor(), MatFactorInfo, MatFactorInfoInitialize()
Developer Note: fortran interface is not autogenerated as the f90
interface defintion cannot be generated correctly [due to MatFactorInfo]
Level
developer
Location
src/mat/interface/matrix.c
Implementations
MatLUFactorSymbolic_AIJMKL_CPARDISO in src/mat/impls/aij/mpi/mkl_cpardiso/mkl_cpardiso.c
MatLUFactorSymbolic_AIJMUMPS in src/mat/impls/aij/mpi/mumps/mumps.c
MatLUFactorSymbolic_BAIJMUMPS in src/mat/impls/aij/mpi/mumps/mumps.c
MatLUFactorSymbolic_AIJPASTIX in src/mat/impls/aij/mpi/pastix/pastix.c
MatLUFactorSymbolic_STRUMPACK in src/mat/impls/aij/mpi/strumpack/strumpack.c
MatLUFactorSymbolic_SuperLU_DIST in src/mat/impls/aij/mpi/superlu_dist/superlu_dist.c
MatLUFactorSymbolic_SeqAIJ_inplace in src/mat/impls/aij/seq/aijfact.c
MatLUFactorSymbolic_SeqAIJ in src/mat/impls/aij/seq/aijfact.c
MatLUFactorSymbolic_Essl in src/mat/impls/aij/seq/essl/essl.c
MatLUFactorSymbolic_KLU in src/mat/impls/aij/seq/klu/klu.c
MatLUFactorSymbolic_LUSOL in src/mat/impls/aij/seq/lusol/lusol.c
MatLUFactorSymbolic_Matlab in src/mat/impls/aij/seq/matlab/aijmatlab.c
MatLUFactorSymbolic_AIJMKL_PARDISO in src/mat/impls/aij/seq/mkl_pardiso/mkl_pardiso.c
MatLUFactorSymbolic_SeqAIJCUSPARSE in src/mat/impls/aij/seq/seqcusparse/aijcusparse.cu
MatLUFactorSymbolic_SuperLU in src/mat/impls/aij/seq/superlu/superlu.c
MatLUFactorSymbolic_UMFPACK in src/mat/impls/aij/seq/umfpack/umfpack.c
MatLUFactorSymbolic_SeqBAIJ in src/mat/impls/baij/seq/baijfact3.c
MatLUFactorSymbolic_SeqBAIJ_inplace in src/mat/impls/baij/seq/baijfact3.c
MatLUFactorSymbolic_SeqDense in src/mat/impls/dense/seq/dense.c
MatLUFactorSymbolic_Elemental in src/mat/impls/elemental/matelem.cxx
MatLUFactorSymbolic_ScaLAPACK in src/mat/impls/scalapack/matscalapack.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages