PETSC_EXTERN PetscErrorCode DMStagCreate3d(MPI_Comm comm,DMBoundaryType bndx,DMBoundaryType bndy,DMBoundaryType bndz,PetscInt M,PetscInt N,PetscInt P,PetscInt m,PetscInt n,PetscInt p,PetscInt dof0,PetscInt dof1,PetscInt dof2,PetscInt dof3,DMStagStencilType stencilType,PetscInt stencilWidth,const PetscInt lx[],const PetscInt ly[],const PetscInt lz[],DM* dm)Collective
comm | - MPI communicator | |
bndx,bndy,bndz | - boundary type: DM_BOUNDARY_NONE, DM_BOUNDARY_PERIODIC, or DM_BOUNDARY_GHOSTED | |
M,N,P | - global number of grid points in x,y directions | |
m,n,p | - number of ranks in the x,y directions (may be PETSC_DECIDE) | |
dof0 | - number of degrees of freedom per vertex/point/node/0-cell | |
dof1 | - number of degrees of freedom per edge/1-cell | |
dof2 | - number of degrees of freedom per face/2-cell | |
dof3 | - number of degrees of freedom per element/3-cell | |
stencilType | - ghost/halo region type: DMSTAG_STENCIL_NONE, DMSTAG_STENCIL_BOX, or DMSTAG_STENCIL_STAR | |
stencilWidth | - width, in elements, of halo/ghost region | |
lx,ly,lz | - array sof local x,y,z element counts, of length equal to m,n,p, summing to M,N,P |
dm | - the new DMStag object |
-dm_view | - calls DMViewFromOptions() a the conclusion of DMSetUp() | |
-stag_grid_x <nx> | - number of elements in the x direction | |
-stag_grid_y <ny> | - number of elements in the y direction | |
-stag_grid_z <nz> | - number of elements in the z direction | |
-stag_ranks_x <rx> | - number of ranks in the x direction | |
-stag_ranks_y <ry> | - number of ranks in the y direction | |
-stag_ranks_z <rz> | - number of ranks in the z direction | |
-stag_ghost_stencil_width | - width of ghost region, in elements | |
-stag_boundary_type x <none,ghosted,periodic> | - DMBoundaryType value | |
-stag_boundary_type y <none,ghosted,periodic> | - DMBoundaryType value | |
-stag_boundary_type z <none,ghosted,periodic> | - DMBoundaryType value |