petsc-3.7.3 2016-08-01

DMCompositeGetAccess

Allows one to access the individual packed vectors in their global representation.

Synopsis

#include "petscdmcomposite.h"  
PetscErrorCode  DMCompositeGetAccess(DM dm,Vec gvec,...)

Collective on DMComposite

Input Parameters

	dm	- the packer object
	gvec	- the global vector

Output Parameters

Vec* ... -the packed parallel vectors, NULL for those that are not needed

Notes: Use DMCompositeRestoreAccess() to return the vectors when you no longer need them

Fortran Notes

Fortran callers must use numbered versions of this routine, e.g., DMCompositeGetAccess4(dm,gvec,vec1,vec2,vec3,vec4) or use the alternative interface DMCompositeGetAccessArray().

Examples