petsc-dev 2014-04-18
Report Typos and Errors

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().

See Also

DMCompositeGetEntries(), DMCompositeScatter()

Level:advanced
Location:
src/dm/impls/composite/pack.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/snes/examples/tutorials/ex21.c.html
src/snes/examples/tutorials/ex22.c.html
src/snes/examples/tutorials/ex28.c.html
src/ts/examples/tutorials/ex14.c.html