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

VecStrideGather

Gathers a single component from a multi-component vector into another vector.

Synopsis

#include "petscvec.h" 
PetscErrorCode  VecStrideGather(Vec v,PetscInt start,Vec s,InsertMode addv)
Collective on Vec Many br

Input Parameter

v - the vector Many br
start - starting point of the subvector (defined by a stride) Many br
addv - one of ADD_VALUES,INSERT_VALUES,MAX_VALUES Many br

Output Parameter

s -the location where the subvector is stored Many br

Notes

One must call VecSetBlockSize() before this routine to set the stride Many brinformation, or use a vector created from a multicomponent DMDA. Many br

If x is the array representing the vector x then this gathers Many brthe array (x[start],x[start+stride],x[start+2*stride], ....) Many br

The parallel layout of the vector and the subvector must be the same; Many bri.e., nlocal of v = stride*(nlocal of s) Many br

Not optimized; could be easily Many br

Many br

See Also

VecStrideNorm(), VecStrideScatter(), VecStrideMin(), VecStrideMax(), VecStrideGatherAll(),
VecStrideScatterAll() Many br

Level:advanced
Location:
src/vec/vec/utils/vinv.c
Index of all Vec routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/vec/vec/examples/tutorials/ex12.c.html
src/vec/vec/examples/tutorials/ex16.c.html