PETSc version 3.15.5
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
|  | pda | - the new 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 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
src/dm/impls/stag/stagda.c
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