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#

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