DMStagVecSplitToDMDA#

create a DMDA and Vec from a subgrid of a DMSTAG and its Vec

Synopsis#

#include "petscdmda.h"   
#include "petscdmstag.h"   
PetscErrorCode DMStagVecSplitToDMDA(DM dm, Vec vec, DMStagStencilLocation loc, PetscInt c, DM *pda, Vec *pdavec)

Collective

Input Parameters#

dm - the DMSTAG object
vec - Vec object associated with dm
loc - which subgrid to extract (see DMStagStencilLocation)
c - which component to extract (see note below)

Output Parameters#

pda - the DMDA
pdavec - the new Vec

Notes#

If a c value of -k is provided, the first k DOF for that position are extracted, padding with zero values if needed. If a non-negative value is provided, a single DOF is extracted.

The caller is responsible for destroying the created DMDA and Vec.