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#

src/mat/interface/matrix.c


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