petsc-3.12.5 2020-03-29
Report Typos and Errors

DMStagGetOwnershipRanges

get elements per rank in each direction

Synopsis

PetscErrorCode DMStagGetOwnershipRanges(DM dm,const PetscInt *lx[],const PetscInt *ly[],const PetscInt *lz[])
Not Collective

Input Parameter

dm -the DMStag object

Output Parameters

lx - ownership along x direction (optional)
ly - ownership along y direction (optional)
lz - ownership along z direction (optional)

Notes

These correspond to the optional final arguments passed to DMStagCreate1d(), DMStagCreate2d(), and DMStagCreate3d().

Arguments corresponding to higher dimensions are ignored for 1D and 2D grids. These arguments may be set to NULL in this case.

In C you should not free these arrays, nor change the values in them. They will only have valid values while the DMStag they came from still exists (has not been destroyed).

See Also

DMSTAG, DMStagSetGlobalSizes(), DMStagSetOwnershipRanges(), DMStagCreate1d(), DMStagCreate2d(), DMStagCreate3d(), DMDAGetOwnershipRanges()

Level

intermediate

Location

src/dm/impls/stag/stagutils.c
Index of all DMSTAG routines
Table of Contents for all manual pages
Index of all manual pages