petsc-3.7.3 2016-08-01

VecScatterCreateToAll

Creates a vector and a scatter context that copies all vector values to each processor

Synopsis

#include "petscvec.h"    
PetscErrorCode  VecScatterCreateToAll(Vec vin,VecScatter *ctx,Vec *vout)

Collective on Vec

Input Parameter

vin -input MPIVEC

Output Parameter

	ctx	- scatter context
	vout	- output SEQVEC that is large enough to scatter into

Note: vout may be NULL [NULL_OBJECT from fortran] if you do not need to have it created

Usage

       VecScatterCreateToAll(vin,&ctx,&vout);

       // scatter as many times as you need

       VecScatterBegin(ctx,vin,vout,INSERT_VALUES,SCATTER_FORWARD);

       VecScatterEnd(ctx,vin,vout,INSERT_VALUES,SCATTER_FORWARD);

       // destroy scatter context and local vector when no longer needed

       VecScatterDestroy(&ctx);

       VecDestroy(&vout);

Do NOT create a vector and then pass it in as the final argument vout! vout is created by this routine automatically (unless you pass NULL in for that argument if you do not need it).

Examples