DMDALocalInfo — PETSc 3.21.4 documentation

Skip to main content
`Ctrl`+`K`

# DMDALocalInfo

C struct that contains information about a structured grid and a processes logical location in it.

## Synopsis

    typedef struct {
      PetscInt        dim, dof, sw;
      PetscInt        mx, my, mz;    /* global number of grid points in each direction */
      PetscInt        xs, ys, zs;    /* starting point of this processor, excluding ghosts */
      PetscInt        xm, ym, zm;    /* number of grid points on this processor, excluding ghosts */
      PetscInt        gxs, gys, gzs; /* starting point of this processor including ghosts */
      PetscInt        gxm, gym, gzm; /* number of grid points on this processor including ghosts */
      DMBoundaryType  bx, by, bz;    /* type of ghost nodes at boundary */
      DMDAStencilType st;
      DM              da;
    } DMDALocalInfo;

## Fortran Note

This should be declared as

    `DMDALocalInfo` :: info(DMDA_LOCAL_INFO_SIZE)

and the entries accessed via

        info(DMDA_LOCAL_INFO_DIM)
        info(DMDA_LOCAL_INFO_DOF) etc.

The entries bx,by,bz, st, and da are not accessible from Fortran.

## See Also

DM Basics, `DMDA`, `DMDACreate1d()`, `DMDACreate2d()`, `DMDACreate3d()`, `DMDestroy()`, `DM`, `DMDAGetLocalInfo()`, `DMDAGetInfo()`

## Level

beginner

## Location

include/petscdmdatypes.h

## Examples

src/ksp/ksp/tutorials/ex46.c
src/snes/tutorials/ex35.c
src/dm/tutorials/ex25.c
src/snes/tutorials/ex28.c
src/dm/tutorials/ex14.c
src/snes/tutorials/ex9.c
src/snes/tutorials/ex15.c
src/dm/tutorials/ex51.c
src/snes/tutorials/ex19.c
src/dm/tutorials/ex2.c

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