petsc-3.3-p7 2013-05-11

DMDAGetGhostCorners

Returns the global (x,y,z) indices of the lower left corner of the local region, including ghost points.

Synopsis

#include "petscdmda.h"   
PetscErrorCode  DMDAGetGhostCorners(DM da,PetscInt *x,PetscInt *y,PetscInt *z,PetscInt *m,PetscInt *n,PetscInt *p)
Not Collective

Input Parameter

da -the distributed array

Output Parameters

x,y,z - the corner indices (where y and z are optional; these are used for 2D and 3D problems)
m,n,p - widths in the corresponding directions (where n and p are optional; these are used for 2D and 3D problems)

Note

The corner information is independent of the number of degrees of freedom per node set with the DMDACreateXX() routine. Thus the x, y, z, and m, n, p can be thought of as coordinates on a logical grid, where each grid point has (potentially) several degrees of freedom. Any of y, z, n, and p can be passed in as PETSC_NULL if not needed.

Keywords

distributed array, get, ghost, corners, nodes, local indices

See Also

DMDAGetCorners(), DMDACreate1d(), DMDACreate2d(), DMDACreate3d(), DMDAGetOwnershipRanges()

Level:beginner
Location:
src/dm/impls/da/daghost.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/mat/examples/tutorials/ex14.c.html
src/dm/examples/tutorials/ex6.c.html
src/dm/examples/tutorials/ex6f90.F.html
src/ksp/ksp/examples/tutorials/ex42.c.html
src/ksp/ksp/examples/tutorials/ex43.c.html
src/ksp/ksp/examples/tutorials/ex49.c.html
src/ksp/ksp/examples/tutorials/ex14f.F.html
src/snes/examples/tutorials/ex48.c.html
src/snes/examples/tutorials/ex61.c.html
src/snes/examples/tutorials/ex65.c.html
src/snes/examples/tutorials/ex5f.F.html