DMGlobalToLocal#
update local vectors from global vector
Synopsis#
#include "petscdm.h"
#include "petscdmlabel.h"
#include "petscds.h"
PetscErrorCode DMGlobalToLocal(DM dm, Vec g, InsertMode mode, Vec l)
Neighbor-wise Collective on dm
Input Parameters#
dm - the
DMobjectg - the global vector
mode -
INSERT_VALUESorADD_VALUESl - the local vector
Notes#
The communication involved in this update can be overlapped with computation by instead using
DMGlobalToLocalBegin() and DMGlobalToLocalEnd().
DMGlobalToLocalHookAdd() may be used to provide additional operations that are performed during the update process.
See Also#
DM, DMGlobalToLocalHookAdd(), DMCoarsen(), DMDestroy(), DMView(), DMCreateGlobalVector(), DMCreateInterpolation(),
DMGlobalToLocalEnd(), DMLocalToGlobalBegin(), DMLocalToGlobal(), DMLocalToGlobalBegin(), DMLocalToGlobalEnd(),
DMGlobalToLocalBegin() DMGlobalToLocalEnd()
Level#
beginner
Location#
Examples#
src/dm/impls/stag/tutorials/ex1.c.html
src/dm/impls/stag/tutorials/ex3.c.html
src/dm/impls/stag/tutorials/ex4.c.html
src/dm/impls/stag/tutorials/ex6.c.html
src/dm/tutorials/ex2.c.html
src/snes/tutorials/ex3k.kokkos.cxx.html
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages