petsc-3.13.6 2020-09-29

VecStrideGatherAll

Gathers all the single components from a multi-component vector into separate vectors.

#include "petscvec.h" 
PetscErrorCode  VecStrideGatherAll(Vec v,Vec s[],InsertMode addv)

Collective on Vec

	v	- the vector
	addv	- one of ADD_VALUES,INSERT_VALUES,MAX_VALUES

s -the location where the subvectors are stored

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

If x is the array representing the vector x then this gathers the arrays (x[start],x[start+stride],x[start+2*stride], ....) for start=0,1,2,...bs-1

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

Not optimized; could be easily

advanced