DMLocalToLocalBegin

Begins the process of mapping values from a local vector (that include ghost points that contain irrelevant values) to another local vector where the ghost points in the second are set correctly from values on other MPI ranks.

Synopsis

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

Neighbor-wise Collective

Input Parameters

• dm - the DM object

• g - the original local vector

• mode - one of INSERT_VALUES or ADD_VALUES

Output Parameter

• l - the local vector with correct ghost values

Note

Must be followed by DMLocalToLocalEnd().

See Also

DM Basics, DM, DMLocalToLocalEnd(), DMCoarsen(), DMDestroy(), DMView(), DMCreateLocalVector(), DMCreateGlobalVector(), DMCreateInterpolation(), DMGlobalToLocalEnd(), DMLocalToGlobalBegin()

Level

intermediate

Location

src/dm/interface/dm.c

Examples

src/dm/tutorials/ex13f90.F90

Implementations

DMLocalToLocalBegin_Composite() in src/dm/impls/composite/pack.c
DMLocalToLocalBegin_DA() in src/dm/impls/da/daltol.c
DMLocalToLocalBegin_Stag() in src/dm/impls/stag/stag.c

---

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