petsc-3.13.6 2020-09-29
DMStagCreate3d
Create an object to manage data living on the faces, edges, and vertices of a parallelized regular 3D grid.
Synopsis
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
Input Parameters
| 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
|
Output Parameter
dm -the new DMStag object
Options Database Keys
| -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
|
Notes
You must call DMSetUp() after this call before using the DM.
If you wish to use the options database (see the keys above) to change values in the DMStag, you must call
DMSetFromOptions() after this function but before DMSetUp().
See Also
DMSTAG, DMStagCreate1d(), DMStagCreate2d(), DMDestroy(), DMView(), DMCreateGlobalVector(), DMCreateLocalVector(), DMLocalToGlobalBegin(), DMDACreate3d()
Level
beginner
Location
src/dm/impls/stag/stag3d.c
Index of all DMSTAG routines
Table of Contents for all manual pages
Index of all manual pages