DMGlobalToLocalBegin

Begins updating local vectors from global vector

Synopsis

#include "petscdm.h"          
#include "petscdmlabel.h"     
#include "petscds.h"     
PetscErrorCode DMGlobalToLocalBegin(DM dm, Vec g, InsertMode mode, Vec l)

Neighbor-wise Collective

Input Parameters

• dm - the DM object

• g - the global vector

• mode - INSERT_VALUES or ADD_VALUES

• l - the local vector

Notes

The operation is completed with DMGlobalToLocalEnd()

One can perform local computations between the DMGlobalToLocalBegin() and DMGlobalToLocalEnd() to overlap communication and computation

DMGlobalToLocal() is a short form of DMGlobalToLocalBegin() and DMGlobalToLocalEnd()

DMGlobalToLocalHookAdd() may be used to provide additional operations that are performed during the update process.

See Also

DM Basics, DM, DMCoarsen(), DMDestroy(), DMView(), DMCreateGlobalVector(), DMCreateInterpolation(), DMGlobalToLocal(), DMGlobalToLocalEnd(), DMLocalToGlobalBegin(), DMLocalToGlobal(), DMLocalToGlobalEnd()

Level

intermediate

Location

src/dm/interface/dm.c

Examples

src/snes/tutorials/ex63.c
src/snes/tutorials/ex12.c
src/snes/tutorials/ex13.c
src/snes/tutorials/ex78.c
src/snes/tutorials/ex35.c
src/snes/tutorials/ex18.c
src/snes/tutorials/ex36.c
src/snes/tutorials/ex28.c
src/snes/tutorials/ex15.c
src/snes/tutorials/ex14.c

Implementations

DMGlobalToLocalBegin_Composite() in src/dm/impls/composite/pack.c
DMGlobalToLocalBegin_DA() in src/dm/impls/da/dagtol.c
DMGlobalToLocalBegin_Moab() in src/dm/impls/moab/dmmbvec.cxx
DMGlobalToLocalBegin_Network() in src/dm/impls/network/network.c
DMGlobalToLocalBegin_Redundant() in src/dm/impls/redundant/dmredundant.c
DMGlobalToLocalBegin_Sliced() in src/dm/impls/sliced/sliced.c
DMGlobalToLocalBegin_Stag() in src/dm/impls/stag/stag.c
DMGlobalToLocalBegin_Swarm() in src/dm/impls/swarm/swarm.c

---

Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages