petsc-3.7.1 2016-05-15
Report Typos and Errors

DMDAGetOwnershipRanges

Gets the ranges of indices in the x, y and z direction that are owned by each process

Synopsis

#include "petscdmda.h"   
PetscErrorCode  DMDAGetOwnershipRanges(DM da,const PetscInt *lx[],const PetscInt *ly[],const PetscInt *lz[])
Not Collective Many br

Input Parameter

da - the DMDA object Many br

Output Parameter

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

Many br

Note: these correspond to the optional final arguments passed to DMDACreate(), DMDACreate2d(), DMDACreate3d() Many br

In Fortran one must pass in arrays lx, ly, and lz that are long enough to hold the values; the sixth, seventh and Many breighth arguments from DMDAGetInfo() Many br

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

These numbers are NOT multiplied by the number of dof per node. Many br

See Also

DMDAGetCorners(), DMDAGetGhostCorners(), DMDACreate(), DMDACreate1d(), DMDACreate2d(), DMDACreate3d(), VecGetOwnershipRanges()

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

Examples

src/dm/examples/tutorials/ex51.c.html
src/ksp/ksp/examples/tutorials/ex42.c.html
src/snes/examples/tutorials/ex28.c.html
src/ts/examples/tutorials/ex10.c.html