DMCompositeGetAccessArray#

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

Synopsis#

#include "petscdmcomposite.h"  
PetscErrorCode DMCompositeGetAccessArray(DM dm, Vec pvec, PetscInt nwanted, const PetscInt *wanted, Vec *vecs)

Collective

Input Parameters#

  • dm - the DMCOMPOSITE

  • pvec - packed vector

  • nwanted - number of vectors wanted

  • wanted - sorted array of vectors wanted, or NULL to get all vectors, length nwanted

Output Parameter#

  • vecs - array of requested global vectors (must be previously allocated and of length nwanted)

Note#

Use DMCompositeRestoreAccessArray() to return the vectors when you no longer need them

See Also#

DMCOMPOSITE, DM, DMCompositeGetAccess(), DMCompositeGetEntries(), DMCompositeScatter(), DMCompositeGather()

Level#

advanced

Location#

src/dm/impls/composite/pack.c

Examples#

src/ts/utils/dmplexlandau/tutorials/ex1.c
src/snes/tutorials/ex73f90t.F90
src/ts/utils/dmplexlandau/tutorials/ex2.c


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