Actual source code: petscdmstag.h
1: #pragma once
3: #include <petscdm.h>
4: #include <petscdmproduct.h>
6: /* SUBMANSEC = DMStag */
8: /*E
9: DMStagStencilLocation - enumerated type denoting a location relative to an element in a `DMSTAG` grid
11: The interpretation of these values is dimension-dependent.
13: Level: beginner
15: Developer Note:
16: The order of the enum entries is significant, as it corresponds to the canonical numbering
17: of DOFs, and the fact that the numbering starts at 0 may also be used by the implementation.
19: .seealso: [](ch_stag), `DMSTAG`, `DMStagStencil`, `DMStagGetLocationSlot()`, `DMStagStencilType`
20: E*/
21: typedef enum {
22: DMSTAG_NULL_LOCATION = 0,
23: DMSTAG_BACK_DOWN_LEFT,
24: DMSTAG_BACK_DOWN,
25: DMSTAG_BACK_DOWN_RIGHT,
26: DMSTAG_BACK_LEFT,
27: DMSTAG_BACK,
28: DMSTAG_BACK_RIGHT,
29: DMSTAG_BACK_UP_LEFT,
30: DMSTAG_BACK_UP,
31: DMSTAG_BACK_UP_RIGHT,
32: DMSTAG_DOWN_LEFT,
33: DMSTAG_DOWN,
34: DMSTAG_DOWN_RIGHT,
35: DMSTAG_LEFT,
36: DMSTAG_ELEMENT,
37: DMSTAG_RIGHT,
38: DMSTAG_UP_LEFT,
39: DMSTAG_UP,
40: DMSTAG_UP_RIGHT,
41: DMSTAG_FRONT_DOWN_LEFT,
42: DMSTAG_FRONT_DOWN,
43: DMSTAG_FRONT_DOWN_RIGHT,
44: DMSTAG_FRONT_LEFT,
45: DMSTAG_FRONT,
46: DMSTAG_FRONT_RIGHT,
47: DMSTAG_FRONT_UP_LEFT,
48: DMSTAG_FRONT_UP,
49: DMSTAG_FRONT_UP_RIGHT
50: } DMStagStencilLocation;
51: PETSC_EXTERN const char *const DMStagStencilLocations[]; /* Corresponding strings (see stagstencil.c) */
53: /*S
54: DMStagStencil - data structure representing a degree of freedom on a `DMSTAG` grid
56: Data structure (C struct), analogous to describing a degree of freedom associated with a `DMSTAG` object,
57: in terms of a global element index in each of up to three directions, a "location" as defined by `DMStagStencilLocation`,
58: and a component number. Primarily for use with `DMStagMatSetValuesStencil()` (compare with use of `MatStencil` with `MatSetValuesStencil()`).
60: Level: beginner
62: Note:
63: The component (c) field must always be set, even if there is a single component at a given location (in which case c should be set to 0).
65: .seealso: [](ch_stag), `DMSTAG`, `DMStagMatSetValuesStencil()`, `DMStagVecSetValuesStencil()`, `DMStagStencilLocation`, `DMStagSetStencilWidth()`,
66: `DMStagSetStencilType()`, `DMStagVecGetValuesStencil()`, `DMStagStencilLocation`
67: S*/
68: typedef struct {
69: DMStagStencilLocation loc;
70: PetscInt i, j, k, c;
71: } DMStagStencil;
73: /*E
74: DMStagStencilType - Elementwise stencil type, determining which neighbors participate in communication
76: Level: beginner
78: .seealso: [](ch_stag), `DMSTAG`, `DMStagCreate1d()`, `DMStagCreate2d()`, `DMStagCreate3d()`, `DMStagStencil`, `DMDAStencilType`, `DMStagStencilLocation`
79: E*/
81: typedef enum {
82: DMSTAG_STENCIL_NONE = 0,
83: DMSTAG_STENCIL_STAR,
84: DMSTAG_STENCIL_BOX
85: } DMStagStencilType;
86: PETSC_EXTERN const char *const DMStagStencilTypes[]; /* Corresponding strings (see stagstencil.c) */
88: PETSC_EXTERN PetscErrorCode DMCreate_Stag(DM);
89: PETSC_EXTERN PetscErrorCode DMStagCreate1d(MPI_Comm, DMBoundaryType, PetscInt, PetscInt, PetscInt, DMStagStencilType, PetscInt, const PetscInt[], DM *);
90: PETSC_EXTERN PetscErrorCode DMStagCreate2d(MPI_Comm, DMBoundaryType, DMBoundaryType, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, DMStagStencilType, PetscInt, const PetscInt[], const PetscInt[], DM *);
91: PETSC_EXTERN PetscErrorCode DMStagCreate3d(MPI_Comm, DMBoundaryType, DMBoundaryType, DMBoundaryType, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, PetscInt, DMStagStencilType, PetscInt, const PetscInt[], const PetscInt[], const PetscInt[], DM *);
92: PETSC_EXTERN PetscErrorCode DMStagCreateCompatibleDMStag(DM, PetscInt, PetscInt, PetscInt, PetscInt, DM *);
93: PETSC_EXTERN PetscErrorCode DMStagCreateISFromStencils(DM, PetscInt, DMStagStencil *, IS *);
94: PETSC_EXTERN PetscErrorCode DMStagGetBoundaryTypes(DM, DMBoundaryType *, DMBoundaryType *, DMBoundaryType *);
95: PETSC_EXTERN PetscErrorCode DMStagGetCorners(DM, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *);
96: PETSC_EXTERN PetscErrorCode DMStagGetDOF(DM, PetscInt *, PetscInt *, PetscInt *, PetscInt *);
97: PETSC_EXTERN PetscErrorCode DMStagGetEntries(DM, PetscInt *);
98: PETSC_EXTERN PetscErrorCode DMStagGetEntriesLocal(DM, PetscInt *);
99: PETSC_EXTERN PetscErrorCode DMStagGetEntriesPerElement(DM, PetscInt *);
100: PETSC_EXTERN PetscErrorCode DMStagGetGhostCorners(DM, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *, PetscInt *);
101: PETSC_EXTERN PetscErrorCode DMStagGetGlobalSizes(DM, PetscInt *, PetscInt *, PetscInt *);
102: PETSC_EXTERN PetscErrorCode DMStagGetIsFirstRank(DM, PetscBool *, PetscBool *, PetscBool *);
103: PETSC_EXTERN PetscErrorCode DMStagGetIsLastRank(DM, PetscBool *, PetscBool *, PetscBool *);
104: PETSC_EXTERN PetscErrorCode DMStagGetLocalSizes(DM, PetscInt *, PetscInt *, PetscInt *);
105: PETSC_EXTERN PetscErrorCode DMStagGetLocationDOF(DM, DMStagStencilLocation, PetscInt *);
106: PETSC_EXTERN PetscErrorCode DMStagGetLocationSlot(DM, DMStagStencilLocation, PetscInt, PetscInt *);
107: PETSC_EXTERN PetscErrorCode DMStagGetNumRanks(DM, PetscInt *, PetscInt *, PetscInt *);
108: PETSC_EXTERN PetscErrorCode DMStagGetOwnershipRanges(DM, const PetscInt **, const PetscInt **, const PetscInt **);
109: PETSC_EXTERN PetscErrorCode DMStagGetProductCoordinateArrays(DM, void *, void *, void *);
110: PETSC_EXTERN PetscErrorCode DMStagGetProductCoordinateArraysRead(DM, void *, void *, void *);
111: PETSC_EXTERN PetscErrorCode DMStagGetProductCoordinateLocationSlot(DM, DMStagStencilLocation, PetscInt *);
112: PETSC_EXTERN PetscErrorCode DMStagGetStencilType(DM, DMStagStencilType *);
113: PETSC_EXTERN PetscErrorCode DMStagGetStencilWidth(DM, PetscInt *);
114: PETSC_EXTERN PetscErrorCode DMStagMatGetValuesStencil(DM, Mat, PetscInt, const DMStagStencil *, PetscInt, const DMStagStencil *, PetscScalar *);
115: PETSC_EXTERN PetscErrorCode DMStagMatSetValuesStencil(DM, Mat, PetscInt, const DMStagStencil *, PetscInt, const DMStagStencil *, const PetscScalar *, InsertMode);
116: PETSC_EXTERN PetscErrorCode DMStagMigrateVec(DM, Vec, DM, Vec);
117: PETSC_EXTERN PetscErrorCode DMStagPopulateLocalToGlobalInjective(DM);
118: PETSC_EXTERN PetscErrorCode DMStagRestoreProductCoordinateArrays(DM, void *, void *, void *);
119: PETSC_EXTERN PetscErrorCode DMStagRestoreProductCoordinateArraysRead(DM, void *, void *, void *);
120: PETSC_EXTERN PetscErrorCode DMStagRestrictSimple(DM, Vec, DM, Vec);
121: PETSC_EXTERN PetscErrorCode DMStagSetBoundaryTypes(DM, DMBoundaryType, DMBoundaryType, DMBoundaryType);
122: PETSC_EXTERN PetscErrorCode DMStagSetCoordinateDMType(DM, DMType);
123: PETSC_EXTERN PetscErrorCode DMStagSetDOF(DM, PetscInt, PetscInt, PetscInt, PetscInt);
124: PETSC_EXTERN PetscErrorCode DMStagSetGlobalSizes(DM, PetscInt, PetscInt, PetscInt);
125: PETSC_EXTERN PetscErrorCode DMStagSetNumRanks(DM, PetscInt, PetscInt, PetscInt);
126: PETSC_EXTERN PetscErrorCode DMStagSetOwnershipRanges(DM, PetscInt const *, PetscInt const *, PetscInt const *);
127: PETSC_EXTERN PetscErrorCode DMStagSetStencilType(DM, DMStagStencilType);
128: PETSC_EXTERN PetscErrorCode DMStagSetStencilWidth(DM, PetscInt);
129: PETSC_EXTERN PetscErrorCode DMStagSetUniformCoordinates(DM, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal);
130: PETSC_EXTERN PetscErrorCode DMStagSetUniformCoordinatesExplicit(DM, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal);
131: PETSC_EXTERN PetscErrorCode DMStagSetUniformCoordinatesProduct(DM, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal, PetscReal);
132: PETSC_EXTERN PetscErrorCode DMStagStencilToIndexLocal(DM, PetscInt, PetscInt, const DMStagStencil *, PetscInt *);
133: PETSC_EXTERN PetscErrorCode DMStagVecGetArray(DM, Vec, void *);
134: PETSC_EXTERN PetscErrorCode DMStagVecGetArrayRead(DM, Vec, void *);
135: PETSC_EXTERN PetscErrorCode DMStagVecGetValuesStencil(DM, Vec, PetscInt, const DMStagStencil *, PetscScalar *);
136: PETSC_EXTERN PetscErrorCode DMStagVecRestoreArray(DM, Vec, void *);
137: PETSC_EXTERN PetscErrorCode DMStagVecRestoreArrayRead(DM, Vec, void *);
138: PETSC_EXTERN PetscErrorCode DMStagVecSetValuesStencil(DM, Vec, PetscInt, const DMStagStencil *, const PetscScalar *, InsertMode);
139: PETSC_EXTERN PetscErrorCode DMStagVecSplitToDMDA(DM, Vec, DMStagStencilLocation, PetscInt, DM *, Vec *);
141: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagGetProductCoordinateArraysRead()", ) static inline PetscErrorCode DMStagGet1dCoordinateArraysDOFRead(DM dm, void *ax, void *ay, void *az)
142: {
143: return DMStagGetProductCoordinateArraysRead(dm, ax, ay, az);
144: }
145: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagGetProductCoordinateLocationSlot()", ) static inline PetscErrorCode DMStagGet1dCoordinateLocationSlot(DM dm, DMStagStencilLocation loc, PetscInt *s)
146: {
147: return DMStagGetProductCoordinateLocationSlot(dm, loc, s);
148: }
149: PETSC_DEPRECATED_FUNCTION(3, 11, 0, "DMStagGetStencilType()", ) static inline PetscErrorCode DMStagGetGhostType(DM dm, DMStagStencilType *s)
150: {
151: return DMStagGetStencilType(dm, s);
152: }
153: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagRestoreProductCoordinateArraysRead()", ) static inline PetscErrorCode DMStagRestore1dCoordinateArraysDOFRead(DM dm, void *ax, void *ay, void *az)
154: {
155: return DMStagRestoreProductCoordinateArraysRead(dm, ax, ay, az);
156: }
157: PETSC_DEPRECATED_FUNCTION(3, 11, 0, "DMStagSetStencilType()", ) static inline PetscErrorCode DMStagSetGhostType(DM dm, DMStagStencilType *s)
158: {
159: return DMStagGetStencilType(dm, s);
160: }
161: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagVecGetArray()", ) static inline PetscErrorCode DMStagVecGetArrayDOF(DM dm, Vec v, void *a)
162: {
163: return DMStagVecGetArray(dm, v, a);
164: }
165: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagVecGetArrayRead()", ) static inline PetscErrorCode DMStagVecGetArrayDOFRead(DM dm, Vec v, void *a)
166: {
167: return DMStagVecGetArrayRead(dm, v, a);
168: }
169: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagVecRestoreArray()", ) static inline PetscErrorCode DMStagVecRestoreArrayDOF(DM dm, Vec v, void *a)
170: {
171: return DMStagVecRestoreArray(dm, v, a);
172: }
173: PETSC_DEPRECATED_FUNCTION(3, 13, 0, "DMStagVecRestoreArrayRead()", ) static inline PetscErrorCode DMStagVecRestoreArrayDOFRead(DM dm, Vec v, void *a)
174: {
175: return DMStagVecRestoreArrayRead(dm, v, a);
176: }