#include "petscvec.h" PetscErrorCode VecScatterBegin(VecScatter inctx,Vec x,Vec y,InsertMode addv,ScatterMode mode)Neighbor-wise Collective on VecScatter and Vec Many br
inctx | - scatter context generated by VecScatterCreate() Many br | |
x | - the vector from which we scatter Many br | |
y | - the vector to which we scatter Many br | |
addv | - either ADD_VALUES or INSERT_VALUES, with INSERT_VALUES mode any location Many brnot scattered to retains its old value; i.e. the vector is NOT first zeroed. Many br | |
mode | - the scattering mode, usually SCATTER_FORWARD. The available modes are: Many brSCATTER_FORWARD or SCATTER_REVERSE Many br |
Many br
Options Database: See VecScatterCreate() Many br
You cannot change the values in the input vector between the calls to VecScatterBegin() Many brand VecScatterEnd(). Many br
If you use SCATTER_REVERSE the two arguments x and y should be reversed, from Many brthe SCATTER_FORWARD. Many br
y[iy[i]] = x[ix[i]], for i=0,...,ni-1 Many br
This scatter is far more general than the conventional Many brscatter, since it can be a gather or a scatter or a combination, Many brdepending on the indices ix and iy. If x is a parallel vector and y Many bris sequential, VecScatterBegin() can serve to gather values to a Many brsingle processor. Similarly, if y is parallel and x sequential, the Many brroutine can scatter from one processor to many processors. Many br
Level:intermediate
Location:src/vec/vec/utils/vscat.c
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages