petsc-3.12.1 2019-10-22
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 dm

### 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