MatFactorGetErrorZeroPivot#
returns the pivot value that was determined to be zero and the row it occurred in
Synopsis#
#include "petscmat.h"
PetscErrorCode MatFactorGetErrorZeroPivot(Mat mat, PetscReal *pivot, PetscInt *row)
Logically Collective
Input Parameter#
mat - the factored matrix
Output Parameters#
pivot - the pivot value computed
row - the row that the zero pivot occurred. This row value must be interpreted carefully due to row reorderings and which processes the share the matrix
Notes#
This routine does not work for factorizations done with external packages.
This routine should only be called if MatGetFactorError()
returns a value of MAT_FACTOR_NUMERIC_ZEROPIVOT
This can also be called on non-factored matrices that come from, for example, matrices used in SOR.
See Also#
Matrices, Mat
, MatZeroEntries()
, MatFactor()
, MatGetFactor()
,
MatLUFactorSymbolic()
, MatCholeskyFactorSymbolic()
, MatFactorClearError()
,
MAT_FACTOR_NUMERIC_ZEROPIVOT
Level#
advanced
Location#
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages