petsc-3.9.4 2018-09-11

DMDAGetGhostCorners

Returns the global (x,y,z) indices of the lower left corner and size 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 NULL if not needed.

Keywords

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

Level

beginner

Location

src/dm/impls/da/daghost.c

Examples