petsc-3.3-p7 2013-05-11

VecCreateGhostWithArray

Creates a parallel vector with ghost padding on each processor; the caller allocates the array space.

Synopsis

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

Collective on MPI_Comm

Input Parameters

	comm	- the MPI communicator to use
	n	- local vector length
	N	- global vector length (or PETSC_DECIDE to have calculated if n is given)
	nghost	- number of local ghost points
	ghosts	- global indices of ghost points (or PETSC_NULL if not needed)
	array	- the space to store the vector values (as long as n + nghost)

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.

This also automatically sets the ISLocalToGlobalMapping() for this vector.

Examples