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
dm
loc - 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