DMStagSetUniformCoordinatesExplicit#

set DMSTAG coordinates to be a uniform grid, storing all values

Synopsis#

PetscErrorCode DMStagSetUniformCoordinatesExplicit(DM dm, PetscReal xmin, PetscReal xmax, PetscReal ymin, PetscReal ymax, PetscReal zmin, PetscReal zmax)

Collective

Input Parameters#

dm - the DMSTAG object
xmin - minimum global coordinate value in the x direction
xmax - maximum global coordinate value in the x direction
ymin - minimum global coordinate value in the y direction
ymax - maximum global coordinate value in the y direction
zmin - minimum global coordinate value in the z direction
zmax - maximum global coordinate value in the z direction

Notes#

DMSTAG supports 2 different types of coordinate DM: either another DMSTAG, or a DMPRODUCT. If the grid is orthogonal, using DMPRODUCT should be more efficient.

Arguments corresponding to higher dimensions are ignored for 1D and 2D grids.

See the manual page for DMStagSetUniformCoordinates() for information on how coordinates for dummy cells outside the physical domain boundary are populated.