VecGhostGetLocalRepresentation

Obtain the local ghosted representation of a parallel vector created with VecCreateGhost().

Synopsis

int VecGhostGetLocalRepresentation(Vec g,Vec *l)
Not Collective

Input Parameter

g -the global vector. Vector must be obtained with either VecCreateGhost(), VecCreateGhostWithArray() or VecCreateSeq().

Output Parameter

l -the local (ghosted) representation

Notes

This routine does not actually update the ghost values, it returns asequential vector that includes the locations for the ghost values and theircurrent values. The returned vector and the original vector passed in sharethe same array that contains the actual vector data.

One should call VecGhostRestoreLocalRepresentation() or VecDestroy() once one isfinished using the object.

Keywords

ghost points, local representation

See Also

VecCreateGhost(), VecGhostRestoreLocalRepresentation(), VecCreateGhostWithArray()

Examples

src/vec/examples/tutorials/ex9.c

Location: src/vec/impls/mpi/pbvec.c
Vector Index
Table of Contents