DMStagVecSplitToDMDA#
create a DMDA and Vec from a DMStag and Vec
Synopsis#
PetscErrorCode DMStagVecSplitToDMDA(DM dm, Vec vec, DMStagStencilLocation loc, PetscInt c, DM *pda, Vec *pdavec)
Logically Collective
High-level helper function which accepts a DMStag, a global vector, and location/dof, and generates a corresponding DMDA and Vec.
Input Parameters#
dm - the DMStag object
vec- Vec object associated with
dmloc - which subgrid to extract (see
DMStagStencilLocation)c - which component to extract (see note below)
Output Parameters#
Notes#
If a c value of -k is provided, the first k DOF for that position are extracted,
padding with zero values if needbe. If a non-negative value is provided, a single
DOF is extracted.
The caller is responsible for destroying the created DMDA and Vec.
See Also#
DMSTAG, DMDA, DMStagMigrateVec(), DMStagCreateCompatibleDMStag()
Level#
advanced
Location#
Examples#
src/dm/impls/stag/tutorials/ex4.c.html
src/dm/impls/stag/tutorials/ex6.c.html
Index of all DMStag routines
Table of Contents for all manual pages
Index of all manual pages