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/tutorials/ex21.c.html
src/snes/tutorials/ex22.c.html
src/snes/tutorials/ex28.c.html
src/ts/tutorials/ex14.c.html


Edit on GitLab

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