PetscErrorCode DMStagGetProductCoordinateArrays(DM dm,void* arrX,void* arrY,void* arrZ)Logically Collective
A high-level helper function to quickly extract local coordinate arrays.
Note that 2-dimensional arrays are returned. See DMStagVecGetArray(), which is called internally to produce these arrays representing coordinates on elements and vertices (element boundaries) for a 1-dimensional DMStag in each coordinate direction.
One should use DMStagGetProductCoordinateSlot() to determine appropriate indices for the second dimension in these returned arrays. This function checks that the coordinate array is a suitable product of 1-dimensional DMStag objects.
dm | - the DMStag object |
arrX,arrY,arrZ | - local 1D coordinate arrays |