VecGhostUpdateBegin#
Begins the vector scatter to update the vector from local representation to global or global representation to local.
Synopsis#
#include "petscvec.h"
PetscErrorCode VecGhostUpdateBegin(Vec g, InsertMode insertmode, ScatterMode scattermode)
Neighbor-wise Collective
Input Parameters#
g - the vector (obtained with
VecCreateGhost()
orVecDuplicate()
)insertmode - one of
ADD_VALUES
,MAX_VALUES
,MIN_VALUES
orINSERT_VALUES
scattermode - one of
SCATTER_FORWARD
orSCATTER_REVERSE
Notes#
Use the following to update the ghost regions with correct values from the owning process
Use the following to accumulate the ghost region values onto the owning processors
To accumulate the ghost region values onto the owning processors and then update the ghost regions correctly, call the latter followed by the former, i.e.,
See Also#
Vectors and Parallel Data, Vec
, VecType
, VecCreateGhost()
, VecGhostUpdateEnd()
, VecGhostGetLocalForm()
,
VecGhostRestoreLocalForm()
, VecCreateGhostWithArray()
Level#
advanced
Location#
Examples#
src/vec/vec/tutorials/ex14f.F90
src/vec/vec/tutorials/ex9.c
src/vec/vec/tutorials/ex9f.F90
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages