petsc-3.3-p7 2013-05-11

VecCreateGhostBlock

Creates a parallel vector with ghost padding on each processor. The indicing of the ghost points is done with blocks.

Synopsis

#include "petscvec.h"   
PetscErrorCode  VecCreateGhostBlock(MPI_Comm comm,PetscInt bs,PetscInt n,PetscInt N,PetscInt nghost,const PetscInt ghosts[],Vec *vv)

Collective on MPI_Comm

Input Parameters

	comm	- the MPI communicator to use
	bs	- the block size
	n	- local vector length
	N	- global vector length (or PETSC_DECIDE to have calculated if n is given)
	nghost	- number of local ghost blocks
	ghosts	- global indices of ghost blocks, counts are by block, not by individual index

Output Parameter

vv -the global vector representation (without ghost points as part of vector)

Notes

Use VecGhostGetLocalForm() to access the local, ghosted representation of the vector.

n is the local vector size (total local size not the number of blocks) while nghost is the number of blocks in the ghost portion, i.e. the number of elements in the ghost portion is bs*nghost

Examples