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

DMLocalToLocalBegin

Maps from a local vector (including ghost points that contain irrelevant values) to another local vector where the ghost points in the second are set correctly. Must be followed by DMLocalToLocalEnd().

Synopsis

#include "petscdm.h"          
#include "petscdmlabel.h"     
PetscErrorCode  DMLocalToLocalBegin(DM dm,Vec g,InsertMode mode,Vec l)
Neighbor-wise Collective on DM and Vec Many br

Input Parameters

dm - the DM object Many br
g - the original local vector Many br
mode - one of INSERT_VALUES or ADD_VALUES Many br

Output Parameter

l -the local vector with correct ghost values Many br

Many br

Notes

The local vectors used here need not be the same as those Many brobtained from DMCreateLocalVector(), BUT they Many brmust have the same parallel data layout; they could, for example, be Many brobtained with VecDuplicate() from the DM originating vectors. Many br

Keywords

DM, local-to-local, begin

See Also

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

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

Examples

src/dm/examples/tutorials/ex13f90.F90.html