petsc-3.10.5 2019-03-28
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

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

Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages