petsc-3.14.5 2021-03-03
Report Typos and Errors

# DMDAGetInfo

Gets information about a given distributed array.

### Synopsis

    #include "petscdmda.h"
    PetscErrorCode  DMDAGetInfo(DM da,PetscInt *dim,PetscInt *M,PetscInt *N,PetscInt *P,PetscInt *m,PetscInt *n,PetscInt *p,PetscInt *dof,PetscInt *s,DMBoundaryType *bx,DMBoundaryType *by,DMBoundaryType *bz,DMDAStencilType *st)

Not Collective

### Input Parameter

| da | - the distributed array

### Output Parameters

| dim | - dimension of the distributed array (1, 2, or 3)
| M, N, P | - global dimension in each direction of the array
| m, n, p | - corresponding number of procs in each dimension
| dof | - number of degrees of freedom per node
| s | - stencil width
| bx,by,bz | - type of ghost nodes at boundary, one of DM_BOUNDARY_NONE, DM_BOUNDARY_GHOSTED, DM_BOUNDARY_MIRROR, DM_BOUNDARY_PERIODIC
| st | - stencil type, either DMDA_STENCIL_STAR or DMDA_STENCIL_BOX

### Note

Use NULL (NULL_INTEGER in Fortran) in place of any output parameter that is not of interest.

### See Also

DMView(), DMDAGetCorners(), DMDAGetLocalInfo()

### Level

beginner

### Location

src/dm/impls/da/daview.c

### Examples

src/dm/tutorials/ex15.c.html
src/dm/tutorials/swarm_ex3.c.html
src/ksp/ksp/tutorials/ex25.c.html
src/ksp/ksp/tutorials/ex28.c.html
src/ksp/ksp/tutorials/ex29.c.html
src/ksp/ksp/tutorials/ex32.c.html
src/ksp/ksp/tutorials/ex34.c.html
src/ksp/ksp/tutorials/ex42.c.html
src/ksp/ksp/tutorials/ex43.c.html
src/ksp/ksp/tutorials/ex45.c.html
src/ksp/ksp/tutorials/ex49.c.html
Index of all DMDA routines
Table of Contents for all manual pages
Index of all manual pages