MatZeroRowsColumnsLocalIS#

Zeros all entries (except possibly the main diagonal) of a set of rows and columns of a matrix; using local numbering of rows.

Synopsis#

#include "petscmat.h" 
PetscErrorCode MatZeroRowsColumnsLocalIS(Mat mat, IS is, PetscScalar diag, Vec x, Vec b)

Collective

Input Parameters#

  • mat - the matrix

  • is - index set of rows to remove

  • diag - value put in all diagonals of eliminated rows

  • x - optional vector of solutions for zeroed rows (other entries in vector are not used)

  • b - optional vector of right-hand side, that will be adjusted by provided solution

Notes#

Before calling MatZeroRowsColumnsLocalIS(), the user must first set the local-to-global mapping by calling MatSetLocalToGlobalMapping(), this is often already set for matrices obtained with DMCreateMatrix().

See MatZeroRowsColumns() for details on how this routine operates.

See Also#

Matrices, Mat, MatZeroRowsIS(), MatZeroRowsColumns(), MatZeroRowsLocalIS(), MatZeroRowsStencil(), MatZeroEntries(), MatZeroRowsLocal(), MatSetOption(), MatZeroRowsColumnsLocal(), MatZeroRows(), MatZeroRowsColumnsIS(), MatZeroRowsColumnsStencil()

Level#

intermediate

Location#

src/mat/interface/matrix.c

Examples#

src/ksp/ksp/tutorials/ex59.c

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