DMStagCreateCompatibleDMStag#

create a compatible DMStag with different dof/stratum

Synopsis#

PetscErrorCode DMStagCreateCompatibleDMStag(DM dm, PetscInt dof0, PetscInt dof1, PetscInt dof2, PetscInt dof3, DM *newdm)

Collective

Input Parameters#

dm - the DMStag object
dof0,dof1,dof2,dof3 - number of dof on each stratum in the new DMStag

Output Parameters#

newdm - the new, compatible DMStag

Notes#

DOF supplied for strata too big for the dimension are ignored; these may be set to 0. For example, for a 2-dimensional DMStag, dof2 sets the number of dof per element, and dof3 is unused. For a 3-dimensional DMStag, dof3 sets the number of DOF per element.

In contrast to DMDACreateCompatibleDMDA(), coordinates are not reused.