MatStencil#

Data structure (C struct) for storing information about rows and columns of a matrix as indexed on an associated grid. These are arguments to MatSetStencil() and MatSetBlockStencil()

Synopsis#

typedef struct {
  PetscInt k, j, i, c;
} MatStencil;

Notes#

The i,j, and k represent the logical coordinates over the entire grid (for 2 and 1 dimensional problems the k and j entries are ignored). The c represents the degrees of freedom at each grid point (the dof argument to DMDASetDOF()). If dof is 1 then this entry is ignored.

For stencil access to vectors see DMDAVecGetArray(), DMDAVecGetArrayF90().

For staggered grids, see DMStagStencil

Fortran Note#

See MatSetValuesStencil() for details.

See Also#

Matrices, Mat, MatSetValuesStencil(), MatSetStencil(), MatSetValuesBlockedStencil(), DMDAVecGetArray(), DMDAVecGetArrayF90(), DMStagStencil

Level#

beginner

Location#

include/petscmat.h

Examples#

src/dm/tutorials/ex22.c
src/dm/tutorials/ex14.c
src/dm/impls/stag/tutorials/ex1.c
src/snes/tutorials/ex5.c
src/snes/tutorials/ex9.c
src/tao/unconstrained/tutorials/minsurf2.c
src/dm/tutorials/ex25.c
src/snes/tutorials/ex15.c
src/snes/tutorials/ex14.c
src/snes/tutorials/ex58.c


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