petsc-3.12.4 2020-02-04
Report Typos and Errors

# DMCompositeGetLocalAccessArray

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

### Synopsis

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

Collective on dm.

### Input Parameters

| dm | - the packer object
| pvec | - packed vector
| nwanted | - number of vectors wanted
| wanted | - sorted array of vectors wanted, or NULL to get all vectors

### Output Parameters

vecs -array of requested local vectors (must be allocated)

### Notes

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

### See Also

DMCompositeRestoreLocalAccessArray(), DMCompositeGetAccess(),
DMCompositeGetEntries(), DMCompositeScatter(), DMCompositeGather()

### Level

advanced

### Location

src/dm/impls/composite/pack.c
Index of all DM routines
Table of Contents for all manual pages
Index of all manual pages