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/snes/tutorials/ex73f90t.F90
src/ts/utils/dmplexlandau/tutorials/ex2.c
src/ts/utils/dmplexlandau/tutorials/ex1.c

---

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