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 | - 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_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 |