xref: /petsc/src/dm/impls/plex/plexgeometry.c (revision 2827ebad7ef18d4ed3f6d7633d71fb685bb29d6f)
1af0996ceSBarry Smith #include <petsc/private/dmpleximpl.h>  /*I      "petscdmplex.h"   I*/
29d150b73SToby Isaac #include <petsc/private/petscfeimpl.h> /*I      "petscfe.h"       I*/
39d150b73SToby Isaac #include <petscblaslapack.h>
4af74b616SDave May #include <petsctime.h>
5ccd2543fSMatthew G Knepley 
63985bb02SVaclav Hapla /*@
73985bb02SVaclav Hapla   DMPlexFindVertices - Try to find DAG points based on their coordinates.
83985bb02SVaclav Hapla 
920f4b53cSBarry Smith   Not Collective (provided `DMGetCoordinatesLocalSetUp()` has been already called)
103985bb02SVaclav Hapla 
113985bb02SVaclav Hapla   Input Parameters:
1220f4b53cSBarry Smith + dm - The `DMPLEX` object
1320f4b53cSBarry Smith . coordinates - The `Vec` of coordinates of the sought points
1420f4b53cSBarry Smith - eps - The tolerance or `PETSC_DEFAULT`
153985bb02SVaclav Hapla 
162fe279fdSBarry Smith   Output Parameter:
1720f4b53cSBarry Smith . points - The `IS` of found DAG points or -1
183985bb02SVaclav Hapla 
193985bb02SVaclav Hapla   Level: intermediate
203985bb02SVaclav Hapla 
213985bb02SVaclav Hapla   Notes:
2220f4b53cSBarry Smith   The length of `Vec` coordinates must be npoints * dim where dim is the spatial dimension returned by `DMGetCoordinateDim()` and npoints is the number of sought points.
233985bb02SVaclav Hapla 
2420f4b53cSBarry Smith   The output `IS` is living on `PETSC_COMM_SELF` and its length is npoints.
25d3e1f4ccSVaclav Hapla   Each rank does the search independently.
2620f4b53cSBarry Smith   If this rank's local `DMPLEX` portion contains the DAG point corresponding to the i-th tuple of coordinates, the i-th entry of the output `IS` is set to that DAG point, otherwise to -1.
273985bb02SVaclav Hapla 
2820f4b53cSBarry Smith   The output `IS` must be destroyed by user.
293985bb02SVaclav Hapla 
303985bb02SVaclav Hapla   The tolerance is interpreted as the maximum Euclidean (L2) distance of the sought point from the specified coordinates.
313985bb02SVaclav Hapla 
32d3e1f4ccSVaclav Hapla   Complexity of this function is currently O(mn) with m number of vertices to find and n number of vertices in the local mesh. This could probably be improved if needed.
33335ef845SVaclav Hapla 
3420f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexCreate()`, `DMGetCoordinatesLocal()`
353985bb02SVaclav Hapla @*/
36d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexFindVertices(DM dm, Vec coordinates, PetscReal eps, IS *points)
37d71ae5a4SJacob Faibussowitsch {
3837900f7dSMatthew G. Knepley   PetscInt           c, cdim, i, j, o, p, vStart, vEnd;
39d3e1f4ccSVaclav Hapla   PetscInt           npoints;
40d3e1f4ccSVaclav Hapla   const PetscScalar *coord;
413985bb02SVaclav Hapla   Vec                allCoordsVec;
423985bb02SVaclav Hapla   const PetscScalar *allCoords;
43d3e1f4ccSVaclav Hapla   PetscInt          *dagPoints;
443985bb02SVaclav Hapla 
453985bb02SVaclav Hapla   PetscFunctionBegin;
463985bb02SVaclav Hapla   if (eps < 0) eps = PETSC_SQRT_MACHINE_EPSILON;
479566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &cdim));
48d3e1f4ccSVaclav Hapla   {
49d3e1f4ccSVaclav Hapla     PetscInt n;
50d3e1f4ccSVaclav Hapla 
519566063dSJacob Faibussowitsch     PetscCall(VecGetLocalSize(coordinates, &n));
5263a3b9bcSJacob Faibussowitsch     PetscCheck(n % cdim == 0, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Given coordinates Vec has local length %" PetscInt_FMT " not divisible by coordinate dimension %" PetscInt_FMT " of given DM", n, cdim);
53d3e1f4ccSVaclav Hapla     npoints = n / cdim;
54d3e1f4ccSVaclav Hapla   }
559566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &allCoordsVec));
569566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(allCoordsVec, &allCoords));
579566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(coordinates, &coord));
589566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
5976bd3646SJed Brown   if (PetscDefined(USE_DEBUG)) {
60335ef845SVaclav Hapla     /* check coordinate section is consistent with DM dimension */
61335ef845SVaclav Hapla     PetscSection cs;
62335ef845SVaclav Hapla     PetscInt     ndof;
63335ef845SVaclav Hapla 
649566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &cs));
653985bb02SVaclav Hapla     for (p = vStart; p < vEnd; p++) {
669566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetDof(cs, p, &ndof));
6763a3b9bcSJacob Faibussowitsch       PetscCheck(ndof == cdim, PETSC_COMM_SELF, PETSC_ERR_PLIB, "point %" PetscInt_FMT ": ndof = %" PetscInt_FMT " != %" PetscInt_FMT " = cdim", p, ndof, cdim);
68335ef845SVaclav Hapla     }
69335ef845SVaclav Hapla   }
709566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(npoints, &dagPoints));
71eca9f518SVaclav Hapla   if (eps == 0.0) {
7237900f7dSMatthew G. Knepley     for (i = 0, j = 0; i < npoints; i++, j += cdim) {
73eca9f518SVaclav Hapla       dagPoints[i] = -1;
7437900f7dSMatthew G. Knepley       for (p = vStart, o = 0; p < vEnd; p++, o += cdim) {
7537900f7dSMatthew G. Knepley         for (c = 0; c < cdim; c++) {
76d3e1f4ccSVaclav Hapla           if (coord[j + c] != allCoords[o + c]) break;
77eca9f518SVaclav Hapla         }
7837900f7dSMatthew G. Knepley         if (c == cdim) {
79eca9f518SVaclav Hapla           dagPoints[i] = p;
80eca9f518SVaclav Hapla           break;
81eca9f518SVaclav Hapla         }
82eca9f518SVaclav Hapla       }
83eca9f518SVaclav Hapla     }
84d3e1f4ccSVaclav Hapla   } else {
8537900f7dSMatthew G. Knepley     for (i = 0, j = 0; i < npoints; i++, j += cdim) {
86d3e1f4ccSVaclav Hapla       PetscReal norm;
87d3e1f4ccSVaclav Hapla 
88335ef845SVaclav Hapla       dagPoints[i] = -1;
8937900f7dSMatthew G. Knepley       for (p = vStart, o = 0; p < vEnd; p++, o += cdim) {
903985bb02SVaclav Hapla         norm = 0.0;
91ad540459SPierre Jolivet         for (c = 0; c < cdim; c++) norm += PetscRealPart(PetscSqr(coord[j + c] - allCoords[o + c]));
923985bb02SVaclav Hapla         norm = PetscSqrtReal(norm);
933985bb02SVaclav Hapla         if (norm <= eps) {
943985bb02SVaclav Hapla           dagPoints[i] = p;
953985bb02SVaclav Hapla           break;
963985bb02SVaclav Hapla         }
973985bb02SVaclav Hapla       }
983985bb02SVaclav Hapla     }
99d3e1f4ccSVaclav Hapla   }
1009566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(allCoordsVec, &allCoords));
1019566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(coordinates, &coord));
1029566063dSJacob Faibussowitsch   PetscCall(ISCreateGeneral(PETSC_COMM_SELF, npoints, dagPoints, PETSC_OWN_POINTER, points));
1033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1043985bb02SVaclav Hapla }
1053985bb02SVaclav Hapla 
1066363a54bSMatthew G. Knepley #if 0
107d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexGetLineIntersection_2D_Internal(const PetscReal segmentA[], const PetscReal segmentB[], PetscReal intersection[], PetscBool *hasIntersection)
108d71ae5a4SJacob Faibussowitsch {
109fea14342SMatthew G. Knepley   const PetscReal p0_x  = segmentA[0 * 2 + 0];
110fea14342SMatthew G. Knepley   const PetscReal p0_y  = segmentA[0 * 2 + 1];
111fea14342SMatthew G. Knepley   const PetscReal p1_x  = segmentA[1 * 2 + 0];
112fea14342SMatthew G. Knepley   const PetscReal p1_y  = segmentA[1 * 2 + 1];
113fea14342SMatthew G. Knepley   const PetscReal p2_x  = segmentB[0 * 2 + 0];
114fea14342SMatthew G. Knepley   const PetscReal p2_y  = segmentB[0 * 2 + 1];
115fea14342SMatthew G. Knepley   const PetscReal p3_x  = segmentB[1 * 2 + 0];
116fea14342SMatthew G. Knepley   const PetscReal p3_y  = segmentB[1 * 2 + 1];
117fea14342SMatthew G. Knepley   const PetscReal s1_x  = p1_x - p0_x;
118fea14342SMatthew G. Knepley   const PetscReal s1_y  = p1_y - p0_y;
119fea14342SMatthew G. Knepley   const PetscReal s2_x  = p3_x - p2_x;
120fea14342SMatthew G. Knepley   const PetscReal s2_y  = p3_y - p2_y;
121fea14342SMatthew G. Knepley   const PetscReal denom = (-s2_x * s1_y + s1_x * s2_y);
122fea14342SMatthew G. Knepley 
123fea14342SMatthew G. Knepley   PetscFunctionBegin;
124fea14342SMatthew G. Knepley   *hasIntersection = PETSC_FALSE;
125fea14342SMatthew G. Knepley   /* Non-parallel lines */
126fea14342SMatthew G. Knepley   if (denom != 0.0) {
127fea14342SMatthew G. Knepley     const PetscReal s = (-s1_y * (p0_x - p2_x) + s1_x * (p0_y - p2_y)) / denom;
128fea14342SMatthew G. Knepley     const PetscReal t = (s2_x * (p0_y - p2_y) - s2_y * (p0_x - p2_x)) / denom;
129fea14342SMatthew G. Knepley 
130fea14342SMatthew G. Knepley     if (s >= 0 && s <= 1 && t >= 0 && t <= 1) {
131fea14342SMatthew G. Knepley       *hasIntersection = PETSC_TRUE;
132fea14342SMatthew G. Knepley       if (intersection) {
133fea14342SMatthew G. Knepley         intersection[0] = p0_x + (t * s1_x);
134fea14342SMatthew G. Knepley         intersection[1] = p0_y + (t * s1_y);
135fea14342SMatthew G. Knepley       }
136fea14342SMatthew G. Knepley     }
137fea14342SMatthew G. Knepley   }
1383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
139fea14342SMatthew G. Knepley }
140fea14342SMatthew G. Knepley 
141ddce0771SMatthew G. Knepley /* The plane is segmentB x segmentC: https://en.wikipedia.org/wiki/Line%E2%80%93plane_intersection */
142d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexGetLinePlaneIntersection_3D_Internal(const PetscReal segmentA[], const PetscReal segmentB[], const PetscReal segmentC[], PetscReal intersection[], PetscBool *hasIntersection)
143d71ae5a4SJacob Faibussowitsch {
144ddce0771SMatthew G. Knepley   const PetscReal p0_x  = segmentA[0 * 3 + 0];
145ddce0771SMatthew G. Knepley   const PetscReal p0_y  = segmentA[0 * 3 + 1];
146ddce0771SMatthew G. Knepley   const PetscReal p0_z  = segmentA[0 * 3 + 2];
147ddce0771SMatthew G. Knepley   const PetscReal p1_x  = segmentA[1 * 3 + 0];
148ddce0771SMatthew G. Knepley   const PetscReal p1_y  = segmentA[1 * 3 + 1];
149ddce0771SMatthew G. Knepley   const PetscReal p1_z  = segmentA[1 * 3 + 2];
150ddce0771SMatthew G. Knepley   const PetscReal q0_x  = segmentB[0 * 3 + 0];
151ddce0771SMatthew G. Knepley   const PetscReal q0_y  = segmentB[0 * 3 + 1];
152ddce0771SMatthew G. Knepley   const PetscReal q0_z  = segmentB[0 * 3 + 2];
153ddce0771SMatthew G. Knepley   const PetscReal q1_x  = segmentB[1 * 3 + 0];
154ddce0771SMatthew G. Knepley   const PetscReal q1_y  = segmentB[1 * 3 + 1];
155ddce0771SMatthew G. Knepley   const PetscReal q1_z  = segmentB[1 * 3 + 2];
156ddce0771SMatthew G. Knepley   const PetscReal r0_x  = segmentC[0 * 3 + 0];
157ddce0771SMatthew G. Knepley   const PetscReal r0_y  = segmentC[0 * 3 + 1];
158ddce0771SMatthew G. Knepley   const PetscReal r0_z  = segmentC[0 * 3 + 2];
159ddce0771SMatthew G. Knepley   const PetscReal r1_x  = segmentC[1 * 3 + 0];
160ddce0771SMatthew G. Knepley   const PetscReal r1_y  = segmentC[1 * 3 + 1];
161ddce0771SMatthew G. Knepley   const PetscReal r1_z  = segmentC[1 * 3 + 2];
162ddce0771SMatthew G. Knepley   const PetscReal s0_x  = p1_x - p0_x;
163ddce0771SMatthew G. Knepley   const PetscReal s0_y  = p1_y - p0_y;
164ddce0771SMatthew G. Knepley   const PetscReal s0_z  = p1_z - p0_z;
165ddce0771SMatthew G. Knepley   const PetscReal s1_x  = q1_x - q0_x;
166ddce0771SMatthew G. Knepley   const PetscReal s1_y  = q1_y - q0_y;
167ddce0771SMatthew G. Knepley   const PetscReal s1_z  = q1_z - q0_z;
168ddce0771SMatthew G. Knepley   const PetscReal s2_x  = r1_x - r0_x;
169ddce0771SMatthew G. Knepley   const PetscReal s2_y  = r1_y - r0_y;
170ddce0771SMatthew G. Knepley   const PetscReal s2_z  = r1_z - r0_z;
171ddce0771SMatthew G. Knepley   const PetscReal s3_x  = s1_y * s2_z - s1_z * s2_y; /* s1 x s2 */
172ddce0771SMatthew G. Knepley   const PetscReal s3_y  = s1_z * s2_x - s1_x * s2_z;
173ddce0771SMatthew G. Knepley   const PetscReal s3_z  = s1_x * s2_y - s1_y * s2_x;
174ddce0771SMatthew G. Knepley   const PetscReal s4_x  = s0_y * s2_z - s0_z * s2_y; /* s0 x s2 */
175ddce0771SMatthew G. Knepley   const PetscReal s4_y  = s0_z * s2_x - s0_x * s2_z;
176ddce0771SMatthew G. Knepley   const PetscReal s4_z  = s0_x * s2_y - s0_y * s2_x;
177ddce0771SMatthew G. Knepley   const PetscReal s5_x  = s1_y * s0_z - s1_z * s0_y; /* s1 x s0 */
178ddce0771SMatthew G. Knepley   const PetscReal s5_y  = s1_z * s0_x - s1_x * s0_z;
179ddce0771SMatthew G. Knepley   const PetscReal s5_z  = s1_x * s0_y - s1_y * s0_x;
180ddce0771SMatthew G. Knepley   const PetscReal denom = -(s0_x * s3_x + s0_y * s3_y + s0_z * s3_z); /* -s0 . (s1 x s2) */
181ddce0771SMatthew G. Knepley 
182ddce0771SMatthew G. Knepley   PetscFunctionBegin;
183ddce0771SMatthew G. Knepley   *hasIntersection = PETSC_FALSE;
184ddce0771SMatthew G. Knepley   /* Line not parallel to plane */
185ddce0771SMatthew G. Knepley   if (denom != 0.0) {
186ddce0771SMatthew G. Knepley     const PetscReal t = (s3_x * (p0_x - q0_x) + s3_y * (p0_y - q0_y) + s3_z * (p0_z - q0_z)) / denom;
187ddce0771SMatthew G. Knepley     const PetscReal u = (s4_x * (p0_x - q0_x) + s4_y * (p0_y - q0_y) + s4_z * (p0_z - q0_z)) / denom;
188ddce0771SMatthew G. Knepley     const PetscReal v = (s5_x * (p0_x - q0_x) + s5_y * (p0_y - q0_y) + s5_z * (p0_z - q0_z)) / denom;
189ddce0771SMatthew G. Knepley 
190ddce0771SMatthew G. Knepley     if (t >= 0 && t <= 1 && u >= 0 && u <= 1 && v >= 0 && v <= 1) {
191ddce0771SMatthew G. Knepley       *hasIntersection = PETSC_TRUE;
192ddce0771SMatthew G. Knepley       if (intersection) {
193ddce0771SMatthew G. Knepley         intersection[0] = p0_x + (t * s0_x);
194ddce0771SMatthew G. Knepley         intersection[1] = p0_y + (t * s0_y);
195ddce0771SMatthew G. Knepley         intersection[2] = p0_z + (t * s0_z);
196ddce0771SMatthew G. Knepley       }
197ddce0771SMatthew G. Knepley     }
198ddce0771SMatthew G. Knepley   }
1993ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
200ddce0771SMatthew G. Knepley }
2016363a54bSMatthew G. Knepley #endif
2026363a54bSMatthew G. Knepley 
2036363a54bSMatthew G. Knepley static PetscErrorCode DMPlexGetPlaneSimplexIntersection_Coords_Internal(DM dm, PetscInt dim, PetscInt cdim, const PetscScalar coords[], const PetscReal p[], const PetscReal normal[], PetscBool *pos, PetscInt *Nint, PetscReal intPoints[])
2046363a54bSMatthew G. Knepley {
2056363a54bSMatthew G. Knepley   PetscReal d[4]; // distance of vertices to the plane
2066363a54bSMatthew G. Knepley   PetscReal dp;   // distance from origin to the plane
2076363a54bSMatthew G. Knepley   PetscInt  n = 0;
2086363a54bSMatthew G. Knepley 
2096363a54bSMatthew G. Knepley   PetscFunctionBegin;
2106363a54bSMatthew G. Knepley   if (pos) *pos = PETSC_FALSE;
2116363a54bSMatthew G. Knepley   if (Nint) *Nint = 0;
2126363a54bSMatthew G. Knepley   if (PetscDefined(USE_DEBUG)) {
2136363a54bSMatthew G. Knepley     PetscReal mag = DMPlex_NormD_Internal(cdim, normal);
214b58dcb05SPierre Jolivet     PetscCheck(PetscAbsReal(mag - (PetscReal)1.0) < PETSC_SMALL, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Normal vector is not normalized: %g", (double)mag);
2156363a54bSMatthew G. Knepley   }
2166363a54bSMatthew G. Knepley 
2176363a54bSMatthew G. Knepley   dp = DMPlex_DotRealD_Internal(cdim, normal, p);
2186363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < dim + 1; ++v) {
2196363a54bSMatthew G. Knepley     // d[v] is positive, zero, or negative if vertex i is above, on, or below the plane
2206363a54bSMatthew G. Knepley #if defined(PETSC_USE_COMPLEX)
2216363a54bSMatthew G. Knepley     PetscReal c[4];
2226363a54bSMatthew G. Knepley     for (PetscInt i = 0; i < cdim; ++i) c[i] = PetscRealPart(coords[v * cdim + i]);
2236363a54bSMatthew G. Knepley     d[v] = DMPlex_DotRealD_Internal(cdim, normal, c);
2246363a54bSMatthew G. Knepley #else
2256363a54bSMatthew G. Knepley     d[v]           = DMPlex_DotRealD_Internal(cdim, normal, &coords[v * cdim]);
2266363a54bSMatthew G. Knepley #endif
2276363a54bSMatthew G. Knepley     d[v] -= dp;
2286363a54bSMatthew G. Knepley   }
2296363a54bSMatthew G. Knepley 
2306363a54bSMatthew G. Knepley   // If all d are positive or negative, no intersection
2316363a54bSMatthew G. Knepley   {
2326363a54bSMatthew G. Knepley     PetscInt v;
2336363a54bSMatthew G. Knepley     for (v = 0; v < dim + 1; ++v)
2346363a54bSMatthew G. Knepley       if (d[v] >= 0.) break;
2356363a54bSMatthew G. Knepley     if (v == dim + 1) PetscFunctionReturn(PETSC_SUCCESS);
2366363a54bSMatthew G. Knepley     for (v = 0; v < dim + 1; ++v)
2376363a54bSMatthew G. Knepley       if (d[v] <= 0.) break;
2386363a54bSMatthew G. Knepley     if (v == dim + 1) {
2396363a54bSMatthew G. Knepley       if (pos) *pos = PETSC_TRUE;
2406363a54bSMatthew G. Knepley       PetscFunctionReturn(PETSC_SUCCESS);
2416363a54bSMatthew G. Knepley     }
2426363a54bSMatthew G. Knepley   }
2436363a54bSMatthew G. Knepley 
2446363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < dim + 1; ++v) {
2456363a54bSMatthew G. Knepley     // Points with zero distance are automatically added to the list.
2466363a54bSMatthew G. Knepley     if (PetscAbsReal(d[v]) < PETSC_MACHINE_EPSILON) {
2476363a54bSMatthew G. Knepley       for (PetscInt i = 0; i < cdim; ++i) intPoints[n * cdim + i] = PetscRealPart(coords[v * cdim + i]);
2486363a54bSMatthew G. Knepley       ++n;
2496363a54bSMatthew G. Knepley     } else {
2506363a54bSMatthew G. Knepley       // For each point with nonzero distance, seek another point with opposite sign
2516363a54bSMatthew G. Knepley       // and higher index, and compute the intersection of the line between those
2526363a54bSMatthew G. Knepley       // points and the plane.
2536363a54bSMatthew G. Knepley       for (PetscInt w = v + 1; w < dim + 1; ++w) {
2546363a54bSMatthew G. Knepley         if (d[v] * d[w] < 0.) {
2556363a54bSMatthew G. Knepley           PetscReal inv_dist = 1. / (d[v] - d[w]);
2566363a54bSMatthew G. Knepley           for (PetscInt i = 0; i < cdim; ++i) intPoints[n * cdim + i] = (d[v] * PetscRealPart(coords[w * cdim + i]) - d[w] * PetscRealPart(coords[v * cdim + i])) * inv_dist;
2576363a54bSMatthew G. Knepley           ++n;
2586363a54bSMatthew G. Knepley         }
2596363a54bSMatthew G. Knepley       }
2606363a54bSMatthew G. Knepley     }
2616363a54bSMatthew G. Knepley   }
2626363a54bSMatthew G. Knepley   // TODO order output points if there are 4
2636363a54bSMatthew G. Knepley   *Nint = n;
2646363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
2656363a54bSMatthew G. Knepley }
2666363a54bSMatthew G. Knepley 
2676363a54bSMatthew G. Knepley static PetscErrorCode DMPlexGetPlaneSimplexIntersection_Internal(DM dm, PetscInt dim, PetscInt c, const PetscReal p[], const PetscReal normal[], PetscBool *pos, PetscInt *Nint, PetscReal intPoints[])
2686363a54bSMatthew G. Knepley {
2696363a54bSMatthew G. Knepley   const PetscScalar *array;
2706363a54bSMatthew G. Knepley   PetscScalar       *coords = NULL;
2716363a54bSMatthew G. Knepley   PetscInt           numCoords;
2726363a54bSMatthew G. Knepley   PetscBool          isDG;
2736363a54bSMatthew G. Knepley   PetscInt           cdim;
2746363a54bSMatthew G. Knepley 
2756363a54bSMatthew G. Knepley   PetscFunctionBegin;
2766363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
2776363a54bSMatthew G. Knepley   PetscCheck(cdim == dim, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM has coordinates in %" PetscInt_FMT "D instead of %" PetscInt_FMT "D", cdim, dim);
2786363a54bSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
2796363a54bSMatthew G. Knepley   PetscCheck(numCoords == dim * (dim + 1), PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Tetrahedron should have %" PetscInt_FMT " coordinates, not %" PetscInt_FMT, dim * (dim + 1), numCoords);
2806363a54bSMatthew G. Knepley   PetscCall(PetscArrayzero(intPoints, dim * (dim + 1)));
2816363a54bSMatthew G. Knepley 
2826363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, coords, p, normal, pos, Nint, intPoints));
2836363a54bSMatthew G. Knepley 
2846363a54bSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
2856363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
2866363a54bSMatthew G. Knepley }
2876363a54bSMatthew G. Knepley 
2886363a54bSMatthew G. Knepley static PetscErrorCode DMPlexGetPlaneQuadIntersection_Internal(DM dm, PetscInt dim, PetscInt c, const PetscReal p[], const PetscReal normal[], PetscBool *pos, PetscInt *Nint, PetscReal intPoints[])
2896363a54bSMatthew G. Knepley {
2906363a54bSMatthew G. Knepley   const PetscScalar *array;
2916363a54bSMatthew G. Knepley   PetscScalar       *coords = NULL;
2926363a54bSMatthew G. Knepley   PetscInt           numCoords;
2936363a54bSMatthew G. Knepley   PetscBool          isDG;
2946363a54bSMatthew G. Knepley   PetscInt           cdim;
2956363a54bSMatthew G. Knepley   PetscScalar        tcoords[6] = {0., 0., 0., 0., 0., 0.};
2966363a54bSMatthew G. Knepley   const PetscInt     vertsA[3]  = {0, 1, 3};
2976363a54bSMatthew G. Knepley   const PetscInt     vertsB[3]  = {1, 2, 3};
2986363a54bSMatthew G. Knepley   PetscInt           NintA, NintB;
2996363a54bSMatthew G. Knepley 
3006363a54bSMatthew G. Knepley   PetscFunctionBegin;
3016363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
3026363a54bSMatthew G. Knepley   PetscCheck(cdim == dim, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM has coordinates in %" PetscInt_FMT "D instead of %" PetscInt_FMT "D", cdim, dim);
3036363a54bSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
3046363a54bSMatthew G. Knepley   PetscCheck(numCoords == dim * 4, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Quadrilateral should have %" PetscInt_FMT " coordinates, not %" PetscInt_FMT, dim * 4, numCoords);
3056363a54bSMatthew G. Knepley   PetscCall(PetscArrayzero(intPoints, dim * 4));
3066363a54bSMatthew G. Knepley 
3076363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 3; ++v)
3086363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsA[v] * cdim + d];
3096363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintA, intPoints));
3106363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 3; ++v)
3116363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsB[v] * cdim + d];
3126363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintB, &intPoints[NintA * cdim]));
3136363a54bSMatthew G. Knepley   *Nint = NintA + NintB;
3146363a54bSMatthew G. Knepley 
3156363a54bSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
3166363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
3176363a54bSMatthew G. Knepley }
3186363a54bSMatthew G. Knepley 
3196363a54bSMatthew G. Knepley static PetscErrorCode DMPlexGetPlaneHexIntersection_Internal(DM dm, PetscInt dim, PetscInt c, const PetscReal p[], const PetscReal normal[], PetscBool *pos, PetscInt *Nint, PetscReal intPoints[])
3206363a54bSMatthew G. Knepley {
3216363a54bSMatthew G. Knepley   const PetscScalar *array;
3226363a54bSMatthew G. Knepley   PetscScalar       *coords = NULL;
3236363a54bSMatthew G. Knepley   PetscInt           numCoords;
3246363a54bSMatthew G. Knepley   PetscBool          isDG;
3256363a54bSMatthew G. Knepley   PetscInt           cdim;
3266363a54bSMatthew G. Knepley   PetscScalar        tcoords[12] = {0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0., 0.};
3276363a54bSMatthew G. Knepley   // We split using the (2, 4) main diagonal, so all tets contain those vertices
3286363a54bSMatthew G. Knepley   const PetscInt vertsA[4] = {0, 1, 2, 4};
3296363a54bSMatthew G. Knepley   const PetscInt vertsB[4] = {0, 2, 3, 4};
3306363a54bSMatthew G. Knepley   const PetscInt vertsC[4] = {1, 7, 2, 4};
3316363a54bSMatthew G. Knepley   const PetscInt vertsD[4] = {2, 7, 6, 4};
3326363a54bSMatthew G. Knepley   const PetscInt vertsE[4] = {3, 5, 4, 2};
3336363a54bSMatthew G. Knepley   const PetscInt vertsF[4] = {4, 5, 6, 2};
3346363a54bSMatthew G. Knepley   PetscInt       NintA, NintB, NintC, NintD, NintE, NintF, Nsum = 0;
3356363a54bSMatthew G. Knepley 
3366363a54bSMatthew G. Knepley   PetscFunctionBegin;
3376363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
3386363a54bSMatthew G. Knepley   PetscCheck(cdim == dim, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "DM has coordinates in %" PetscInt_FMT "D instead of %" PetscInt_FMT "D", cdim, dim);
3396363a54bSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
3406363a54bSMatthew G. Knepley   PetscCheck(numCoords == dim * 8, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Hexahedron should have %" PetscInt_FMT " coordinates, not %" PetscInt_FMT, dim * 8, numCoords);
3416363a54bSMatthew G. Knepley   PetscCall(PetscArrayzero(intPoints, dim * 18));
3426363a54bSMatthew G. Knepley 
3436363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3446363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsA[v] * cdim + d];
3456363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintA, &intPoints[Nsum * cdim]));
3466363a54bSMatthew G. Knepley   Nsum += NintA;
3476363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3486363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsB[v] * cdim + d];
3496363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintB, &intPoints[Nsum * cdim]));
3506363a54bSMatthew G. Knepley   Nsum += NintB;
3516363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3526363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsC[v] * cdim + d];
3536363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintC, &intPoints[Nsum * cdim]));
3546363a54bSMatthew G. Knepley   Nsum += NintC;
3556363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3566363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsD[v] * cdim + d];
3576363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintD, &intPoints[Nsum * cdim]));
3586363a54bSMatthew G. Knepley   Nsum += NintD;
3596363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3606363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsE[v] * cdim + d];
3616363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintE, &intPoints[Nsum * cdim]));
3626363a54bSMatthew G. Knepley   Nsum += NintE;
3636363a54bSMatthew G. Knepley   for (PetscInt v = 0; v < 4; ++v)
3646363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) tcoords[v * cdim + d] = coords[vertsF[v] * cdim + d];
3656363a54bSMatthew G. Knepley   PetscCall(DMPlexGetPlaneSimplexIntersection_Coords_Internal(dm, dim, cdim, tcoords, p, normal, pos, &NintF, &intPoints[Nsum * cdim]));
3666363a54bSMatthew G. Knepley   Nsum += NintF;
3676363a54bSMatthew G. Knepley   *Nint = Nsum;
3686363a54bSMatthew G. Knepley 
3696363a54bSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
3706363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
3716363a54bSMatthew G. Knepley }
3726363a54bSMatthew G. Knepley 
3736363a54bSMatthew G. Knepley /*
3746363a54bSMatthew G. Knepley   DMPlexGetPlaneCellIntersection_Internal - Finds the intersection of a plane with a cell
3756363a54bSMatthew G. Knepley 
3766363a54bSMatthew G. Knepley   Not collective
3776363a54bSMatthew G. Knepley 
3786363a54bSMatthew G. Knepley   Input Parameters:
3796363a54bSMatthew G. Knepley + dm     - the DM
3806363a54bSMatthew G. Knepley . c      - the mesh point
3816363a54bSMatthew G. Knepley . p      - a point on the plane.
3826363a54bSMatthew G. Knepley - normal - a normal vector to the plane, must be normalized
3836363a54bSMatthew G. Knepley 
3846363a54bSMatthew G. Knepley   Output Parameters:
3856363a54bSMatthew G. Knepley . pos       - `PETSC_TRUE` is the cell is on the positive side of the plane, `PETSC_FALSE` on the negative side
3866363a54bSMatthew G. Knepley + Nint      - the number of intersection points, in [0, 4]
3876363a54bSMatthew G. Knepley - intPoints - the coordinates of the intersection points, should be length at least 12
3886363a54bSMatthew G. Knepley 
3896363a54bSMatthew G. Knepley   Note: The `pos` argument is only meaningfull if the number of intersections is 0. The algorithmic idea comes from https://github.com/chrisk314/tet-plane-intersection.
3906363a54bSMatthew G. Knepley 
3916363a54bSMatthew G. Knepley   Level: developer
3926363a54bSMatthew G. Knepley 
3936363a54bSMatthew G. Knepley .seealso:
3946363a54bSMatthew G. Knepley @*/
3956363a54bSMatthew G. Knepley static PetscErrorCode DMPlexGetPlaneCellIntersection_Internal(DM dm, PetscInt c, const PetscReal p[], const PetscReal normal[], PetscBool *pos, PetscInt *Nint, PetscReal intPoints[])
3966363a54bSMatthew G. Knepley {
3976363a54bSMatthew G. Knepley   DMPolytopeType ct;
3986363a54bSMatthew G. Knepley 
3996363a54bSMatthew G. Knepley   PetscFunctionBegin;
4006363a54bSMatthew G. Knepley   PetscCall(DMPlexGetCellType(dm, c, &ct));
4016363a54bSMatthew G. Knepley   switch (ct) {
4026363a54bSMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
4036363a54bSMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
4046363a54bSMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
4056363a54bSMatthew G. Knepley     PetscCall(DMPlexGetPlaneSimplexIntersection_Internal(dm, DMPolytopeTypeGetDim(ct), c, p, normal, pos, Nint, intPoints));
4066363a54bSMatthew G. Knepley     break;
4076363a54bSMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
4086363a54bSMatthew G. Knepley     PetscCall(DMPlexGetPlaneQuadIntersection_Internal(dm, DMPolytopeTypeGetDim(ct), c, p, normal, pos, Nint, intPoints));
4096363a54bSMatthew G. Knepley     break;
4106363a54bSMatthew G. Knepley   case DM_POLYTOPE_HEXAHEDRON:
4116363a54bSMatthew G. Knepley     PetscCall(DMPlexGetPlaneHexIntersection_Internal(dm, DMPolytopeTypeGetDim(ct), c, p, normal, pos, Nint, intPoints));
4126363a54bSMatthew G. Knepley     break;
4136363a54bSMatthew G. Knepley   default:
4146363a54bSMatthew G. Knepley     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "No plane intersection for cell %" PetscInt_FMT " with type %s", c, DMPolytopeTypes[ct]);
4156363a54bSMatthew G. Knepley   }
4166363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
4176363a54bSMatthew G. Knepley }
418ddce0771SMatthew G. Knepley 
419d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexLocatePoint_Simplex_1D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscInt *cell)
420d71ae5a4SJacob Faibussowitsch {
42114bbb9f0SLawrence Mitchell   const PetscReal eps = PETSC_SQRT_MACHINE_EPSILON;
42214bbb9f0SLawrence Mitchell   const PetscReal x   = PetscRealPart(point[0]);
42314bbb9f0SLawrence Mitchell   PetscReal       v0, J, invJ, detJ;
42414bbb9f0SLawrence Mitchell   PetscReal       xi;
42514bbb9f0SLawrence Mitchell 
42614bbb9f0SLawrence Mitchell   PetscFunctionBegin;
4279566063dSJacob Faibussowitsch   PetscCall(DMPlexComputeCellGeometryFEM(dm, c, NULL, &v0, &J, &invJ, &detJ));
42814bbb9f0SLawrence Mitchell   xi = invJ * (x - v0);
42914bbb9f0SLawrence Mitchell 
43014bbb9f0SLawrence Mitchell   if ((xi >= -eps) && (xi <= 2. + eps)) *cell = c;
43114bbb9f0SLawrence Mitchell   else *cell = DMLOCATEPOINT_POINT_NOT_FOUND;
4323ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
43314bbb9f0SLawrence Mitchell }
43414bbb9f0SLawrence Mitchell 
435d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexLocatePoint_Simplex_2D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscInt *cell)
436d71ae5a4SJacob Faibussowitsch {
437ccd2543fSMatthew G Knepley   const PetscInt  embedDim = 2;
438f5ebc837SMatthew G. Knepley   const PetscReal eps      = PETSC_SQRT_MACHINE_EPSILON;
439ccd2543fSMatthew G Knepley   PetscReal       x        = PetscRealPart(point[0]);
440ccd2543fSMatthew G Knepley   PetscReal       y        = PetscRealPart(point[1]);
441ccd2543fSMatthew G Knepley   PetscReal       v0[2], J[4], invJ[4], detJ;
442ccd2543fSMatthew G Knepley   PetscReal       xi, eta;
443ccd2543fSMatthew G Knepley 
444ccd2543fSMatthew G Knepley   PetscFunctionBegin;
4459566063dSJacob Faibussowitsch   PetscCall(DMPlexComputeCellGeometryFEM(dm, c, NULL, v0, J, invJ, &detJ));
446ccd2543fSMatthew G Knepley   xi  = invJ[0 * embedDim + 0] * (x - v0[0]) + invJ[0 * embedDim + 1] * (y - v0[1]);
447ccd2543fSMatthew G Knepley   eta = invJ[1 * embedDim + 0] * (x - v0[0]) + invJ[1 * embedDim + 1] * (y - v0[1]);
448ccd2543fSMatthew G Knepley 
449f5ebc837SMatthew G. Knepley   if ((xi >= -eps) && (eta >= -eps) && (xi + eta <= 2.0 + eps)) *cell = c;
450c1496c66SMatthew G. Knepley   else *cell = DMLOCATEPOINT_POINT_NOT_FOUND;
4513ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
452ccd2543fSMatthew G Knepley }
453ccd2543fSMatthew G Knepley 
454d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexClosestPoint_Simplex_2D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscReal cpoint[])
455d71ae5a4SJacob Faibussowitsch {
45662a38674SMatthew G. Knepley   const PetscInt embedDim = 2;
45762a38674SMatthew G. Knepley   PetscReal      x        = PetscRealPart(point[0]);
45862a38674SMatthew G. Knepley   PetscReal      y        = PetscRealPart(point[1]);
45962a38674SMatthew G. Knepley   PetscReal      v0[2], J[4], invJ[4], detJ;
46062a38674SMatthew G. Knepley   PetscReal      xi, eta, r;
46162a38674SMatthew G. Knepley 
46262a38674SMatthew G. Knepley   PetscFunctionBegin;
4639566063dSJacob Faibussowitsch   PetscCall(DMPlexComputeCellGeometryFEM(dm, c, NULL, v0, J, invJ, &detJ));
46462a38674SMatthew G. Knepley   xi  = invJ[0 * embedDim + 0] * (x - v0[0]) + invJ[0 * embedDim + 1] * (y - v0[1]);
46562a38674SMatthew G. Knepley   eta = invJ[1 * embedDim + 0] * (x - v0[0]) + invJ[1 * embedDim + 1] * (y - v0[1]);
46662a38674SMatthew G. Knepley 
46762a38674SMatthew G. Knepley   xi  = PetscMax(xi, 0.0);
46862a38674SMatthew G. Knepley   eta = PetscMax(eta, 0.0);
46962a38674SMatthew G. Knepley   if (xi + eta > 2.0) {
47062a38674SMatthew G. Knepley     r = (xi + eta) / 2.0;
47162a38674SMatthew G. Knepley     xi /= r;
47262a38674SMatthew G. Knepley     eta /= r;
47362a38674SMatthew G. Knepley   }
47462a38674SMatthew G. Knepley   cpoint[0] = J[0 * embedDim + 0] * xi + J[0 * embedDim + 1] * eta + v0[0];
47562a38674SMatthew G. Knepley   cpoint[1] = J[1 * embedDim + 0] * xi + J[1 * embedDim + 1] * eta + v0[1];
4763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
47762a38674SMatthew G. Knepley }
47862a38674SMatthew G. Knepley 
47961451c10SMatthew G. Knepley // This is the ray-casting, or even-odd algorithm: https://en.wikipedia.org/wiki/Even%E2%80%93odd_rule
480d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexLocatePoint_Quad_2D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscInt *cell)
481d71ae5a4SJacob Faibussowitsch {
48276b3799dSMatthew G. Knepley   const PetscScalar *array;
483a1e44745SMatthew G. Knepley   PetscScalar       *coords    = NULL;
484ccd2543fSMatthew G Knepley   const PetscInt     faces[8]  = {0, 1, 1, 2, 2, 3, 3, 0};
485ccd2543fSMatthew G Knepley   PetscReal          x         = PetscRealPart(point[0]);
486ccd2543fSMatthew G Knepley   PetscReal          y         = PetscRealPart(point[1]);
48776b3799dSMatthew G. Knepley   PetscInt           crossings = 0, numCoords, f;
48876b3799dSMatthew G. Knepley   PetscBool          isDG;
489ccd2543fSMatthew G Knepley 
490ccd2543fSMatthew G Knepley   PetscFunctionBegin;
49176b3799dSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
49276b3799dSMatthew G. Knepley   PetscCheck(numCoords == 8, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Quadrilateral should have 8 coordinates, not %" PetscInt_FMT, numCoords);
493ccd2543fSMatthew G Knepley   for (f = 0; f < 4; ++f) {
494ccd2543fSMatthew G Knepley     PetscReal x_i = PetscRealPart(coords[faces[2 * f + 0] * 2 + 0]);
495ccd2543fSMatthew G Knepley     PetscReal y_i = PetscRealPart(coords[faces[2 * f + 0] * 2 + 1]);
496ccd2543fSMatthew G Knepley     PetscReal x_j = PetscRealPart(coords[faces[2 * f + 1] * 2 + 0]);
497ccd2543fSMatthew G Knepley     PetscReal y_j = PetscRealPart(coords[faces[2 * f + 1] * 2 + 1]);
49861451c10SMatthew G. Knepley 
49961451c10SMatthew G. Knepley     if ((x == x_j) && (y == y_j)) {
50061451c10SMatthew G. Knepley       // point is a corner
50161451c10SMatthew G. Knepley       crossings = 1;
50261451c10SMatthew G. Knepley       break;
50361451c10SMatthew G. Knepley     }
50461451c10SMatthew G. Knepley     if ((y_j > y) != (y_i > y)) {
50561451c10SMatthew G. Knepley       PetscReal slope = (x - x_j) * (y_i - y_j) - (x_i - x_j) * (y - y_j);
50661451c10SMatthew G. Knepley       if (slope == 0) {
50761451c10SMatthew G. Knepley         // point is a corner
50861451c10SMatthew G. Knepley         crossings = 1;
50961451c10SMatthew G. Knepley         break;
51061451c10SMatthew G. Knepley       }
51161451c10SMatthew G. Knepley       if ((slope < 0) != (y_i < y_j)) ++crossings;
51261451c10SMatthew G. Knepley     }
513ccd2543fSMatthew G Knepley   }
514ccd2543fSMatthew G Knepley   if (crossings % 2) *cell = c;
515c1496c66SMatthew G. Knepley   else *cell = DMLOCATEPOINT_POINT_NOT_FOUND;
51676b3799dSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
5173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
518ccd2543fSMatthew G Knepley }
519ccd2543fSMatthew G Knepley 
520d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexLocatePoint_Simplex_3D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscInt *cell)
521d71ae5a4SJacob Faibussowitsch {
522ccd2543fSMatthew G Knepley   const PetscInt  embedDim = 3;
52337900f7dSMatthew G. Knepley   const PetscReal eps      = PETSC_SQRT_MACHINE_EPSILON;
524ccd2543fSMatthew G Knepley   PetscReal       v0[3], J[9], invJ[9], detJ;
525ccd2543fSMatthew G Knepley   PetscReal       x = PetscRealPart(point[0]);
526ccd2543fSMatthew G Knepley   PetscReal       y = PetscRealPart(point[1]);
527ccd2543fSMatthew G Knepley   PetscReal       z = PetscRealPart(point[2]);
528ccd2543fSMatthew G Knepley   PetscReal       xi, eta, zeta;
529ccd2543fSMatthew G Knepley 
530ccd2543fSMatthew G Knepley   PetscFunctionBegin;
5319566063dSJacob Faibussowitsch   PetscCall(DMPlexComputeCellGeometryFEM(dm, c, NULL, v0, J, invJ, &detJ));
532ccd2543fSMatthew G Knepley   xi   = invJ[0 * embedDim + 0] * (x - v0[0]) + invJ[0 * embedDim + 1] * (y - v0[1]) + invJ[0 * embedDim + 2] * (z - v0[2]);
533ccd2543fSMatthew G Knepley   eta  = invJ[1 * embedDim + 0] * (x - v0[0]) + invJ[1 * embedDim + 1] * (y - v0[1]) + invJ[1 * embedDim + 2] * (z - v0[2]);
534ccd2543fSMatthew G Knepley   zeta = invJ[2 * embedDim + 0] * (x - v0[0]) + invJ[2 * embedDim + 1] * (y - v0[1]) + invJ[2 * embedDim + 2] * (z - v0[2]);
535ccd2543fSMatthew G Knepley 
53637900f7dSMatthew G. Knepley   if ((xi >= -eps) && (eta >= -eps) && (zeta >= -eps) && (xi + eta + zeta <= 2.0 + eps)) *cell = c;
537c1496c66SMatthew G. Knepley   else *cell = DMLOCATEPOINT_POINT_NOT_FOUND;
5383ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
539ccd2543fSMatthew G Knepley }
540ccd2543fSMatthew G Knepley 
541d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexLocatePoint_General_3D_Internal(DM dm, const PetscScalar point[], PetscInt c, PetscInt *cell)
542d71ae5a4SJacob Faibussowitsch {
54376b3799dSMatthew G. Knepley   const PetscScalar *array;
544872a9804SMatthew G. Knepley   PetscScalar       *coords    = NULL;
5459371c9d4SSatish Balay   const PetscInt     faces[24] = {0, 3, 2, 1, 5, 4, 7, 6, 3, 0, 4, 5, 1, 2, 6, 7, 3, 5, 6, 2, 0, 1, 7, 4};
546ccd2543fSMatthew G Knepley   PetscBool          found     = PETSC_TRUE;
54776b3799dSMatthew G. Knepley   PetscInt           numCoords, f;
54876b3799dSMatthew G. Knepley   PetscBool          isDG;
549ccd2543fSMatthew G Knepley 
550ccd2543fSMatthew G Knepley   PetscFunctionBegin;
55176b3799dSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
55276b3799dSMatthew G. Knepley   PetscCheck(numCoords == 24, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Quadrilateral should have 8 coordinates, not %" PetscInt_FMT, numCoords);
553ccd2543fSMatthew G Knepley   for (f = 0; f < 6; ++f) {
554ccd2543fSMatthew G Knepley     /* Check the point is under plane */
555ccd2543fSMatthew G Knepley     /*   Get face normal */
556ccd2543fSMatthew G Knepley     PetscReal v_i[3];
557ccd2543fSMatthew G Knepley     PetscReal v_j[3];
558ccd2543fSMatthew G Knepley     PetscReal normal[3];
559ccd2543fSMatthew G Knepley     PetscReal pp[3];
560ccd2543fSMatthew G Knepley     PetscReal dot;
561ccd2543fSMatthew G Knepley 
562ccd2543fSMatthew G Knepley     v_i[0]    = PetscRealPart(coords[faces[f * 4 + 3] * 3 + 0] - coords[faces[f * 4 + 0] * 3 + 0]);
563ccd2543fSMatthew G Knepley     v_i[1]    = PetscRealPart(coords[faces[f * 4 + 3] * 3 + 1] - coords[faces[f * 4 + 0] * 3 + 1]);
564ccd2543fSMatthew G Knepley     v_i[2]    = PetscRealPart(coords[faces[f * 4 + 3] * 3 + 2] - coords[faces[f * 4 + 0] * 3 + 2]);
565ccd2543fSMatthew G Knepley     v_j[0]    = PetscRealPart(coords[faces[f * 4 + 1] * 3 + 0] - coords[faces[f * 4 + 0] * 3 + 0]);
566ccd2543fSMatthew G Knepley     v_j[1]    = PetscRealPart(coords[faces[f * 4 + 1] * 3 + 1] - coords[faces[f * 4 + 0] * 3 + 1]);
567ccd2543fSMatthew G Knepley     v_j[2]    = PetscRealPart(coords[faces[f * 4 + 1] * 3 + 2] - coords[faces[f * 4 + 0] * 3 + 2]);
568ccd2543fSMatthew G Knepley     normal[0] = v_i[1] * v_j[2] - v_i[2] * v_j[1];
569ccd2543fSMatthew G Knepley     normal[1] = v_i[2] * v_j[0] - v_i[0] * v_j[2];
570ccd2543fSMatthew G Knepley     normal[2] = v_i[0] * v_j[1] - v_i[1] * v_j[0];
571ccd2543fSMatthew G Knepley     pp[0]     = PetscRealPart(coords[faces[f * 4 + 0] * 3 + 0] - point[0]);
572ccd2543fSMatthew G Knepley     pp[1]     = PetscRealPart(coords[faces[f * 4 + 0] * 3 + 1] - point[1]);
573ccd2543fSMatthew G Knepley     pp[2]     = PetscRealPart(coords[faces[f * 4 + 0] * 3 + 2] - point[2]);
574ccd2543fSMatthew G Knepley     dot       = normal[0] * pp[0] + normal[1] * pp[1] + normal[2] * pp[2];
575ccd2543fSMatthew G Knepley 
576ccd2543fSMatthew G Knepley     /* Check that projected point is in face (2D location problem) */
577ccd2543fSMatthew G Knepley     if (dot < 0.0) {
578ccd2543fSMatthew G Knepley       found = PETSC_FALSE;
579ccd2543fSMatthew G Knepley       break;
580ccd2543fSMatthew G Knepley     }
581ccd2543fSMatthew G Knepley   }
582ccd2543fSMatthew G Knepley   if (found) *cell = c;
583c1496c66SMatthew G. Knepley   else *cell = DMLOCATEPOINT_POINT_NOT_FOUND;
58476b3799dSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
5853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
586ccd2543fSMatthew G Knepley }
587ccd2543fSMatthew G Knepley 
588d71ae5a4SJacob Faibussowitsch static PetscErrorCode PetscGridHashInitialize_Internal(PetscGridHash box, PetscInt dim, const PetscScalar point[])
589d71ae5a4SJacob Faibussowitsch {
590c4eade1cSMatthew G. Knepley   PetscInt d;
591c4eade1cSMatthew G. Knepley 
592c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
593c4eade1cSMatthew G. Knepley   box->dim = dim;
594378076f8SMatthew G. Knepley   for (d = 0; d < dim; ++d) box->lower[d] = box->upper[d] = point ? PetscRealPart(point[d]) : 0.;
5953ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
596c4eade1cSMatthew G. Knepley }
597c4eade1cSMatthew G. Knepley 
598d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashCreate(MPI_Comm comm, PetscInt dim, const PetscScalar point[], PetscGridHash *box)
599d71ae5a4SJacob Faibussowitsch {
600c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
6012b6f951bSStefano Zampini   PetscCall(PetscCalloc1(1, box));
6029566063dSJacob Faibussowitsch   PetscCall(PetscGridHashInitialize_Internal(*box, dim, point));
6033ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
604c4eade1cSMatthew G. Knepley }
605c4eade1cSMatthew G. Knepley 
606d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashEnlarge(PetscGridHash box, const PetscScalar point[])
607d71ae5a4SJacob Faibussowitsch {
608c4eade1cSMatthew G. Knepley   PetscInt d;
609c4eade1cSMatthew G. Knepley 
610c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
611c4eade1cSMatthew G. Knepley   for (d = 0; d < box->dim; ++d) {
612c4eade1cSMatthew G. Knepley     box->lower[d] = PetscMin(box->lower[d], PetscRealPart(point[d]));
613c4eade1cSMatthew G. Knepley     box->upper[d] = PetscMax(box->upper[d], PetscRealPart(point[d]));
614c4eade1cSMatthew G. Knepley   }
6153ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
616c4eade1cSMatthew G. Knepley }
617c4eade1cSMatthew G. Knepley 
6186363a54bSMatthew G. Knepley static PetscErrorCode DMPlexCreateGridHash(DM dm, PetscGridHash *box)
6196363a54bSMatthew G. Knepley {
6206363a54bSMatthew G. Knepley   Vec                coordinates;
6216363a54bSMatthew G. Knepley   const PetscScalar *coords;
6226363a54bSMatthew G. Knepley   PetscInt           cdim, N, bs;
6236363a54bSMatthew G. Knepley 
6246363a54bSMatthew G. Knepley   PetscFunctionBegin;
6256363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
6266363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
6276363a54bSMatthew G. Knepley   PetscCall(VecGetArrayRead(coordinates, &coords));
6286363a54bSMatthew G. Knepley   PetscCall(VecGetLocalSize(coordinates, &N));
6296363a54bSMatthew G. Knepley   PetscCall(VecGetBlockSize(coordinates, &bs));
6306363a54bSMatthew G. Knepley   PetscCheck(bs == cdim, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Coordinate block size %" PetscInt_FMT " != %" PetscInt_FMT " coordinate dimension", bs, cdim);
6316363a54bSMatthew G. Knepley 
63223f0ada9SStefano Zampini   PetscCall(PetscGridHashCreate(PetscObjectComm((PetscObject)dm), cdim, coords, box));
6336363a54bSMatthew G. Knepley   for (PetscInt i = 0; i < N; i += cdim) PetscCall(PetscGridHashEnlarge(*box, &coords[i]));
6346363a54bSMatthew G. Knepley 
6356363a54bSMatthew G. Knepley   PetscCall(VecRestoreArrayRead(coordinates, &coords));
6366363a54bSMatthew G. Knepley   PetscFunctionReturn(PETSC_SUCCESS);
6376363a54bSMatthew G. Knepley }
6386363a54bSMatthew G. Knepley 
63962a38674SMatthew G. Knepley /*
64062a38674SMatthew G. Knepley   PetscGridHashSetGrid - Divide the grid into boxes
64162a38674SMatthew G. Knepley 
64220f4b53cSBarry Smith   Not Collective
64362a38674SMatthew G. Knepley 
64462a38674SMatthew G. Knepley   Input Parameters:
64562a38674SMatthew G. Knepley + box - The grid hash object
64620f4b53cSBarry Smith . n   - The number of boxes in each dimension, or `PETSC_DETERMINE`
64720f4b53cSBarry Smith - h   - The box size in each dimension, only used if n[d] == `PETSC_DETERMINE`
64862a38674SMatthew G. Knepley 
64962a38674SMatthew G. Knepley   Level: developer
65062a38674SMatthew G. Knepley 
6512fe279fdSBarry Smith .seealso: `DMPLEX`, `PetscGridHashCreate()`
65262a38674SMatthew G. Knepley */
653d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashSetGrid(PetscGridHash box, const PetscInt n[], const PetscReal h[])
654d71ae5a4SJacob Faibussowitsch {
655c4eade1cSMatthew G. Knepley   PetscInt d;
656c4eade1cSMatthew G. Knepley 
657c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
65823f0ada9SStefano Zampini   PetscValidIntPointer(n, 2);
65923f0ada9SStefano Zampini   if (h) PetscValidRealPointer(h, 3);
660c4eade1cSMatthew G. Knepley   for (d = 0; d < box->dim; ++d) {
661c4eade1cSMatthew G. Knepley     box->extent[d] = box->upper[d] - box->lower[d];
662c4eade1cSMatthew G. Knepley     if (n[d] == PETSC_DETERMINE) {
66323f0ada9SStefano Zampini       PetscCheck(h, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Missing h");
664c4eade1cSMatthew G. Knepley       box->h[d] = h[d];
665c4eade1cSMatthew G. Knepley       box->n[d] = PetscCeilReal(box->extent[d] / h[d]);
666c4eade1cSMatthew G. Knepley     } else {
667c4eade1cSMatthew G. Knepley       box->n[d] = n[d];
668c4eade1cSMatthew G. Knepley       box->h[d] = box->extent[d] / n[d];
669c4eade1cSMatthew G. Knepley     }
670c4eade1cSMatthew G. Knepley   }
6713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
672c4eade1cSMatthew G. Knepley }
673c4eade1cSMatthew G. Knepley 
67462a38674SMatthew G. Knepley /*
67562a38674SMatthew G. Knepley   PetscGridHashGetEnclosingBox - Find the grid boxes containing each input point
67662a38674SMatthew G. Knepley 
67720f4b53cSBarry Smith   Not Collective
67862a38674SMatthew G. Knepley 
67962a38674SMatthew G. Knepley   Input Parameters:
68062a38674SMatthew G. Knepley + box       - The grid hash object
68162a38674SMatthew G. Knepley . numPoints - The number of input points
68262a38674SMatthew G. Knepley - points    - The input point coordinates
68362a38674SMatthew G. Knepley 
68462a38674SMatthew G. Knepley   Output Parameters:
68562a38674SMatthew G. Knepley + dboxes    - An array of numPoints*dim integers expressing the enclosing box as (i_0, i_1, ..., i_dim)
68662a38674SMatthew G. Knepley - boxes     - An array of numPoints integers expressing the enclosing box as single number, or NULL
68762a38674SMatthew G. Knepley 
68862a38674SMatthew G. Knepley   Level: developer
68962a38674SMatthew G. Knepley 
690f5867de0SMatthew G. Knepley   Note:
691f5867de0SMatthew G. Knepley   This only guarantees that a box contains a point, not that a cell does.
692f5867de0SMatthew G. Knepley 
6932fe279fdSBarry Smith .seealso: `DMPLEX`, `PetscGridHashCreate()`
69462a38674SMatthew G. Knepley */
695d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashGetEnclosingBox(PetscGridHash box, PetscInt numPoints, const PetscScalar points[], PetscInt dboxes[], PetscInt boxes[])
696d71ae5a4SJacob Faibussowitsch {
697c4eade1cSMatthew G. Knepley   const PetscReal *lower = box->lower;
698c4eade1cSMatthew G. Knepley   const PetscReal *upper = box->upper;
699c4eade1cSMatthew G. Knepley   const PetscReal *h     = box->h;
700c4eade1cSMatthew G. Knepley   const PetscInt  *n     = box->n;
701c4eade1cSMatthew G. Knepley   const PetscInt   dim   = box->dim;
702c4eade1cSMatthew G. Knepley   PetscInt         d, p;
703c4eade1cSMatthew G. Knepley 
704c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
705c4eade1cSMatthew G. Knepley   for (p = 0; p < numPoints; ++p) {
706c4eade1cSMatthew G. Knepley     for (d = 0; d < dim; ++d) {
7071c6dfc3eSMatthew G. Knepley       PetscInt dbox = PetscFloorReal((PetscRealPart(points[p * dim + d]) - lower[d]) / h[d]);
708c4eade1cSMatthew G. Knepley 
7091c6dfc3eSMatthew G. Knepley       if (dbox == n[d] && PetscAbsReal(PetscRealPart(points[p * dim + d]) - upper[d]) < 1.0e-9) dbox = n[d] - 1;
7102a705cacSMatthew G. Knepley       if (dbox == -1 && PetscAbsReal(PetscRealPart(points[p * dim + d]) - lower[d]) < 1.0e-9) dbox = 0;
7119371c9d4SSatish Balay       PetscCheck(dbox >= 0 && dbox<n[d], PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Input point %" PetscInt_FMT " (%g, %g, %g) is outside of our bounding box", p, (double)PetscRealPart(points[p * dim + 0]), dim> 1 ? (double)PetscRealPart(points[p * dim + 1]) : 0.0, dim > 2 ? (double)PetscRealPart(points[p * dim + 2]) : 0.0);
712c4eade1cSMatthew G. Knepley       dboxes[p * dim + d] = dbox;
713c4eade1cSMatthew G. Knepley     }
7149371c9d4SSatish Balay     if (boxes)
7159371c9d4SSatish Balay       for (d = dim - 2, boxes[p] = dboxes[p * dim + dim - 1]; d >= 0; --d) boxes[p] = boxes[p] * n[d] + dboxes[p * dim + d];
716c4eade1cSMatthew G. Knepley   }
7173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
718c4eade1cSMatthew G. Knepley }
719c4eade1cSMatthew G. Knepley 
720af74b616SDave May /*
721af74b616SDave May  PetscGridHashGetEnclosingBoxQuery - Find the grid boxes containing each input point
722af74b616SDave May 
72320f4b53cSBarry Smith  Not Collective
724af74b616SDave May 
725af74b616SDave May   Input Parameters:
726af74b616SDave May + box         - The grid hash object
727f5867de0SMatthew G. Knepley . cellSection - The PetscSection mapping cells to boxes
728af74b616SDave May . numPoints   - The number of input points
729af74b616SDave May - points      - The input point coordinates
730af74b616SDave May 
731af74b616SDave May   Output Parameters:
73220f4b53cSBarry Smith + dboxes - An array of `numPoints`*`dim` integers expressing the enclosing box as (i_0, i_1, ..., i_dim)
73320f4b53cSBarry Smith . boxes  - An array of `numPoints` integers expressing the enclosing box as single number, or `NULL`
734af74b616SDave May - found  - Flag indicating if point was located within a box
735af74b616SDave May 
736af74b616SDave May   Level: developer
737af74b616SDave May 
738f5867de0SMatthew G. Knepley   Note:
73920f4b53cSBarry Smith   This does an additional check that a cell actually contains the point, and found is `PETSC_FALSE` if no cell does. Thus, this function requires that `cellSection` is already constructed.
740f5867de0SMatthew G. Knepley 
7412fe279fdSBarry Smith .seealso: `DMPLEX`, `PetscGridHashGetEnclosingBox()`
742af74b616SDave May */
743d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashGetEnclosingBoxQuery(PetscGridHash box, PetscSection cellSection, PetscInt numPoints, const PetscScalar points[], PetscInt dboxes[], PetscInt boxes[], PetscBool *found)
744d71ae5a4SJacob Faibussowitsch {
745af74b616SDave May   const PetscReal *lower = box->lower;
746af74b616SDave May   const PetscReal *upper = box->upper;
747af74b616SDave May   const PetscReal *h     = box->h;
748af74b616SDave May   const PetscInt  *n     = box->n;
749af74b616SDave May   const PetscInt   dim   = box->dim;
750f5867de0SMatthew G. Knepley   PetscInt         bStart, bEnd, d, p;
751af74b616SDave May 
752af74b616SDave May   PetscFunctionBegin;
753f5867de0SMatthew G. Knepley   PetscValidHeaderSpecific(cellSection, PETSC_SECTION_CLASSID, 2);
754af74b616SDave May   *found = PETSC_FALSE;
755f5867de0SMatthew G. Knepley   PetscCall(PetscSectionGetChart(box->cellSection, &bStart, &bEnd));
756af74b616SDave May   for (p = 0; p < numPoints; ++p) {
757af74b616SDave May     for (d = 0; d < dim; ++d) {
758af74b616SDave May       PetscInt dbox = PetscFloorReal((PetscRealPart(points[p * dim + d]) - lower[d]) / h[d]);
759af74b616SDave May 
760af74b616SDave May       if (dbox == n[d] && PetscAbsReal(PetscRealPart(points[p * dim + d]) - upper[d]) < 1.0e-9) dbox = n[d] - 1;
7613ba16761SJacob Faibussowitsch       if (dbox < 0 || dbox >= n[d]) PetscFunctionReturn(PETSC_SUCCESS);
762af74b616SDave May       dboxes[p * dim + d] = dbox;
763af74b616SDave May     }
7649371c9d4SSatish Balay     if (boxes)
7659371c9d4SSatish Balay       for (d = dim - 2, boxes[p] = dboxes[p * dim + dim - 1]; d >= 0; --d) boxes[p] = boxes[p] * n[d] + dboxes[p * dim + d];
766f5867de0SMatthew G. Knepley     // It is possible for a box to overlap no grid cells
7673ba16761SJacob Faibussowitsch     if (boxes[p] < bStart || boxes[p] >= bEnd) PetscFunctionReturn(PETSC_SUCCESS);
768af74b616SDave May   }
769af74b616SDave May   *found = PETSC_TRUE;
7703ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
771af74b616SDave May }
772af74b616SDave May 
773d71ae5a4SJacob Faibussowitsch PetscErrorCode PetscGridHashDestroy(PetscGridHash *box)
774d71ae5a4SJacob Faibussowitsch {
775c4eade1cSMatthew G. Knepley   PetscFunctionBegin;
776c4eade1cSMatthew G. Knepley   if (*box) {
7779566063dSJacob Faibussowitsch     PetscCall(PetscSectionDestroy(&(*box)->cellSection));
7789566063dSJacob Faibussowitsch     PetscCall(ISDestroy(&(*box)->cells));
7799566063dSJacob Faibussowitsch     PetscCall(DMLabelDestroy(&(*box)->cellsSparse));
780c4eade1cSMatthew G. Knepley   }
7819566063dSJacob Faibussowitsch   PetscCall(PetscFree(*box));
7823ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
783c4eade1cSMatthew G. Knepley }
784c4eade1cSMatthew G. Knepley 
785d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexLocatePoint_Internal(DM dm, PetscInt dim, const PetscScalar point[], PetscInt cellStart, PetscInt *cell)
786d71ae5a4SJacob Faibussowitsch {
787ba2698f1SMatthew G. Knepley   DMPolytopeType ct;
788cafe43deSMatthew G. Knepley 
789cafe43deSMatthew G. Knepley   PetscFunctionBegin;
7909566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCellType(dm, cellStart, &ct));
791ba2698f1SMatthew G. Knepley   switch (ct) {
792d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_SEGMENT:
793d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexLocatePoint_Simplex_1D_Internal(dm, point, cellStart, cell));
794d71ae5a4SJacob Faibussowitsch     break;
795d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_TRIANGLE:
796d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexLocatePoint_Simplex_2D_Internal(dm, point, cellStart, cell));
797d71ae5a4SJacob Faibussowitsch     break;
798d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_QUADRILATERAL:
799d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexLocatePoint_Quad_2D_Internal(dm, point, cellStart, cell));
800d71ae5a4SJacob Faibussowitsch     break;
801d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_TETRAHEDRON:
802d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexLocatePoint_Simplex_3D_Internal(dm, point, cellStart, cell));
803d71ae5a4SJacob Faibussowitsch     break;
804d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_HEXAHEDRON:
805d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexLocatePoint_General_3D_Internal(dm, point, cellStart, cell));
806d71ae5a4SJacob Faibussowitsch     break;
807d71ae5a4SJacob Faibussowitsch   default:
808d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "No point location for cell %" PetscInt_FMT " with type %s", cellStart, DMPolytopeTypes[ct]);
809cafe43deSMatthew G. Knepley   }
8103ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
811cafe43deSMatthew G. Knepley }
812cafe43deSMatthew G. Knepley 
81362a38674SMatthew G. Knepley /*
81462a38674SMatthew G. Knepley   DMPlexClosestPoint_Internal - Returns the closest point in the cell to the given point
81562a38674SMatthew G. Knepley */
816d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexClosestPoint_Internal(DM dm, PetscInt dim, const PetscScalar point[], PetscInt cell, PetscReal cpoint[])
817d71ae5a4SJacob Faibussowitsch {
818ba2698f1SMatthew G. Knepley   DMPolytopeType ct;
81962a38674SMatthew G. Knepley 
82062a38674SMatthew G. Knepley   PetscFunctionBegin;
8219566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCellType(dm, cell, &ct));
822ba2698f1SMatthew G. Knepley   switch (ct) {
823d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_TRIANGLE:
824d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexClosestPoint_Simplex_2D_Internal(dm, point, cell, cpoint));
825d71ae5a4SJacob Faibussowitsch     break;
82662a38674SMatthew G. Knepley #if 0
827ba2698f1SMatthew G. Knepley     case DM_POLYTOPE_QUADRILATERAL:
8289566063dSJacob Faibussowitsch     PetscCall(DMPlexClosestPoint_General_2D_Internal(dm, point, cell, cpoint));break;
829ba2698f1SMatthew G. Knepley     case DM_POLYTOPE_TETRAHEDRON:
8309566063dSJacob Faibussowitsch     PetscCall(DMPlexClosestPoint_Simplex_3D_Internal(dm, point, cell, cpoint));break;
831ba2698f1SMatthew G. Knepley     case DM_POLYTOPE_HEXAHEDRON:
8329566063dSJacob Faibussowitsch     PetscCall(DMPlexClosestPoint_General_3D_Internal(dm, point, cell, cpoint));break;
83362a38674SMatthew G. Knepley #endif
834d71ae5a4SJacob Faibussowitsch   default:
835d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "No closest point location for cell %" PetscInt_FMT " with type %s", cell, DMPolytopeTypes[ct]);
83662a38674SMatthew G. Knepley   }
8373ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
83862a38674SMatthew G. Knepley }
83962a38674SMatthew G. Knepley 
84062a38674SMatthew G. Knepley /*
84120f4b53cSBarry Smith   DMPlexComputeGridHash_Internal - Create a grid hash structure covering the `DMPLEX`
84262a38674SMatthew G. Knepley 
84320f4b53cSBarry Smith   Collective
84462a38674SMatthew G. Knepley 
84562a38674SMatthew G. Knepley   Input Parameter:
84620f4b53cSBarry Smith . dm - The `DMPLEX`
84762a38674SMatthew G. Knepley 
84862a38674SMatthew G. Knepley   Output Parameter:
84962a38674SMatthew G. Knepley . localBox - The grid hash object
85062a38674SMatthew G. Knepley 
85162a38674SMatthew G. Knepley   Level: developer
85262a38674SMatthew G. Knepley 
8536363a54bSMatthew G. Knepley   Notes:
8546363a54bSMatthew G. Knepley   How do we determine all boxes intersecting a given cell?
8556363a54bSMatthew G. Knepley 
8566363a54bSMatthew G. Knepley   1) Get convex body enclosing cell. We will use a box called the box-hull.
8576363a54bSMatthew G. Knepley 
8586363a54bSMatthew G. Knepley   2) Get smallest brick of boxes enclosing the box-hull
8596363a54bSMatthew G. Knepley 
8606363a54bSMatthew G. Knepley   3) Each box is composed of 6 planes, 3 lower and 3 upper. We loop over dimensions, and
8616363a54bSMatthew G. Knepley      for each new plane determine whether the cell is on the negative side, positive side, or intersects it.
8626363a54bSMatthew G. Knepley 
8636363a54bSMatthew G. Knepley      a) If the cell is on the negative side of the lower planes, it is not in the box
8646363a54bSMatthew G. Knepley 
8656363a54bSMatthew G. Knepley      b) If the cell is on the positive side of the upper planes, it is not in the box
8666363a54bSMatthew G. Knepley 
8676363a54bSMatthew G. Knepley      c) If there is no intersection, it is in the box
8686363a54bSMatthew G. Knepley 
8696363a54bSMatthew G. Knepley      d) If any intersection point is within the box limits, it is in the box
8706363a54bSMatthew G. Knepley 
87120f4b53cSBarry Smith .seealso: `DMPLEX`, `PetscGridHashCreate()`, `PetscGridHashGetEnclosingBox()`
87262a38674SMatthew G. Knepley */
873d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeGridHash_Internal(DM dm, PetscGridHash *localBox)
874d71ae5a4SJacob Faibussowitsch {
875f5867de0SMatthew G. Knepley   PetscInt        debug = ((DM_Plex *)dm->data)->printLocate;
876cafe43deSMatthew G. Knepley   PetscGridHash   lbox;
87796217254SMatthew G. Knepley   PetscSF         sf;
87896217254SMatthew G. Knepley   const PetscInt *leaves;
8796363a54bSMatthew G. Knepley   PetscInt       *dboxes, *boxes;
8806363a54bSMatthew G. Knepley   PetscInt        cdim, cStart, cEnd, Nl = -1;
881ddce0771SMatthew G. Knepley   PetscBool       flg;
882cafe43deSMatthew G. Knepley 
883cafe43deSMatthew G. Knepley   PetscFunctionBegin;
8846363a54bSMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
8859566063dSJacob Faibussowitsch   PetscCall(DMPlexGetSimplexOrBoxCells(dm, 0, &cStart, &cEnd));
8866363a54bSMatthew G. Knepley   PetscCall(DMPlexCreateGridHash(dm, &lbox));
8876363a54bSMatthew G. Knepley   {
8886363a54bSMatthew G. Knepley     PetscInt n[3], d;
8896363a54bSMatthew G. Knepley 
8906363a54bSMatthew G. Knepley     PetscCall(PetscOptionsGetIntArray(NULL, ((PetscObject)dm)->prefix, "-dm_plex_hash_box_faces", n, &d, &flg));
8919371c9d4SSatish Balay     if (flg) {
8926363a54bSMatthew G. Knepley       for (PetscInt i = d; i < cdim; ++i) n[i] = n[d - 1];
8939371c9d4SSatish Balay     } else {
8946363a54bSMatthew G. Knepley       for (PetscInt i = 0; i < cdim; ++i) n[i] = PetscMax(2, PetscFloorReal(PetscPowReal((PetscReal)(cEnd - cStart), 1.0 / cdim) * 0.8));
8959371c9d4SSatish Balay     }
8969566063dSJacob Faibussowitsch     PetscCall(PetscGridHashSetGrid(lbox, n, NULL));
8979371c9d4SSatish Balay     if (debug)
8986363a54bSMatthew G. Knepley       PetscCall(PetscPrintf(PETSC_COMM_SELF, "GridHash:\n  (%g, %g, %g) -- (%g, %g, %g)\n  n %" PetscInt_FMT " %" PetscInt_FMT " %" PetscInt_FMT "\n  h %g %g %g\n", (double)lbox->lower[0], (double)lbox->lower[1], cdim > 2 ? (double)lbox->lower[2] : 0.,
8996363a54bSMatthew G. Knepley                             (double)lbox->upper[0], (double)lbox->upper[1], cdim > 2 ? (double)lbox->upper[2] : 0, n[0], n[1], cdim > 2 ? n[2] : 0, (double)lbox->h[0], (double)lbox->h[1], cdim > 2 ? (double)lbox->h[2] : 0.));
9006363a54bSMatthew G. Knepley   }
9016363a54bSMatthew G. Knepley 
90296217254SMatthew G. Knepley   PetscCall(DMGetPointSF(dm, &sf));
90396217254SMatthew G. Knepley   if (sf) PetscCall(PetscSFGetGraph(sf, NULL, &Nl, &leaves, NULL));
90496217254SMatthew G. Knepley   Nl = PetscMax(Nl, 0);
9056363a54bSMatthew G. Knepley   PetscCall(PetscCalloc2(16 * cdim, &dboxes, 16, &boxes));
9066363a54bSMatthew G. Knepley 
9076363a54bSMatthew G. Knepley   PetscCall(DMLabelCreate(PETSC_COMM_SELF, "cells", &lbox->cellsSparse));
9086363a54bSMatthew G. Knepley   PetscCall(DMLabelCreateIndex(lbox->cellsSparse, cStart, cEnd));
9096363a54bSMatthew G. Knepley   for (PetscInt c = cStart; c < cEnd; ++c) {
9106363a54bSMatthew G. Knepley     PetscReal          intPoints[6 * 6 * 6 * 3];
9116363a54bSMatthew G. Knepley     const PetscScalar *array;
9126363a54bSMatthew G. Knepley     PetscScalar       *coords            = NULL;
913cafe43deSMatthew G. Knepley     const PetscReal   *h                 = lbox->h;
9146363a54bSMatthew G. Knepley     PetscReal          normal[9]         = {1., 0., 0., 0., 1., 0., 0., 0., 1.};
9156363a54bSMatthew G. Knepley     PetscReal         *lowerIntPoints[3] = {&intPoints[0 * 6 * 6 * 3], &intPoints[1 * 6 * 6 * 3], &intPoints[2 * 6 * 6 * 3]};
9166363a54bSMatthew G. Knepley     PetscReal         *upperIntPoints[3] = {&intPoints[3 * 6 * 6 * 3], &intPoints[4 * 6 * 6 * 3], &intPoints[5 * 6 * 6 * 3]};
9176363a54bSMatthew G. Knepley     PetscReal          lp[3], up[3], *tmp;
9186363a54bSMatthew G. Knepley     PetscInt           numCoords, idx, dlim[6], lowerInt[3], upperInt[3];
9196363a54bSMatthew G. Knepley     PetscBool          isDG, lower[3], upper[3];
920cafe43deSMatthew G. Knepley 
92196217254SMatthew G. Knepley     PetscCall(PetscFindInt(c, Nl, leaves, &idx));
92296217254SMatthew G. Knepley     if (idx >= 0) continue;
9236363a54bSMatthew G. Knepley     // Get grid of boxes containing the cell
9246363a54bSMatthew G. Knepley     PetscCall(DMPlexGetCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
9256363a54bSMatthew G. Knepley     PetscCall(PetscGridHashGetEnclosingBox(lbox, numCoords / cdim, coords, dboxes, boxes));
9266363a54bSMatthew G. Knepley     PetscCall(DMPlexRestoreCellCoordinates(dm, c, &isDG, &numCoords, &array, &coords));
9276363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) dlim[d * 2 + 0] = dlim[d * 2 + 1] = dboxes[d];
9286363a54bSMatthew G. Knepley     for (PetscInt d = cdim; d < 3; ++d) dlim[d * 2 + 0] = dlim[d * 2 + 1] = 0;
9296363a54bSMatthew G. Knepley     for (PetscInt e = 1; e < numCoords / cdim; ++e) {
9306363a54bSMatthew G. Knepley       for (PetscInt d = 0; d < cdim; ++d) {
9316363a54bSMatthew G. Knepley         dlim[d * 2 + 0] = PetscMin(dlim[d * 2 + 0], dboxes[e * cdim + d]);
9326363a54bSMatthew G. Knepley         dlim[d * 2 + 1] = PetscMax(dlim[d * 2 + 1], dboxes[e * cdim + d]);
933ddce0771SMatthew G. Knepley       }
934ddce0771SMatthew G. Knepley     }
9356363a54bSMatthew G. Knepley     if (debug > 4) {
9366363a54bSMatthew G. Knepley       for (PetscInt d = 0; d < cdim; ++d) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " direction %" PetscInt_FMT " box limits %" PetscInt_FMT "--%" PetscInt_FMT "\n", c, d, dlim[d * 2 + 0], dlim[d * 2 + 1]));
937ddce0771SMatthew G. Knepley     }
9386363a54bSMatthew G. Knepley     // Initialize with lower planes for first box
9396363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) {
9406363a54bSMatthew G. Knepley       lp[d] = lbox->lower[d] + dlim[d * 2 + 0] * h[d];
9416363a54bSMatthew G. Knepley       up[d] = lp[d] + h[d];
9426363a54bSMatthew G. Knepley     }
9436363a54bSMatthew G. Knepley     for (PetscInt d = 0; d < cdim; ++d) {
9446363a54bSMatthew G. Knepley       PetscCall(DMPlexGetPlaneCellIntersection_Internal(dm, c, lp, &normal[d * 3], &lower[d], &lowerInt[d], lowerIntPoints[d]));
9456363a54bSMatthew G. Knepley       if (debug > 4) {
9466363a54bSMatthew G. Knepley         if (!lowerInt[d])
9476363a54bSMatthew G. Knepley           PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " lower direction %" PetscInt_FMT " (%g, %g, %g) does not intersect %s\n", c, d, (double)lp[0], (double)lp[1], cdim > 2 ? (double)lp[2] : 0., lower[d] ? "positive" : "negative"));
9486363a54bSMatthew G. Knepley         else PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " lower direction %" PetscInt_FMT " (%g, %g, %g) intersects %" PetscInt_FMT " times\n", c, d, (double)lp[0], (double)lp[1], cdim > 2 ? (double)lp[2] : 0., lowerInt[d]));
949cafe43deSMatthew G. Knepley       }
950cafe43deSMatthew G. Knepley     }
9516363a54bSMatthew G. Knepley     // Loop over grid
9526363a54bSMatthew G. Knepley     for (PetscInt k = dlim[2 * 2 + 0]; k <= dlim[2 * 2 + 1]; ++k, lp[2] = up[2], up[2] += h[2]) {
9536363a54bSMatthew G. Knepley       if (cdim > 2) PetscCall(DMPlexGetPlaneCellIntersection_Internal(dm, c, up, &normal[3 * 2], &upper[2], &upperInt[2], upperIntPoints[2]));
9546363a54bSMatthew G. Knepley       if (cdim > 2 && debug > 4) {
9556363a54bSMatthew G. Knepley         if (!upperInt[2]) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 2 (%g, %g, %g) does not intersect %s\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upper[2] ? "positive" : "negative"));
9566363a54bSMatthew G. Knepley         else PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 2 (%g, %g, %g) intersects %" PetscInt_FMT " times\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upperInt[2]));
9576363a54bSMatthew G. Knepley       }
9586363a54bSMatthew G. Knepley       for (PetscInt j = dlim[1 * 2 + 0]; j <= dlim[1 * 2 + 1]; ++j, lp[1] = up[1], up[1] += h[1]) {
9596363a54bSMatthew G. Knepley         if (cdim > 1) PetscCall(DMPlexGetPlaneCellIntersection_Internal(dm, c, up, &normal[3 * 1], &upper[1], &upperInt[1], upperIntPoints[1]));
9606363a54bSMatthew G. Knepley         if (cdim > 1 && debug > 4) {
9616363a54bSMatthew G. Knepley           if (!upperInt[1])
9626363a54bSMatthew G. Knepley             PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 1 (%g, %g, %g) does not intersect %s\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upper[1] ? "positive" : "negative"));
9636363a54bSMatthew G. Knepley           else PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 1 (%g, %g, %g) intersects %" PetscInt_FMT " times\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upperInt[1]));
9646363a54bSMatthew G. Knepley         }
9656363a54bSMatthew G. Knepley         for (PetscInt i = dlim[0 * 2 + 0]; i <= dlim[0 * 2 + 1]; ++i, lp[0] = up[0], up[0] += h[0]) {
966cafe43deSMatthew G. Knepley           const PetscInt box    = (k * lbox->n[1] + j) * lbox->n[0] + i;
9676363a54bSMatthew G. Knepley           PetscBool      excNeg = PETSC_TRUE;
9686363a54bSMatthew G. Knepley           PetscBool      excPos = PETSC_TRUE;
9696363a54bSMatthew G. Knepley           PetscInt       NlInt  = 0;
9706363a54bSMatthew G. Knepley           PetscInt       NuInt  = 0;
971cafe43deSMatthew G. Knepley 
9726363a54bSMatthew G. Knepley           PetscCall(DMPlexGetPlaneCellIntersection_Internal(dm, c, up, &normal[3 * 0], &upper[0], &upperInt[0], upperIntPoints[0]));
9736363a54bSMatthew G. Knepley           if (debug > 4) {
9746363a54bSMatthew G. Knepley             if (!upperInt[0])
9756363a54bSMatthew G. Knepley               PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 0 (%g, %g, %g) does not intersect %s\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upper[0] ? "positive" : "negative"));
9766363a54bSMatthew G. Knepley             else PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " upper direction 0 (%g, %g, %g) intersects %" PetscInt_FMT " times\n", c, (double)up[0], (double)up[1], cdim > 2 ? (double)up[2] : 0., upperInt[0]));
9776363a54bSMatthew G. Knepley           }
9786363a54bSMatthew G. Knepley           for (PetscInt d = 0; d < cdim; ++d) {
9796363a54bSMatthew G. Knepley             NlInt += lowerInt[d];
9806363a54bSMatthew G. Knepley             NuInt += upperInt[d];
9816363a54bSMatthew G. Knepley           }
9826363a54bSMatthew G. Knepley           // If there is no intersection...
9836363a54bSMatthew G. Knepley           if (!NlInt && !NuInt) {
9846363a54bSMatthew G. Knepley             // If the cell is on the negative side of the lower planes, it is not in the box
9856363a54bSMatthew G. Knepley             for (PetscInt d = 0; d < cdim; ++d)
9866363a54bSMatthew G. Knepley               if (lower[d]) {
9876363a54bSMatthew G. Knepley                 excNeg = PETSC_FALSE;
9880b6bfacdSStefano Zampini                 break;
9890b6bfacdSStefano Zampini               }
9906363a54bSMatthew G. Knepley             // If the cell is on the positive side of the upper planes, it is not in the box
9916363a54bSMatthew G. Knepley             for (PetscInt d = 0; d < cdim; ++d)
9926363a54bSMatthew G. Knepley               if (!upper[d]) {
9936363a54bSMatthew G. Knepley                 excPos = PETSC_FALSE;
9949371c9d4SSatish Balay                 break;
995ddce0771SMatthew G. Knepley               }
9966363a54bSMatthew G. Knepley             if (excNeg || excPos) {
9976363a54bSMatthew G. Knepley               if (debug && excNeg) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " is on the negative side of the lower plane\n", c));
9986363a54bSMatthew G. Knepley               if (debug && excPos) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " is on the positive side of the upper plane\n", c));
9996363a54bSMatthew G. Knepley               continue;
10006363a54bSMatthew G. Knepley             }
10016363a54bSMatthew G. Knepley             // Otherwise it is in the box
10026363a54bSMatthew G. Knepley             if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " is contained in box %" PetscInt_FMT "\n", c, box));
10036363a54bSMatthew G. Knepley             PetscCall(DMLabelSetValue(lbox->cellsSparse, c, box));
10046363a54bSMatthew G. Knepley             continue;
10056363a54bSMatthew G. Knepley           }
10066363a54bSMatthew G. Knepley           // If any intersection point is within the box limits, it is in the box
10076363a54bSMatthew G. Knepley           //   We need to have tolerances here since intersection point calculations can introduce errors
10086363a54bSMatthew G. Knepley           for (PetscInt plane = 0; plane < cdim; ++plane) {
10096363a54bSMatthew G. Knepley             for (PetscInt ip = 0; ip < lowerInt[plane]; ++ip) {
10106363a54bSMatthew G. Knepley               PetscInt d;
10116363a54bSMatthew G. Knepley 
10126363a54bSMatthew G. Knepley               for (d = 0; d < cdim; ++d) {
10136363a54bSMatthew G. Knepley                 if ((lowerIntPoints[plane][ip * cdim + d] < lp[d] - PETSC_SMALL) || (lowerIntPoints[plane][ip * cdim + d] > up[d] + PETSC_SMALL)) break;
10146363a54bSMatthew G. Knepley               }
10156363a54bSMatthew G. Knepley               if (d == cdim) {
10166363a54bSMatthew G. Knepley                 if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " intersected lower plane %" PetscInt_FMT " of box %" PetscInt_FMT "\n", c, plane, box));
10176363a54bSMatthew G. Knepley                 PetscCall(DMLabelSetValue(lbox->cellsSparse, c, box));
10186363a54bSMatthew G. Knepley                 goto end;
10196363a54bSMatthew G. Knepley               }
10206363a54bSMatthew G. Knepley             }
10216363a54bSMatthew G. Knepley             for (PetscInt ip = 0; ip < upperInt[plane]; ++ip) {
10226363a54bSMatthew G. Knepley               PetscInt d;
10236363a54bSMatthew G. Knepley 
10246363a54bSMatthew G. Knepley               for (d = 0; d < cdim; ++d) {
10256363a54bSMatthew G. Knepley                 if ((upperIntPoints[plane][ip * cdim + d] < lp[d] - PETSC_SMALL) || (upperIntPoints[plane][ip * cdim + d] > up[d] + PETSC_SMALL)) break;
10266363a54bSMatthew G. Knepley               }
10276363a54bSMatthew G. Knepley               if (d == cdim) {
10286363a54bSMatthew G. Knepley                 if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "  Cell %" PetscInt_FMT " intersected upper plane %" PetscInt_FMT " of box %" PetscInt_FMT "\n", c, plane, box));
10296363a54bSMatthew G. Knepley                 PetscCall(DMLabelSetValue(lbox->cellsSparse, c, box));
10306363a54bSMatthew G. Knepley                 goto end;
1031ddce0771SMatthew G. Knepley               }
1032ddce0771SMatthew G. Knepley             }
1033cafe43deSMatthew G. Knepley           }
10346363a54bSMatthew G. Knepley         end:
10356363a54bSMatthew G. Knepley           lower[0]          = upper[0];
10366363a54bSMatthew G. Knepley           lowerInt[0]       = upperInt[0];
10376363a54bSMatthew G. Knepley           tmp               = lowerIntPoints[0];
10386363a54bSMatthew G. Knepley           lowerIntPoints[0] = upperIntPoints[0];
10396363a54bSMatthew G. Knepley           upperIntPoints[0] = tmp;
10406363a54bSMatthew G. Knepley         }
10416363a54bSMatthew G. Knepley         lp[0]             = lbox->lower[0] + dlim[0 * 2 + 0] * h[0];
10426363a54bSMatthew G. Knepley         up[0]             = lp[0] + h[0];
10436363a54bSMatthew G. Knepley         lower[1]          = upper[1];
10446363a54bSMatthew G. Knepley         lowerInt[1]       = upperInt[1];
10456363a54bSMatthew G. Knepley         tmp               = lowerIntPoints[1];
10466363a54bSMatthew G. Knepley         lowerIntPoints[1] = upperIntPoints[1];
10476363a54bSMatthew G. Knepley         upperIntPoints[1] = tmp;
10486363a54bSMatthew G. Knepley       }
10496363a54bSMatthew G. Knepley       lp[1]             = lbox->lower[1] + dlim[1 * 2 + 0] * h[1];
10506363a54bSMatthew G. Knepley       up[1]             = lp[1] + h[1];
10516363a54bSMatthew G. Knepley       lower[2]          = upper[2];
10526363a54bSMatthew G. Knepley       lowerInt[2]       = upperInt[2];
10536363a54bSMatthew G. Knepley       tmp               = lowerIntPoints[2];
10546363a54bSMatthew G. Knepley       lowerIntPoints[2] = upperIntPoints[2];
10556363a54bSMatthew G. Knepley       upperIntPoints[2] = tmp;
1056fea14342SMatthew G. Knepley     }
1057fea14342SMatthew G. Knepley   }
10586363a54bSMatthew G. Knepley   PetscCall(PetscFree2(dboxes, boxes));
10596363a54bSMatthew G. Knepley 
10609566063dSJacob Faibussowitsch   if (debug) PetscCall(DMLabelView(lbox->cellsSparse, PETSC_VIEWER_STDOUT_SELF));
10619566063dSJacob Faibussowitsch   PetscCall(DMLabelConvertToSection(lbox->cellsSparse, &lbox->cellSection, &lbox->cells));
10629566063dSJacob Faibussowitsch   PetscCall(DMLabelDestroy(&lbox->cellsSparse));
1063cafe43deSMatthew G. Knepley   *localBox = lbox;
10643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1065cafe43deSMatthew G. Knepley }
1066cafe43deSMatthew G. Knepley 
1067d71ae5a4SJacob Faibussowitsch PetscErrorCode DMLocatePoints_Plex(DM dm, Vec v, DMPointLocationType ltype, PetscSF cellSF)
1068d71ae5a4SJacob Faibussowitsch {
1069f5867de0SMatthew G. Knepley   PetscInt        debug = ((DM_Plex *)dm->data)->printLocate;
1070cafe43deSMatthew G. Knepley   DM_Plex        *mesh  = (DM_Plex *)dm->data;
1071af74b616SDave May   PetscBool       hash = mesh->useHashLocation, reuse = PETSC_FALSE;
10723a93e3b7SToby Isaac   PetscInt        bs, numPoints, p, numFound, *found = NULL;
1073d8206211SMatthew G. Knepley   PetscInt        dim, Nl = 0, cStart, cEnd, numCells, c, d;
1074d8206211SMatthew G. Knepley   PetscSF         sf;
1075d8206211SMatthew G. Knepley   const PetscInt *leaves;
1076cafe43deSMatthew G. Knepley   const PetscInt *boxCells;
10773a93e3b7SToby Isaac   PetscSFNode    *cells;
1078ccd2543fSMatthew G Knepley   PetscScalar    *a;
10793a93e3b7SToby Isaac   PetscMPIInt     result;
1080af74b616SDave May   PetscLogDouble  t0, t1;
10819cb35068SDave May   PetscReal       gmin[3], gmax[3];
10829cb35068SDave May   PetscInt        terminating_query_type[] = {0, 0, 0};
10836363a54bSMatthew G. Knepley   PetscMPIInt     rank;
1084ccd2543fSMatthew G Knepley 
1085ccd2543fSMatthew G Knepley   PetscFunctionBegin;
10866363a54bSMatthew G. Knepley   PetscCallMPI(MPI_Comm_rank(PetscObjectComm((PetscObject)dm), &rank));
10879566063dSJacob Faibussowitsch   PetscCall(PetscLogEventBegin(DMPLEX_LocatePoints, 0, 0, 0, 0));
10889566063dSJacob Faibussowitsch   PetscCall(PetscTime(&t0));
10891dca8a05SBarry Smith   PetscCheck(ltype != DM_POINTLOCATION_NEAREST || hash, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Nearest point location only supported with grid hashing. Use -dm_plex_hash_location to enable it.");
10909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dim));
10919566063dSJacob Faibussowitsch   PetscCall(VecGetBlockSize(v, &bs));
10929566063dSJacob Faibussowitsch   PetscCallMPI(MPI_Comm_compare(PetscObjectComm((PetscObject)cellSF), PETSC_COMM_SELF, &result));
10931dca8a05SBarry Smith   PetscCheck(result == MPI_IDENT || result == MPI_CONGRUENT, PetscObjectComm((PetscObject)cellSF), PETSC_ERR_SUP, "Trying parallel point location: only local point location supported");
109463a3b9bcSJacob Faibussowitsch   PetscCheck(bs == dim, PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_WRONG, "Block size for point vector %" PetscInt_FMT " must be the mesh coordinate dimension %" PetscInt_FMT, bs, dim);
10956858538eSMatthew G. Knepley   PetscCall(DMGetCoordinatesLocalSetUp(dm));
10969566063dSJacob Faibussowitsch   PetscCall(DMPlexGetSimplexOrBoxCells(dm, 0, &cStart, &cEnd));
1097d8206211SMatthew G. Knepley   PetscCall(DMGetPointSF(dm, &sf));
1098d8206211SMatthew G. Knepley   if (sf) PetscCall(PetscSFGetGraph(sf, NULL, &Nl, &leaves, NULL));
1099d8206211SMatthew G. Knepley   Nl = PetscMax(Nl, 0);
11009566063dSJacob Faibussowitsch   PetscCall(VecGetLocalSize(v, &numPoints));
11019566063dSJacob Faibussowitsch   PetscCall(VecGetArray(v, &a));
1102ccd2543fSMatthew G Knepley   numPoints /= bs;
1103af74b616SDave May   {
1104af74b616SDave May     const PetscSFNode *sf_cells;
1105af74b616SDave May 
11069566063dSJacob Faibussowitsch     PetscCall(PetscSFGetGraph(cellSF, NULL, NULL, NULL, &sf_cells));
1107af74b616SDave May     if (sf_cells) {
11089566063dSJacob Faibussowitsch       PetscCall(PetscInfo(dm, "[DMLocatePoints_Plex] Re-using existing StarForest node list\n"));
1109af74b616SDave May       cells = (PetscSFNode *)sf_cells;
1110af74b616SDave May       reuse = PETSC_TRUE;
1111af74b616SDave May     } else {
11129566063dSJacob Faibussowitsch       PetscCall(PetscInfo(dm, "[DMLocatePoints_Plex] Creating and initializing new StarForest node list\n"));
11139566063dSJacob Faibussowitsch       PetscCall(PetscMalloc1(numPoints, &cells));
1114af74b616SDave May       /* initialize cells if created */
1115af74b616SDave May       for (p = 0; p < numPoints; p++) {
1116af74b616SDave May         cells[p].rank  = 0;
1117af74b616SDave May         cells[p].index = DMLOCATEPOINT_POINT_NOT_FOUND;
1118af74b616SDave May       }
1119af74b616SDave May     }
1120af74b616SDave May   }
112176b3799dSMatthew G. Knepley   PetscCall(DMGetBoundingBox(dm, gmin, gmax));
1122953fc75cSMatthew G. Knepley   if (hash) {
11239371c9d4SSatish Balay     if (!mesh->lbox) {
112496217254SMatthew G. Knepley       PetscCall(PetscInfo(dm, "Initializing grid hashing\n"));
11259371c9d4SSatish Balay       PetscCall(DMPlexComputeGridHash_Internal(dm, &mesh->lbox));
11269371c9d4SSatish Balay     }
1127cafe43deSMatthew G. Knepley     /* Designate the local box for each point */
1128cafe43deSMatthew G. Knepley     /* Send points to correct process */
1129cafe43deSMatthew G. Knepley     /* Search cells that lie in each subbox */
1130cafe43deSMatthew G. Knepley     /*   Should we bin points before doing search? */
11319566063dSJacob Faibussowitsch     PetscCall(ISGetIndices(mesh->lbox->cells, &boxCells));
1132953fc75cSMatthew G. Knepley   }
11333a93e3b7SToby Isaac   for (p = 0, numFound = 0; p < numPoints; ++p) {
1134ccd2543fSMatthew G Knepley     const PetscScalar *point   = &a[p * bs];
1135e56f9228SJed Brown     PetscInt           dbin[3] = {-1, -1, -1}, bin, cell = -1, cellOffset;
11369cb35068SDave May     PetscBool          point_outside_domain = PETSC_FALSE;
1137ccd2543fSMatthew G Knepley 
11389cb35068SDave May     /* check bounding box of domain */
11399cb35068SDave May     for (d = 0; d < dim; d++) {
11409371c9d4SSatish Balay       if (PetscRealPart(point[d]) < gmin[d]) {
11419371c9d4SSatish Balay         point_outside_domain = PETSC_TRUE;
11429371c9d4SSatish Balay         break;
11439371c9d4SSatish Balay       }
11449371c9d4SSatish Balay       if (PetscRealPart(point[d]) > gmax[d]) {
11459371c9d4SSatish Balay         point_outside_domain = PETSC_TRUE;
11469371c9d4SSatish Balay         break;
11479371c9d4SSatish Balay       }
11489cb35068SDave May     }
11499cb35068SDave May     if (point_outside_domain) {
1150e9b685f5SMatthew G. Knepley       cells[p].rank  = 0;
1151e9b685f5SMatthew G. Knepley       cells[p].index = DMLOCATEPOINT_POINT_NOT_FOUND;
11529cb35068SDave May       terminating_query_type[0]++;
11539cb35068SDave May       continue;
11549cb35068SDave May     }
1155ccd2543fSMatthew G Knepley 
1156af74b616SDave May     /* check initial values in cells[].index - abort early if found */
1157af74b616SDave May     if (cells[p].index != DMLOCATEPOINT_POINT_NOT_FOUND) {
1158af74b616SDave May       c              = cells[p].index;
11593a93e3b7SToby Isaac       cells[p].index = DMLOCATEPOINT_POINT_NOT_FOUND;
11609566063dSJacob Faibussowitsch       PetscCall(DMPlexLocatePoint_Internal(dm, dim, point, c, &cell));
1161af74b616SDave May       if (cell >= 0) {
1162af74b616SDave May         cells[p].rank  = 0;
1163af74b616SDave May         cells[p].index = cell;
1164af74b616SDave May         numFound++;
1165af74b616SDave May       }
1166af74b616SDave May     }
11679cb35068SDave May     if (cells[p].index != DMLOCATEPOINT_POINT_NOT_FOUND) {
11689cb35068SDave May       terminating_query_type[1]++;
11699cb35068SDave May       continue;
11709cb35068SDave May     }
1171af74b616SDave May 
1172953fc75cSMatthew G. Knepley     if (hash) {
1173af74b616SDave May       PetscBool found_box;
1174af74b616SDave May 
11756363a54bSMatthew G. Knepley       if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "[%d]Checking point %" PetscInt_FMT " (%.2g, %.2g, %.2g)\n", rank, p, (double)PetscRealPart(point[0]), (double)PetscRealPart(point[1]), dim > 2 ? (double)PetscRealPart(point[2]) : 0.));
1176af74b616SDave May       /* allow for case that point is outside box - abort early */
1177f5867de0SMatthew G. Knepley       PetscCall(PetscGridHashGetEnclosingBoxQuery(mesh->lbox, mesh->lbox->cellSection, 1, point, dbin, &bin, &found_box));
1178af74b616SDave May       if (found_box) {
11796363a54bSMatthew G. Knepley         if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "[%d]  Found point in box %" PetscInt_FMT " (%" PetscInt_FMT ", %" PetscInt_FMT ", %" PetscInt_FMT ")\n", rank, bin, dbin[0], dbin[1], dim > 2 ? dbin[2] : 0));
1180cafe43deSMatthew G. Knepley         /* TODO Lay an interface over this so we can switch between Section (dense) and Label (sparse) */
11819566063dSJacob Faibussowitsch         PetscCall(PetscSectionGetDof(mesh->lbox->cellSection, bin, &numCells));
11829566063dSJacob Faibussowitsch         PetscCall(PetscSectionGetOffset(mesh->lbox->cellSection, bin, &cellOffset));
1183cafe43deSMatthew G. Knepley         for (c = cellOffset; c < cellOffset + numCells; ++c) {
11846363a54bSMatthew G. Knepley           if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "[%d]    Checking for point in cell %" PetscInt_FMT "\n", rank, boxCells[c]));
11859566063dSJacob Faibussowitsch           PetscCall(DMPlexLocatePoint_Internal(dm, dim, point, boxCells[c], &cell));
11863a93e3b7SToby Isaac           if (cell >= 0) {
11876363a54bSMatthew G. Knepley             if (debug) PetscCall(PetscPrintf(PETSC_COMM_SELF, "[%d]      FOUND in cell %" PetscInt_FMT "\n", rank, cell));
11883a93e3b7SToby Isaac             cells[p].rank  = 0;
11893a93e3b7SToby Isaac             cells[p].index = cell;
11903a93e3b7SToby Isaac             numFound++;
11919cb35068SDave May             terminating_query_type[2]++;
11923a93e3b7SToby Isaac             break;
1193ccd2543fSMatthew G Knepley           }
11943a93e3b7SToby Isaac         }
1195af74b616SDave May       }
1196953fc75cSMatthew G. Knepley     } else {
1197953fc75cSMatthew G. Knepley       for (c = cStart; c < cEnd; ++c) {
1198d8206211SMatthew G. Knepley         PetscInt idx;
1199d8206211SMatthew G. Knepley 
1200d8206211SMatthew G. Knepley         PetscCall(PetscFindInt(c, Nl, leaves, &idx));
1201d8206211SMatthew G. Knepley         if (idx >= 0) continue;
12029566063dSJacob Faibussowitsch         PetscCall(DMPlexLocatePoint_Internal(dm, dim, point, c, &cell));
12033a93e3b7SToby Isaac         if (cell >= 0) {
12043a93e3b7SToby Isaac           cells[p].rank  = 0;
12053a93e3b7SToby Isaac           cells[p].index = cell;
12063a93e3b7SToby Isaac           numFound++;
12079cb35068SDave May           terminating_query_type[2]++;
12083a93e3b7SToby Isaac           break;
1209953fc75cSMatthew G. Knepley         }
1210953fc75cSMatthew G. Knepley       }
12113a93e3b7SToby Isaac     }
1212ccd2543fSMatthew G Knepley   }
12139566063dSJacob Faibussowitsch   if (hash) PetscCall(ISRestoreIndices(mesh->lbox->cells, &boxCells));
121462a38674SMatthew G. Knepley   if (ltype == DM_POINTLOCATION_NEAREST && hash && numFound < numPoints) {
121562a38674SMatthew G. Knepley     for (p = 0; p < numPoints; p++) {
121662a38674SMatthew G. Knepley       const PetscScalar *point = &a[p * bs];
1217d92c4b9fSToby Isaac       PetscReal          cpoint[3], diff[3], best[3] = {PETSC_MAX_REAL, PETSC_MAX_REAL, PETSC_MAX_REAL}, dist, distMax = PETSC_MAX_REAL;
1218d92c4b9fSToby Isaac       PetscInt           dbin[3] = {-1, -1, -1}, bin, cellOffset, d, bestc = -1;
121962a38674SMatthew G. Knepley 
1220e9b685f5SMatthew G. Knepley       if (cells[p].index < 0) {
12219566063dSJacob Faibussowitsch         PetscCall(PetscGridHashGetEnclosingBox(mesh->lbox, 1, point, dbin, &bin));
12229566063dSJacob Faibussowitsch         PetscCall(PetscSectionGetDof(mesh->lbox->cellSection, bin, &numCells));
12239566063dSJacob Faibussowitsch         PetscCall(PetscSectionGetOffset(mesh->lbox->cellSection, bin, &cellOffset));
122462a38674SMatthew G. Knepley         for (c = cellOffset; c < cellOffset + numCells; ++c) {
12259566063dSJacob Faibussowitsch           PetscCall(DMPlexClosestPoint_Internal(dm, dim, point, boxCells[c], cpoint));
1226b716b415SMatthew G. Knepley           for (d = 0; d < dim; ++d) diff[d] = cpoint[d] - PetscRealPart(point[d]);
122762a38674SMatthew G. Knepley           dist = DMPlex_NormD_Internal(dim, diff);
122862a38674SMatthew G. Knepley           if (dist < distMax) {
1229d92c4b9fSToby Isaac             for (d = 0; d < dim; ++d) best[d] = cpoint[d];
1230d92c4b9fSToby Isaac             bestc   = boxCells[c];
123162a38674SMatthew G. Knepley             distMax = dist;
123262a38674SMatthew G. Knepley           }
123362a38674SMatthew G. Knepley         }
1234d92c4b9fSToby Isaac         if (distMax < PETSC_MAX_REAL) {
1235d92c4b9fSToby Isaac           ++numFound;
1236d92c4b9fSToby Isaac           cells[p].rank  = 0;
1237d92c4b9fSToby Isaac           cells[p].index = bestc;
1238d92c4b9fSToby Isaac           for (d = 0; d < dim; ++d) a[p * bs + d] = best[d];
1239d92c4b9fSToby Isaac         }
124062a38674SMatthew G. Knepley       }
124162a38674SMatthew G. Knepley     }
124262a38674SMatthew G. Knepley   }
124362a38674SMatthew G. Knepley   /* This code is only be relevant when interfaced to parallel point location */
1244cafe43deSMatthew G. Knepley   /* Check for highest numbered proc that claims a point (do we care?) */
12452d1fa6caSMatthew G. Knepley   if (ltype == DM_POINTLOCATION_REMOVE && numFound < numPoints) {
12469566063dSJacob Faibussowitsch     PetscCall(PetscMalloc1(numFound, &found));
12473a93e3b7SToby Isaac     for (p = 0, numFound = 0; p < numPoints; p++) {
12483a93e3b7SToby Isaac       if (cells[p].rank >= 0 && cells[p].index >= 0) {
1249ad540459SPierre Jolivet         if (numFound < p) cells[numFound] = cells[p];
12503a93e3b7SToby Isaac         found[numFound++] = p;
12513a93e3b7SToby Isaac       }
12523a93e3b7SToby Isaac     }
12533a93e3b7SToby Isaac   }
12549566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(v, &a));
125548a46eb9SPierre Jolivet   if (!reuse) PetscCall(PetscSFSetGraph(cellSF, cEnd - cStart, numFound, found, PETSC_OWN_POINTER, cells, PETSC_OWN_POINTER));
12569566063dSJacob Faibussowitsch   PetscCall(PetscTime(&t1));
12579cb35068SDave May   if (hash) {
125863a3b9bcSJacob Faibussowitsch     PetscCall(PetscInfo(dm, "[DMLocatePoints_Plex] terminating_query_type : %" PetscInt_FMT " [outside domain] : %" PetscInt_FMT " [inside initial cell] : %" PetscInt_FMT " [hash]\n", terminating_query_type[0], terminating_query_type[1], terminating_query_type[2]));
12599cb35068SDave May   } else {
126063a3b9bcSJacob Faibussowitsch     PetscCall(PetscInfo(dm, "[DMLocatePoints_Plex] terminating_query_type : %" PetscInt_FMT " [outside domain] : %" PetscInt_FMT " [inside initial cell] : %" PetscInt_FMT " [brute-force]\n", terminating_query_type[0], terminating_query_type[1], terminating_query_type[2]));
12619cb35068SDave May   }
126263a3b9bcSJacob Faibussowitsch   PetscCall(PetscInfo(dm, "[DMLocatePoints_Plex] npoints %" PetscInt_FMT " : time(rank0) %1.2e (sec): points/sec %1.4e\n", numPoints, t1 - t0, (double)((double)numPoints / (t1 - t0))));
12639566063dSJacob Faibussowitsch   PetscCall(PetscLogEventEnd(DMPLEX_LocatePoints, 0, 0, 0, 0));
12643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1265ccd2543fSMatthew G Knepley }
1266ccd2543fSMatthew G Knepley 
1267741bfc07SMatthew G. Knepley /*@C
1268741bfc07SMatthew G. Knepley   DMPlexComputeProjection2Dto1D - Rewrite coordinates to be the 1D projection of the 2D coordinates
1269741bfc07SMatthew G. Knepley 
127020f4b53cSBarry Smith   Not Collective
1271741bfc07SMatthew G. Knepley 
12726b867d5aSJose E. Roman   Input/Output Parameter:
12736b867d5aSJose E. Roman . coords - The coordinates of a segment, on output the new y-coordinate, and 0 for x
1274741bfc07SMatthew G. Knepley 
12756b867d5aSJose E. Roman   Output Parameter:
12766b867d5aSJose E. Roman . R - The rotation which accomplishes the projection
1277741bfc07SMatthew G. Knepley 
1278741bfc07SMatthew G. Knepley   Level: developer
1279741bfc07SMatthew G. Knepley 
12802fe279fdSBarry Smith .seealso: `DMPLEX`, `DMPlexComputeProjection3Dto1D()`, `DMPlexComputeProjection3Dto2D()`
1281741bfc07SMatthew G. Knepley @*/
1282d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeProjection2Dto1D(PetscScalar coords[], PetscReal R[])
1283d71ae5a4SJacob Faibussowitsch {
128417fe8556SMatthew G. Knepley   const PetscReal x = PetscRealPart(coords[2] - coords[0]);
128517fe8556SMatthew G. Knepley   const PetscReal y = PetscRealPart(coords[3] - coords[1]);
12868b49ba18SBarry Smith   const PetscReal r = PetscSqrtReal(x * x + y * y), c = x / r, s = y / r;
128717fe8556SMatthew G. Knepley 
128817fe8556SMatthew G. Knepley   PetscFunctionBegin;
12899371c9d4SSatish Balay   R[0]      = c;
12909371c9d4SSatish Balay   R[1]      = -s;
12919371c9d4SSatish Balay   R[2]      = s;
12929371c9d4SSatish Balay   R[3]      = c;
129317fe8556SMatthew G. Knepley   coords[0] = 0.0;
12947f07f362SMatthew G. Knepley   coords[1] = r;
12953ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
129617fe8556SMatthew G. Knepley }
129717fe8556SMatthew G. Knepley 
1298741bfc07SMatthew G. Knepley /*@C
1299741bfc07SMatthew G. Knepley   DMPlexComputeProjection3Dto1D - Rewrite coordinates to be the 1D projection of the 3D coordinates
130028dbe442SToby Isaac 
130120f4b53cSBarry Smith   Not Collective
130228dbe442SToby Isaac 
13036b867d5aSJose E. Roman   Input/Output Parameter:
13046b867d5aSJose E. Roman . coords - The coordinates of a segment; on output, the new y-coordinate, and 0 for x and z
1305741bfc07SMatthew G. Knepley 
13066b867d5aSJose E. Roman   Output Parameter:
13076b867d5aSJose E. Roman . R - The rotation which accomplishes the projection
1308741bfc07SMatthew G. Knepley 
130920f4b53cSBarry Smith   Note:
131020f4b53cSBarry Smith   This uses the basis completion described by Frisvad in http://www.imm.dtu.dk/~jerf/papers/abstracts/onb.html, DOI:10.1080/2165347X.2012.689606
1311741bfc07SMatthew G. Knepley 
1312741bfc07SMatthew G. Knepley   Level: developer
1313741bfc07SMatthew G. Knepley 
13142fe279fdSBarry Smith .seealso: `DMPLEX`, `DMPlexComputeProjection2Dto1D()`, `DMPlexComputeProjection3Dto2D()`
1315741bfc07SMatthew G. Knepley @*/
1316d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeProjection3Dto1D(PetscScalar coords[], PetscReal R[])
1317d71ae5a4SJacob Faibussowitsch {
131828dbe442SToby Isaac   PetscReal x    = PetscRealPart(coords[3] - coords[0]);
131928dbe442SToby Isaac   PetscReal y    = PetscRealPart(coords[4] - coords[1]);
132028dbe442SToby Isaac   PetscReal z    = PetscRealPart(coords[5] - coords[2]);
132128dbe442SToby Isaac   PetscReal r    = PetscSqrtReal(x * x + y * y + z * z);
132228dbe442SToby Isaac   PetscReal rinv = 1. / r;
132328dbe442SToby Isaac   PetscFunctionBegin;
132428dbe442SToby Isaac 
13259371c9d4SSatish Balay   x *= rinv;
13269371c9d4SSatish Balay   y *= rinv;
13279371c9d4SSatish Balay   z *= rinv;
132828dbe442SToby Isaac   if (x > 0.) {
132928dbe442SToby Isaac     PetscReal inv1pX = 1. / (1. + x);
133028dbe442SToby Isaac 
13319371c9d4SSatish Balay     R[0] = x;
13329371c9d4SSatish Balay     R[1] = -y;
13339371c9d4SSatish Balay     R[2] = -z;
13349371c9d4SSatish Balay     R[3] = y;
13359371c9d4SSatish Balay     R[4] = 1. - y * y * inv1pX;
13369371c9d4SSatish Balay     R[5] = -y * z * inv1pX;
13379371c9d4SSatish Balay     R[6] = z;
13389371c9d4SSatish Balay     R[7] = -y * z * inv1pX;
13399371c9d4SSatish Balay     R[8] = 1. - z * z * inv1pX;
13409371c9d4SSatish Balay   } else {
134128dbe442SToby Isaac     PetscReal inv1mX = 1. / (1. - x);
134228dbe442SToby Isaac 
13439371c9d4SSatish Balay     R[0] = x;
13449371c9d4SSatish Balay     R[1] = z;
13459371c9d4SSatish Balay     R[2] = y;
13469371c9d4SSatish Balay     R[3] = y;
13479371c9d4SSatish Balay     R[4] = -y * z * inv1mX;
13489371c9d4SSatish Balay     R[5] = 1. - y * y * inv1mX;
13499371c9d4SSatish Balay     R[6] = z;
13509371c9d4SSatish Balay     R[7] = 1. - z * z * inv1mX;
13519371c9d4SSatish Balay     R[8] = -y * z * inv1mX;
135228dbe442SToby Isaac   }
135328dbe442SToby Isaac   coords[0] = 0.0;
135428dbe442SToby Isaac   coords[1] = r;
13553ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
135628dbe442SToby Isaac }
135728dbe442SToby Isaac 
1358741bfc07SMatthew G. Knepley /*@
1359c871b86eSJed Brown   DMPlexComputeProjection3Dto2D - Rewrite coordinates of 3 or more coplanar 3D points to a common 2D basis for the
1360c871b86eSJed Brown     plane.  The normal is defined by positive orientation of the first 3 points.
1361741bfc07SMatthew G. Knepley 
136220f4b53cSBarry Smith   Not Collective
1363741bfc07SMatthew G. Knepley 
1364741bfc07SMatthew G. Knepley   Input Parameter:
13656b867d5aSJose E. Roman . coordSize - Length of coordinate array (3x number of points); must be at least 9 (3 points)
1366741bfc07SMatthew G. Knepley 
13676b867d5aSJose E. Roman   Input/Output Parameter:
13686b867d5aSJose E. Roman . coords - The interlaced coordinates of each coplanar 3D point; on output the first
13696b867d5aSJose E. Roman            2*coordSize/3 entries contain interlaced 2D points, with the rest undefined
13706b867d5aSJose E. Roman 
13716b867d5aSJose E. Roman   Output Parameter:
13726b867d5aSJose E. Roman . R - 3x3 row-major rotation matrix whose columns are the tangent basis [t1, t2, n].  Multiplying by R^T transforms from original frame to tangent frame.
1373741bfc07SMatthew G. Knepley 
1374741bfc07SMatthew G. Knepley   Level: developer
1375741bfc07SMatthew G. Knepley 
13762fe279fdSBarry Smith .seealso: `DMPLEX`, `DMPlexComputeProjection2Dto1D()`, `DMPlexComputeProjection3Dto1D()`
1377741bfc07SMatthew G. Knepley @*/
1378d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeProjection3Dto2D(PetscInt coordSize, PetscScalar coords[], PetscReal R[])
1379d71ae5a4SJacob Faibussowitsch {
1380c871b86eSJed Brown   PetscReal      x1[3], x2[3], n[3], c[3], norm;
1381ccd2543fSMatthew G Knepley   const PetscInt dim = 3;
1382c871b86eSJed Brown   PetscInt       d, p;
1383ccd2543fSMatthew G Knepley 
1384ccd2543fSMatthew G Knepley   PetscFunctionBegin;
1385ccd2543fSMatthew G Knepley   /* 0) Calculate normal vector */
1386ccd2543fSMatthew G Knepley   for (d = 0; d < dim; ++d) {
13871ee9d5ecSMatthew G. Knepley     x1[d] = PetscRealPart(coords[1 * dim + d] - coords[0 * dim + d]);
13881ee9d5ecSMatthew G. Knepley     x2[d] = PetscRealPart(coords[2 * dim + d] - coords[0 * dim + d]);
1389ccd2543fSMatthew G Knepley   }
1390c871b86eSJed Brown   // n = x1 \otimes x2
1391ccd2543fSMatthew G Knepley   n[0] = x1[1] * x2[2] - x1[2] * x2[1];
1392ccd2543fSMatthew G Knepley   n[1] = x1[2] * x2[0] - x1[0] * x2[2];
1393ccd2543fSMatthew G Knepley   n[2] = x1[0] * x2[1] - x1[1] * x2[0];
13948b49ba18SBarry Smith   norm = PetscSqrtReal(n[0] * n[0] + n[1] * n[1] + n[2] * n[2]);
1395c871b86eSJed Brown   for (d = 0; d < dim; d++) n[d] /= norm;
1396c871b86eSJed Brown   norm = PetscSqrtReal(x1[0] * x1[0] + x1[1] * x1[1] + x1[2] * x1[2]);
1397c871b86eSJed Brown   for (d = 0; d < dim; d++) x1[d] /= norm;
1398c871b86eSJed Brown   // x2 = n \otimes x1
1399c871b86eSJed Brown   x2[0] = n[1] * x1[2] - n[2] * x1[1];
1400c871b86eSJed Brown   x2[1] = n[2] * x1[0] - n[0] * x1[2];
1401c871b86eSJed Brown   x2[2] = n[0] * x1[1] - n[1] * x1[0];
1402c871b86eSJed Brown   for (d = 0; d < dim; d++) {
1403c871b86eSJed Brown     R[d * dim + 0] = x1[d];
1404c871b86eSJed Brown     R[d * dim + 1] = x2[d];
1405c871b86eSJed Brown     R[d * dim + 2] = n[d];
1406c871b86eSJed Brown     c[d]           = PetscRealPart(coords[0 * dim + d]);
140773868372SMatthew G. Knepley   }
1408c871b86eSJed Brown   for (p = 0; p < coordSize / dim; p++) {
1409c871b86eSJed Brown     PetscReal y[3];
1410c871b86eSJed Brown     for (d = 0; d < dim; d++) y[d] = PetscRealPart(coords[p * dim + d]) - c[d];
1411c871b86eSJed Brown     for (d = 0; d < 2; d++) coords[p * 2 + d] = R[0 * dim + d] * y[0] + R[1 * dim + d] * y[1] + R[2 * dim + d] * y[2];
14127f07f362SMatthew G. Knepley   }
14133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1414ccd2543fSMatthew G Knepley }
1415ccd2543fSMatthew G Knepley 
1416d71ae5a4SJacob Faibussowitsch PETSC_UNUSED static inline void Volume_Triangle_Internal(PetscReal *vol, PetscReal coords[])
1417d71ae5a4SJacob Faibussowitsch {
1418834e62ceSMatthew G. Knepley   /* Signed volume is 1/2 the determinant
1419834e62ceSMatthew G. Knepley 
1420834e62ceSMatthew G. Knepley    |  1  1  1 |
1421834e62ceSMatthew G. Knepley    | x0 x1 x2 |
1422834e62ceSMatthew G. Knepley    | y0 y1 y2 |
1423834e62ceSMatthew G. Knepley 
1424834e62ceSMatthew G. Knepley      but if x0,y0 is the origin, we have
1425834e62ceSMatthew G. Knepley 
1426834e62ceSMatthew G. Knepley    | x1 x2 |
1427834e62ceSMatthew G. Knepley    | y1 y2 |
1428834e62ceSMatthew G. Knepley   */
1429834e62ceSMatthew G. Knepley   const PetscReal x1 = coords[2] - coords[0], y1 = coords[3] - coords[1];
1430834e62ceSMatthew G. Knepley   const PetscReal x2 = coords[4] - coords[0], y2 = coords[5] - coords[1];
1431834e62ceSMatthew G. Knepley   PetscReal       M[4], detM;
14329371c9d4SSatish Balay   M[0] = x1;
14339371c9d4SSatish Balay   M[1] = x2;
14349371c9d4SSatish Balay   M[2] = y1;
14359371c9d4SSatish Balay   M[3] = y2;
1436923591dfSMatthew G. Knepley   DMPlex_Det2D_Internal(&detM, M);
1437834e62ceSMatthew G. Knepley   *vol = 0.5 * detM;
14383bc0b13bSBarry Smith   (void)PetscLogFlops(5.0);
1439834e62ceSMatthew G. Knepley }
1440834e62ceSMatthew G. Knepley 
1441d71ae5a4SJacob Faibussowitsch PETSC_UNUSED static inline void Volume_Tetrahedron_Internal(PetscReal *vol, PetscReal coords[])
1442d71ae5a4SJacob Faibussowitsch {
1443834e62ceSMatthew G. Knepley   /* Signed volume is 1/6th of the determinant
1444834e62ceSMatthew G. Knepley 
1445834e62ceSMatthew G. Knepley    |  1  1  1  1 |
1446834e62ceSMatthew G. Knepley    | x0 x1 x2 x3 |
1447834e62ceSMatthew G. Knepley    | y0 y1 y2 y3 |
1448834e62ceSMatthew G. Knepley    | z0 z1 z2 z3 |
1449834e62ceSMatthew G. Knepley 
1450834e62ceSMatthew G. Knepley      but if x0,y0,z0 is the origin, we have
1451834e62ceSMatthew G. Knepley 
1452834e62ceSMatthew G. Knepley    | x1 x2 x3 |
1453834e62ceSMatthew G. Knepley    | y1 y2 y3 |
1454834e62ceSMatthew G. Knepley    | z1 z2 z3 |
1455834e62ceSMatthew G. Knepley   */
1456834e62ceSMatthew G. Knepley   const PetscReal x1 = coords[3] - coords[0], y1 = coords[4] - coords[1], z1 = coords[5] - coords[2];
1457834e62ceSMatthew G. Knepley   const PetscReal x2 = coords[6] - coords[0], y2 = coords[7] - coords[1], z2 = coords[8] - coords[2];
1458834e62ceSMatthew G. Knepley   const PetscReal x3 = coords[9] - coords[0], y3 = coords[10] - coords[1], z3 = coords[11] - coords[2];
14590a3da2c2SToby Isaac   const PetscReal onesixth = ((PetscReal)1. / (PetscReal)6.);
1460834e62ceSMatthew G. Knepley   PetscReal       M[9], detM;
14619371c9d4SSatish Balay   M[0] = x1;
14629371c9d4SSatish Balay   M[1] = x2;
14639371c9d4SSatish Balay   M[2] = x3;
14649371c9d4SSatish Balay   M[3] = y1;
14659371c9d4SSatish Balay   M[4] = y2;
14669371c9d4SSatish Balay   M[5] = y3;
14679371c9d4SSatish Balay   M[6] = z1;
14689371c9d4SSatish Balay   M[7] = z2;
14699371c9d4SSatish Balay   M[8] = z3;
1470923591dfSMatthew G. Knepley   DMPlex_Det3D_Internal(&detM, M);
14710a3da2c2SToby Isaac   *vol = -onesixth * detM;
14723bc0b13bSBarry Smith   (void)PetscLogFlops(10.0);
1473834e62ceSMatthew G. Knepley }
1474834e62ceSMatthew G. Knepley 
1475d71ae5a4SJacob Faibussowitsch static inline void Volume_Tetrahedron_Origin_Internal(PetscReal *vol, PetscReal coords[])
1476d71ae5a4SJacob Faibussowitsch {
14770a3da2c2SToby Isaac   const PetscReal onesixth = ((PetscReal)1. / (PetscReal)6.);
1478923591dfSMatthew G. Knepley   DMPlex_Det3D_Internal(vol, coords);
14790a3da2c2SToby Isaac   *vol *= -onesixth;
14800ec8681fSMatthew G. Knepley }
14810ec8681fSMatthew G. Knepley 
1482d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputePointGeometry_Internal(DM dm, PetscInt e, PetscReal v0[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1483d71ae5a4SJacob Faibussowitsch {
1484cb92db44SToby Isaac   PetscSection       coordSection;
1485cb92db44SToby Isaac   Vec                coordinates;
1486cb92db44SToby Isaac   const PetscScalar *coords;
1487cb92db44SToby Isaac   PetscInt           dim, d, off;
1488cb92db44SToby Isaac 
1489cb92db44SToby Isaac   PetscFunctionBegin;
14909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
14919566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
14929566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetDof(coordSection, e, &dim));
14933ba16761SJacob Faibussowitsch   if (!dim) PetscFunctionReturn(PETSC_SUCCESS);
14949566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetOffset(coordSection, e, &off));
14959566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(coordinates, &coords));
14969371c9d4SSatish Balay   if (v0) {
14979371c9d4SSatish Balay     for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[off + d]);
14989371c9d4SSatish Balay   }
14999566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(coordinates, &coords));
1500cb92db44SToby Isaac   *detJ = 1.;
1501cb92db44SToby Isaac   if (J) {
1502cb92db44SToby Isaac     for (d = 0; d < dim * dim; d++) J[d] = 0.;
1503cb92db44SToby Isaac     for (d = 0; d < dim; d++) J[d * dim + d] = 1.;
1504cb92db44SToby Isaac     if (invJ) {
1505cb92db44SToby Isaac       for (d = 0; d < dim * dim; d++) invJ[d] = 0.;
1506cb92db44SToby Isaac       for (d = 0; d < dim; d++) invJ[d * dim + d] = 1.;
1507cb92db44SToby Isaac     }
1508cb92db44SToby Isaac   }
15093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1510cb92db44SToby Isaac }
1511cb92db44SToby Isaac 
15126858538eSMatthew G. Knepley /*@C
15136858538eSMatthew G. Knepley   DMPlexGetCellCoordinates - Get coordinates for a cell, taking into account periodicity
15146858538eSMatthew G. Knepley 
151520f4b53cSBarry Smith   Not Collective
15166858538eSMatthew G. Knepley 
15176858538eSMatthew G. Knepley   Input Parameters:
151820f4b53cSBarry Smith + dm   - The `DMPLEX`
15196858538eSMatthew G. Knepley - cell - The cell number
15206858538eSMatthew G. Knepley 
15216858538eSMatthew G. Knepley   Output Parameters:
15226858538eSMatthew G. Knepley + isDG   - Using cellwise coordinates
15236858538eSMatthew G. Knepley . Nc     - The number of coordinates
15246858538eSMatthew G. Knepley . array  - The coordinate array
15256858538eSMatthew G. Knepley - coords - The cell coordinates
15266858538eSMatthew G. Knepley 
15276858538eSMatthew G. Knepley   Level: developer
15286858538eSMatthew G. Knepley 
152920f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexRestoreCellCoordinates()`, `DMGetCoordinatesLocal()`, `DMGetCellCoordinatesLocal()`
15306858538eSMatthew G. Knepley @*/
1531d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexGetCellCoordinates(DM dm, PetscInt cell, PetscBool *isDG, PetscInt *Nc, const PetscScalar *array[], PetscScalar *coords[])
1532d71ae5a4SJacob Faibussowitsch {
15336858538eSMatthew G. Knepley   DM                 cdm;
15346858538eSMatthew G. Knepley   Vec                coordinates;
15356858538eSMatthew G. Knepley   PetscSection       cs;
15366858538eSMatthew G. Knepley   const PetscScalar *ccoords;
15376858538eSMatthew G. Knepley   PetscInt           pStart, pEnd;
15386858538eSMatthew G. Knepley 
15396858538eSMatthew G. Knepley   PetscFunctionBeginHot;
15406858538eSMatthew G. Knepley   *isDG   = PETSC_FALSE;
15416858538eSMatthew G. Knepley   *Nc     = 0;
15426858538eSMatthew G. Knepley   *array  = NULL;
15436858538eSMatthew G. Knepley   *coords = NULL;
15446858538eSMatthew G. Knepley   /* Check for cellwise coordinates */
15456858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateSection(dm, &cs));
15466858538eSMatthew G. Knepley   if (!cs) goto cg;
15476858538eSMatthew G. Knepley   /* Check that the cell exists in the cellwise section */
15486858538eSMatthew G. Knepley   PetscCall(PetscSectionGetChart(cs, &pStart, &pEnd));
15496858538eSMatthew G. Knepley   if (cell < pStart || cell >= pEnd) goto cg;
15506858538eSMatthew G. Knepley   /* Check for cellwise coordinates for this cell */
15516858538eSMatthew G. Knepley   PetscCall(PetscSectionGetDof(cs, cell, Nc));
15526858538eSMatthew G. Knepley   if (!*Nc) goto cg;
15536858538eSMatthew G. Knepley   /* Check for cellwise coordinates */
15546858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinatesLocalNoncollective(dm, &coordinates));
15556858538eSMatthew G. Knepley   if (!coordinates) goto cg;
15566858538eSMatthew G. Knepley   /* Get cellwise coordinates */
15576858538eSMatthew G. Knepley   PetscCall(DMGetCellCoordinateDM(dm, &cdm));
15586858538eSMatthew G. Knepley   PetscCall(VecGetArrayRead(coordinates, array));
15596858538eSMatthew G. Knepley   PetscCall(DMPlexPointLocalRead(cdm, cell, *array, &ccoords));
15606858538eSMatthew G. Knepley   PetscCall(DMGetWorkArray(cdm, *Nc, MPIU_SCALAR, coords));
15616858538eSMatthew G. Knepley   PetscCall(PetscArraycpy(*coords, ccoords, *Nc));
15626858538eSMatthew G. Knepley   PetscCall(VecRestoreArrayRead(coordinates, array));
15636858538eSMatthew G. Knepley   *isDG = PETSC_TRUE;
15643ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
15656858538eSMatthew G. Knepley cg:
15666858538eSMatthew G. Knepley   /* Use continuous coordinates */
15676858538eSMatthew G. Knepley   PetscCall(DMGetCoordinateDM(dm, &cdm));
15686858538eSMatthew G. Knepley   PetscCall(DMGetCoordinateSection(dm, &cs));
15696858538eSMatthew G. Knepley   PetscCall(DMGetCoordinatesLocalNoncollective(dm, &coordinates));
15706858538eSMatthew G. Knepley   PetscCall(DMPlexVecGetClosure(cdm, cs, coordinates, cell, Nc, coords));
15713ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
15726858538eSMatthew G. Knepley }
15736858538eSMatthew G. Knepley 
15746858538eSMatthew G. Knepley /*@C
15756858538eSMatthew G. Knepley   DMPlexRestoreCellCoordinates - Get coordinates for a cell, taking into account periodicity
15766858538eSMatthew G. Knepley 
157720f4b53cSBarry Smith   Not Collective
15786858538eSMatthew G. Knepley 
15796858538eSMatthew G. Knepley   Input Parameters:
158020f4b53cSBarry Smith + dm   - The `DMPLEX`
15816858538eSMatthew G. Knepley - cell - The cell number
15826858538eSMatthew G. Knepley 
15836858538eSMatthew G. Knepley   Output Parameters:
15846858538eSMatthew G. Knepley + isDG   - Using cellwise coordinates
15856858538eSMatthew G. Knepley . Nc     - The number of coordinates
15866858538eSMatthew G. Knepley . array  - The coordinate array
15876858538eSMatthew G. Knepley - coords - The cell coordinates
15886858538eSMatthew G. Knepley 
15896858538eSMatthew G. Knepley   Level: developer
15906858538eSMatthew G. Knepley 
159120f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexGetCellCoordinates()`, `DMGetCoordinatesLocal()`, `DMGetCellCoordinatesLocal()`
15926858538eSMatthew G. Knepley @*/
1593d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexRestoreCellCoordinates(DM dm, PetscInt cell, PetscBool *isDG, PetscInt *Nc, const PetscScalar *array[], PetscScalar *coords[])
1594d71ae5a4SJacob Faibussowitsch {
15956858538eSMatthew G. Knepley   DM           cdm;
15966858538eSMatthew G. Knepley   PetscSection cs;
15976858538eSMatthew G. Knepley   Vec          coordinates;
15986858538eSMatthew G. Knepley 
15996858538eSMatthew G. Knepley   PetscFunctionBeginHot;
16006858538eSMatthew G. Knepley   if (*isDG) {
16016858538eSMatthew G. Knepley     PetscCall(DMGetCellCoordinateDM(dm, &cdm));
16026858538eSMatthew G. Knepley     PetscCall(DMRestoreWorkArray(cdm, *Nc, MPIU_SCALAR, coords));
16036858538eSMatthew G. Knepley   } else {
16046858538eSMatthew G. Knepley     PetscCall(DMGetCoordinateDM(dm, &cdm));
16056858538eSMatthew G. Knepley     PetscCall(DMGetCoordinateSection(dm, &cs));
16066858538eSMatthew G. Knepley     PetscCall(DMGetCoordinatesLocalNoncollective(dm, &coordinates));
16076858538eSMatthew G. Knepley     PetscCall(DMPlexVecRestoreClosure(cdm, cs, coordinates, cell, Nc, (PetscScalar **)coords));
16086858538eSMatthew G. Knepley   }
16093ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
16106858538eSMatthew G. Knepley }
16116858538eSMatthew G. Knepley 
1612d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeLineGeometry_Internal(DM dm, PetscInt e, PetscReal v0[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1613d71ae5a4SJacob Faibussowitsch {
16146858538eSMatthew G. Knepley   const PetscScalar *array;
1615a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
16166858538eSMatthew G. Knepley   PetscInt           numCoords, d;
16176858538eSMatthew G. Knepley   PetscBool          isDG;
161817fe8556SMatthew G. Knepley 
161917fe8556SMatthew G. Knepley   PetscFunctionBegin;
16206858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
162108401ef6SPierre Jolivet   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
16227f07f362SMatthew G. Knepley   *detJ = 0.0;
162328dbe442SToby Isaac   if (numCoords == 6) {
162428dbe442SToby Isaac     const PetscInt dim = 3;
162528dbe442SToby Isaac     PetscReal      R[9], J0;
162628dbe442SToby Isaac 
16279371c9d4SSatish Balay     if (v0) {
16289371c9d4SSatish Balay       for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
16299371c9d4SSatish Balay     }
16309566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeProjection3Dto1D(coords, R));
163128dbe442SToby Isaac     if (J) {
163228dbe442SToby Isaac       J0   = 0.5 * PetscRealPart(coords[1]);
16339371c9d4SSatish Balay       J[0] = R[0] * J0;
16349371c9d4SSatish Balay       J[1] = R[1];
16359371c9d4SSatish Balay       J[2] = R[2];
16369371c9d4SSatish Balay       J[3] = R[3] * J0;
16379371c9d4SSatish Balay       J[4] = R[4];
16389371c9d4SSatish Balay       J[5] = R[5];
16399371c9d4SSatish Balay       J[6] = R[6] * J0;
16409371c9d4SSatish Balay       J[7] = R[7];
16419371c9d4SSatish Balay       J[8] = R[8];
164228dbe442SToby Isaac       DMPlex_Det3D_Internal(detJ, J);
16432b6f951bSStefano Zampini       if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
1644adac9986SMatthew G. Knepley     }
164528dbe442SToby Isaac   } else if (numCoords == 4) {
16467f07f362SMatthew G. Knepley     const PetscInt dim = 2;
16477f07f362SMatthew G. Knepley     PetscReal      R[4], J0;
16487f07f362SMatthew G. Knepley 
16499371c9d4SSatish Balay     if (v0) {
16509371c9d4SSatish Balay       for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
16519371c9d4SSatish Balay     }
16529566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeProjection2Dto1D(coords, R));
165317fe8556SMatthew G. Knepley     if (J) {
16547f07f362SMatthew G. Knepley       J0   = 0.5 * PetscRealPart(coords[1]);
16559371c9d4SSatish Balay       J[0] = R[0] * J0;
16569371c9d4SSatish Balay       J[1] = R[1];
16579371c9d4SSatish Balay       J[2] = R[2] * J0;
16589371c9d4SSatish Balay       J[3] = R[3];
1659923591dfSMatthew G. Knepley       DMPlex_Det2D_Internal(detJ, J);
1660ad540459SPierre Jolivet       if (invJ) DMPlex_Invert2D_Internal(invJ, J, *detJ);
1661adac9986SMatthew G. Knepley     }
16627f07f362SMatthew G. Knepley   } else if (numCoords == 2) {
16637f07f362SMatthew G. Knepley     const PetscInt dim = 1;
16647f07f362SMatthew G. Knepley 
16659371c9d4SSatish Balay     if (v0) {
16669371c9d4SSatish Balay       for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
16679371c9d4SSatish Balay     }
16687f07f362SMatthew G. Knepley     if (J) {
16697f07f362SMatthew G. Knepley       J[0]  = 0.5 * (PetscRealPart(coords[1]) - PetscRealPart(coords[0]));
167017fe8556SMatthew G. Knepley       *detJ = J[0];
16719566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(2.0));
16729371c9d4SSatish Balay       if (invJ) {
16739371c9d4SSatish Balay         invJ[0] = 1.0 / J[0];
16749371c9d4SSatish Balay         PetscCall(PetscLogFlops(1.0));
16759371c9d4SSatish Balay       }
1676adac9986SMatthew G. Knepley     }
16776858538eSMatthew G. Knepley   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "The number of coordinates for segment %" PetscInt_FMT " is %" PetscInt_FMT " != 2 or 4 or 6", e, numCoords);
16786858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
16793ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
168017fe8556SMatthew G. Knepley }
168117fe8556SMatthew G. Knepley 
1682d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeTriangleGeometry_Internal(DM dm, PetscInt e, PetscReal v0[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1683d71ae5a4SJacob Faibussowitsch {
16846858538eSMatthew G. Knepley   const PetscScalar *array;
1685a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
16866858538eSMatthew G. Knepley   PetscInt           numCoords, d;
16876858538eSMatthew G. Knepley   PetscBool          isDG;
1688ccd2543fSMatthew G Knepley 
1689ccd2543fSMatthew G Knepley   PetscFunctionBegin;
16906858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
16916858538eSMatthew G. Knepley   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
16927f07f362SMatthew G. Knepley   *detJ = 0.0;
1693ccd2543fSMatthew G Knepley   if (numCoords == 9) {
16947f07f362SMatthew G. Knepley     const PetscInt dim = 3;
16957f07f362SMatthew G. Knepley     PetscReal      R[9], J0[9] = {1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0};
16967f07f362SMatthew G. Knepley 
16979371c9d4SSatish Balay     if (v0) {
16989371c9d4SSatish Balay       for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
16999371c9d4SSatish Balay     }
17009566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeProjection3Dto2D(numCoords, coords, R));
17017f07f362SMatthew G. Knepley     if (J) {
1702b7ad821dSMatthew G. Knepley       const PetscInt pdim = 2;
1703b7ad821dSMatthew G. Knepley 
1704b7ad821dSMatthew G. Knepley       for (d = 0; d < pdim; d++) {
1705ad540459SPierre Jolivet         for (PetscInt f = 0; f < pdim; f++) J0[d * dim + f] = 0.5 * (PetscRealPart(coords[(f + 1) * pdim + d]) - PetscRealPart(coords[0 * pdim + d]));
17067f07f362SMatthew G. Knepley       }
17079566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(8.0));
1708923591dfSMatthew G. Knepley       DMPlex_Det3D_Internal(detJ, J0);
17097f07f362SMatthew G. Knepley       for (d = 0; d < dim; d++) {
17106858538eSMatthew G. Knepley         for (PetscInt f = 0; f < dim; f++) {
17117f07f362SMatthew G. Knepley           J[d * dim + f] = 0.0;
1712ad540459SPierre Jolivet           for (PetscInt g = 0; g < dim; g++) J[d * dim + f] += R[d * dim + g] * J0[g * dim + f];
17137f07f362SMatthew G. Knepley         }
17147f07f362SMatthew G. Knepley       }
17159566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(18.0));
17167f07f362SMatthew G. Knepley     }
1717ad540459SPierre Jolivet     if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
17187f07f362SMatthew G. Knepley   } else if (numCoords == 6) {
17197f07f362SMatthew G. Knepley     const PetscInt dim = 2;
17207f07f362SMatthew G. Knepley 
17219371c9d4SSatish Balay     if (v0) {
17229371c9d4SSatish Balay       for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
17239371c9d4SSatish Balay     }
1724ccd2543fSMatthew G Knepley     if (J) {
1725ccd2543fSMatthew G Knepley       for (d = 0; d < dim; d++) {
1726ad540459SPierre Jolivet         for (PetscInt f = 0; f < dim; f++) J[d * dim + f] = 0.5 * (PetscRealPart(coords[(f + 1) * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1727ccd2543fSMatthew G Knepley       }
17289566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(8.0));
1729923591dfSMatthew G. Knepley       DMPlex_Det2D_Internal(detJ, J);
1730ccd2543fSMatthew G Knepley     }
1731ad540459SPierre Jolivet     if (invJ) DMPlex_Invert2D_Internal(invJ, J, *detJ);
173263a3b9bcSJacob Faibussowitsch   } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "The number of coordinates for this triangle is %" PetscInt_FMT " != 6 or 9", numCoords);
17336858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
17343ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1735ccd2543fSMatthew G Knepley }
1736ccd2543fSMatthew G Knepley 
1737d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeRectangleGeometry_Internal(DM dm, PetscInt e, PetscBool isTensor, PetscInt Nq, const PetscReal points[], PetscReal v[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1738d71ae5a4SJacob Faibussowitsch {
17396858538eSMatthew G. Knepley   const PetscScalar *array;
1740a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
17416858538eSMatthew G. Knepley   PetscInt           numCoords, d;
17426858538eSMatthew G. Knepley   PetscBool          isDG;
1743ccd2543fSMatthew G Knepley 
1744ccd2543fSMatthew G Knepley   PetscFunctionBegin;
17456858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
17466858538eSMatthew G. Knepley   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
1747dfccc68fSToby Isaac   if (!Nq) {
1748412e9a14SMatthew G. Knepley     PetscInt vorder[4] = {0, 1, 2, 3};
1749412e9a14SMatthew G. Knepley 
17509371c9d4SSatish Balay     if (isTensor) {
17519371c9d4SSatish Balay       vorder[2] = 3;
17529371c9d4SSatish Balay       vorder[3] = 2;
17539371c9d4SSatish Balay     }
17547f07f362SMatthew G. Knepley     *detJ = 0.0;
175599dec3a6SMatthew G. Knepley     if (numCoords == 12) {
175699dec3a6SMatthew G. Knepley       const PetscInt dim = 3;
175799dec3a6SMatthew G. Knepley       PetscReal      R[9], J0[9] = {1.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 1.0};
175899dec3a6SMatthew G. Knepley 
17599371c9d4SSatish Balay       if (v) {
17609371c9d4SSatish Balay         for (d = 0; d < dim; d++) v[d] = PetscRealPart(coords[d]);
17619371c9d4SSatish Balay       }
17629566063dSJacob Faibussowitsch       PetscCall(DMPlexComputeProjection3Dto2D(numCoords, coords, R));
176399dec3a6SMatthew G. Knepley       if (J) {
176499dec3a6SMatthew G. Knepley         const PetscInt pdim = 2;
176599dec3a6SMatthew G. Knepley 
176699dec3a6SMatthew G. Knepley         for (d = 0; d < pdim; d++) {
1767412e9a14SMatthew G. Knepley           J0[d * dim + 0] = 0.5 * (PetscRealPart(coords[vorder[1] * pdim + d]) - PetscRealPart(coords[vorder[0] * pdim + d]));
1768412e9a14SMatthew G. Knepley           J0[d * dim + 1] = 0.5 * (PetscRealPart(coords[vorder[2] * pdim + d]) - PetscRealPart(coords[vorder[1] * pdim + d]));
176999dec3a6SMatthew G. Knepley         }
17709566063dSJacob Faibussowitsch         PetscCall(PetscLogFlops(8.0));
1771923591dfSMatthew G. Knepley         DMPlex_Det3D_Internal(detJ, J0);
177299dec3a6SMatthew G. Knepley         for (d = 0; d < dim; d++) {
17736858538eSMatthew G. Knepley           for (PetscInt f = 0; f < dim; f++) {
177499dec3a6SMatthew G. Knepley             J[d * dim + f] = 0.0;
1775ad540459SPierre Jolivet             for (PetscInt g = 0; g < dim; g++) J[d * dim + f] += R[d * dim + g] * J0[g * dim + f];
177699dec3a6SMatthew G. Knepley           }
177799dec3a6SMatthew G. Knepley         }
17789566063dSJacob Faibussowitsch         PetscCall(PetscLogFlops(18.0));
177999dec3a6SMatthew G. Knepley       }
1780ad540459SPierre Jolivet       if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
178171f58de1SToby Isaac     } else if (numCoords == 8) {
178299dec3a6SMatthew G. Knepley       const PetscInt dim = 2;
178399dec3a6SMatthew G. Knepley 
17849371c9d4SSatish Balay       if (v) {
17859371c9d4SSatish Balay         for (d = 0; d < dim; d++) v[d] = PetscRealPart(coords[d]);
17869371c9d4SSatish Balay       }
1787ccd2543fSMatthew G Knepley       if (J) {
1788ccd2543fSMatthew G Knepley         for (d = 0; d < dim; d++) {
1789412e9a14SMatthew G. Knepley           J[d * dim + 0] = 0.5 * (PetscRealPart(coords[vorder[1] * dim + d]) - PetscRealPart(coords[vorder[0] * dim + d]));
1790412e9a14SMatthew G. Knepley           J[d * dim + 1] = 0.5 * (PetscRealPart(coords[vorder[3] * dim + d]) - PetscRealPart(coords[vorder[0] * dim + d]));
1791ccd2543fSMatthew G Knepley         }
17929566063dSJacob Faibussowitsch         PetscCall(PetscLogFlops(8.0));
1793923591dfSMatthew G. Knepley         DMPlex_Det2D_Internal(detJ, J);
1794ccd2543fSMatthew G Knepley       }
1795ad540459SPierre Jolivet       if (invJ) DMPlex_Invert2D_Internal(invJ, J, *detJ);
179663a3b9bcSJacob Faibussowitsch     } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "The number of coordinates for this quadrilateral is %" PetscInt_FMT " != 8 or 12", numCoords);
1797dfccc68fSToby Isaac   } else {
1798dfccc68fSToby Isaac     const PetscInt Nv         = 4;
1799dfccc68fSToby Isaac     const PetscInt dimR       = 2;
1800412e9a14SMatthew G. Knepley     PetscInt       zToPlex[4] = {0, 1, 3, 2};
1801dfccc68fSToby Isaac     PetscReal      zOrder[12];
1802dfccc68fSToby Isaac     PetscReal      zCoeff[12];
1803dfccc68fSToby Isaac     PetscInt       i, j, k, l, dim;
1804dfccc68fSToby Isaac 
18059371c9d4SSatish Balay     if (isTensor) {
18069371c9d4SSatish Balay       zToPlex[2] = 2;
18079371c9d4SSatish Balay       zToPlex[3] = 3;
18089371c9d4SSatish Balay     }
1809dfccc68fSToby Isaac     if (numCoords == 12) {
1810dfccc68fSToby Isaac       dim = 3;
1811dfccc68fSToby Isaac     } else if (numCoords == 8) {
1812dfccc68fSToby Isaac       dim = 2;
181363a3b9bcSJacob Faibussowitsch     } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "The number of coordinates for this quadrilateral is %" PetscInt_FMT " != 8 or 12", numCoords);
1814dfccc68fSToby Isaac     for (i = 0; i < Nv; i++) {
1815dfccc68fSToby Isaac       PetscInt zi = zToPlex[i];
1816dfccc68fSToby Isaac 
1817ad540459SPierre Jolivet       for (j = 0; j < dim; j++) zOrder[dim * i + j] = PetscRealPart(coords[dim * zi + j]);
1818dfccc68fSToby Isaac     }
1819dfccc68fSToby Isaac     for (j = 0; j < dim; j++) {
18202df84da0SMatthew G. Knepley       /* Nodal basis for evaluation at the vertices: (1 \mp xi) (1 \mp eta):
18212df84da0SMatthew G. Knepley            \phi^0 = (1 - xi - eta + xi eta) --> 1      = 1/4 ( \phi^0 + \phi^1 + \phi^2 + \phi^3)
18222df84da0SMatthew G. Knepley            \phi^1 = (1 + xi - eta - xi eta) --> xi     = 1/4 (-\phi^0 + \phi^1 - \phi^2 + \phi^3)
18232df84da0SMatthew G. Knepley            \phi^2 = (1 - xi + eta - xi eta) --> eta    = 1/4 (-\phi^0 - \phi^1 + \phi^2 + \phi^3)
18242df84da0SMatthew G. Knepley            \phi^3 = (1 + xi + eta + xi eta) --> xi eta = 1/4 ( \phi^0 - \phi^1 - \phi^2 + \phi^3)
18252df84da0SMatthew G. Knepley       */
1826dfccc68fSToby Isaac       zCoeff[dim * 0 + j] = 0.25 * (zOrder[dim * 0 + j] + zOrder[dim * 1 + j] + zOrder[dim * 2 + j] + zOrder[dim * 3 + j]);
1827dfccc68fSToby Isaac       zCoeff[dim * 1 + j] = 0.25 * (-zOrder[dim * 0 + j] + zOrder[dim * 1 + j] - zOrder[dim * 2 + j] + zOrder[dim * 3 + j]);
1828dfccc68fSToby Isaac       zCoeff[dim * 2 + j] = 0.25 * (-zOrder[dim * 0 + j] - zOrder[dim * 1 + j] + zOrder[dim * 2 + j] + zOrder[dim * 3 + j]);
1829dfccc68fSToby Isaac       zCoeff[dim * 3 + j] = 0.25 * (zOrder[dim * 0 + j] - zOrder[dim * 1 + j] - zOrder[dim * 2 + j] + zOrder[dim * 3 + j]);
1830dfccc68fSToby Isaac     }
1831dfccc68fSToby Isaac     for (i = 0; i < Nq; i++) {
1832dfccc68fSToby Isaac       PetscReal xi = points[dimR * i], eta = points[dimR * i + 1];
1833dfccc68fSToby Isaac 
1834dfccc68fSToby Isaac       if (v) {
1835dfccc68fSToby Isaac         PetscReal extPoint[4];
1836dfccc68fSToby Isaac 
1837dfccc68fSToby Isaac         extPoint[0] = 1.;
1838dfccc68fSToby Isaac         extPoint[1] = xi;
1839dfccc68fSToby Isaac         extPoint[2] = eta;
1840dfccc68fSToby Isaac         extPoint[3] = xi * eta;
1841dfccc68fSToby Isaac         for (j = 0; j < dim; j++) {
1842dfccc68fSToby Isaac           PetscReal val = 0.;
1843dfccc68fSToby Isaac 
1844ad540459SPierre Jolivet           for (k = 0; k < Nv; k++) val += extPoint[k] * zCoeff[dim * k + j];
1845dfccc68fSToby Isaac           v[i * dim + j] = val;
1846dfccc68fSToby Isaac         }
1847dfccc68fSToby Isaac       }
1848dfccc68fSToby Isaac       if (J) {
1849dfccc68fSToby Isaac         PetscReal extJ[8];
1850dfccc68fSToby Isaac 
1851dfccc68fSToby Isaac         extJ[0] = 0.;
1852dfccc68fSToby Isaac         extJ[1] = 0.;
1853dfccc68fSToby Isaac         extJ[2] = 1.;
1854dfccc68fSToby Isaac         extJ[3] = 0.;
1855dfccc68fSToby Isaac         extJ[4] = 0.;
1856dfccc68fSToby Isaac         extJ[5] = 1.;
1857dfccc68fSToby Isaac         extJ[6] = eta;
1858dfccc68fSToby Isaac         extJ[7] = xi;
1859dfccc68fSToby Isaac         for (j = 0; j < dim; j++) {
1860dfccc68fSToby Isaac           for (k = 0; k < dimR; k++) {
1861dfccc68fSToby Isaac             PetscReal val = 0.;
1862dfccc68fSToby Isaac 
1863ad540459SPierre Jolivet             for (l = 0; l < Nv; l++) val += zCoeff[dim * l + j] * extJ[dimR * l + k];
1864dfccc68fSToby Isaac             J[i * dim * dim + dim * j + k] = val;
1865dfccc68fSToby Isaac           }
1866dfccc68fSToby Isaac         }
1867dfccc68fSToby Isaac         if (dim == 3) { /* put the cross product in the third component of the Jacobian */
1868dfccc68fSToby Isaac           PetscReal  x, y, z;
1869dfccc68fSToby Isaac           PetscReal *iJ = &J[i * dim * dim];
1870dfccc68fSToby Isaac           PetscReal  norm;
1871dfccc68fSToby Isaac 
1872dfccc68fSToby Isaac           x     = iJ[1 * dim + 0] * iJ[2 * dim + 1] - iJ[1 * dim + 1] * iJ[2 * dim + 0];
1873dfccc68fSToby Isaac           y     = iJ[0 * dim + 1] * iJ[2 * dim + 0] - iJ[0 * dim + 0] * iJ[2 * dim + 1];
1874dfccc68fSToby Isaac           z     = iJ[0 * dim + 0] * iJ[1 * dim + 1] - iJ[0 * dim + 1] * iJ[1 * dim + 0];
1875dfccc68fSToby Isaac           norm  = PetscSqrtReal(x * x + y * y + z * z);
1876dfccc68fSToby Isaac           iJ[2] = x / norm;
1877dfccc68fSToby Isaac           iJ[5] = y / norm;
1878dfccc68fSToby Isaac           iJ[8] = z / norm;
1879dfccc68fSToby Isaac           DMPlex_Det3D_Internal(&detJ[i], &J[i * dim * dim]);
1880ad540459SPierre Jolivet           if (invJ) DMPlex_Invert3D_Internal(&invJ[i * dim * dim], &J[i * dim * dim], detJ[i]);
1881dfccc68fSToby Isaac         } else {
1882dfccc68fSToby Isaac           DMPlex_Det2D_Internal(&detJ[i], &J[i * dim * dim]);
1883ad540459SPierre Jolivet           if (invJ) DMPlex_Invert2D_Internal(&invJ[i * dim * dim], &J[i * dim * dim], detJ[i]);
1884dfccc68fSToby Isaac         }
1885dfccc68fSToby Isaac       }
1886dfccc68fSToby Isaac     }
1887dfccc68fSToby Isaac   }
18886858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
18893ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1890ccd2543fSMatthew G Knepley }
1891ccd2543fSMatthew G Knepley 
1892d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeTetrahedronGeometry_Internal(DM dm, PetscInt e, PetscReal v0[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1893d71ae5a4SJacob Faibussowitsch {
18946858538eSMatthew G. Knepley   const PetscScalar *array;
1895a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
1896ccd2543fSMatthew G Knepley   const PetscInt     dim    = 3;
18976858538eSMatthew G. Knepley   PetscInt           numCoords, d;
18986858538eSMatthew G. Knepley   PetscBool          isDG;
1899ccd2543fSMatthew G Knepley 
1900ccd2543fSMatthew G Knepley   PetscFunctionBegin;
19016858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
19026858538eSMatthew G. Knepley   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
19037f07f362SMatthew G. Knepley   *detJ = 0.0;
19049371c9d4SSatish Balay   if (v0) {
19059371c9d4SSatish Balay     for (d = 0; d < dim; d++) v0[d] = PetscRealPart(coords[d]);
19069371c9d4SSatish Balay   }
1907ccd2543fSMatthew G Knepley   if (J) {
1908ccd2543fSMatthew G Knepley     for (d = 0; d < dim; d++) {
1909f0df753eSMatthew G. Knepley       /* I orient with outward face normals */
1910f0df753eSMatthew G. Knepley       J[d * dim + 0] = 0.5 * (PetscRealPart(coords[2 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1911f0df753eSMatthew G. Knepley       J[d * dim + 1] = 0.5 * (PetscRealPart(coords[1 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1912f0df753eSMatthew G. Knepley       J[d * dim + 2] = 0.5 * (PetscRealPart(coords[3 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1913ccd2543fSMatthew G Knepley     }
19149566063dSJacob Faibussowitsch     PetscCall(PetscLogFlops(18.0));
1915923591dfSMatthew G. Knepley     DMPlex_Det3D_Internal(detJ, J);
1916ccd2543fSMatthew G Knepley   }
1917ad540459SPierre Jolivet   if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
19186858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
19193ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
1920ccd2543fSMatthew G Knepley }
1921ccd2543fSMatthew G Knepley 
1922d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeHexahedronGeometry_Internal(DM dm, PetscInt e, PetscInt Nq, const PetscReal points[], PetscReal v[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
1923d71ae5a4SJacob Faibussowitsch {
19246858538eSMatthew G. Knepley   const PetscScalar *array;
1925a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
1926ccd2543fSMatthew G Knepley   const PetscInt     dim    = 3;
19276858538eSMatthew G. Knepley   PetscInt           numCoords, d;
19286858538eSMatthew G. Knepley   PetscBool          isDG;
1929ccd2543fSMatthew G Knepley 
1930ccd2543fSMatthew G Knepley   PetscFunctionBegin;
19316858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
19326858538eSMatthew G. Knepley   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
1933dfccc68fSToby Isaac   if (!Nq) {
19347f07f362SMatthew G. Knepley     *detJ = 0.0;
19359371c9d4SSatish Balay     if (v) {
19369371c9d4SSatish Balay       for (d = 0; d < dim; d++) v[d] = PetscRealPart(coords[d]);
19379371c9d4SSatish Balay     }
1938ccd2543fSMatthew G Knepley     if (J) {
1939ccd2543fSMatthew G Knepley       for (d = 0; d < dim; d++) {
1940f0df753eSMatthew G. Knepley         J[d * dim + 0] = 0.5 * (PetscRealPart(coords[3 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1941f0df753eSMatthew G. Knepley         J[d * dim + 1] = 0.5 * (PetscRealPart(coords[1 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1942f0df753eSMatthew G. Knepley         J[d * dim + 2] = 0.5 * (PetscRealPart(coords[4 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
1943ccd2543fSMatthew G Knepley       }
19449566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(18.0));
1945923591dfSMatthew G. Knepley       DMPlex_Det3D_Internal(detJ, J);
1946ccd2543fSMatthew G Knepley     }
1947ad540459SPierre Jolivet     if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
1948dfccc68fSToby Isaac   } else {
1949dfccc68fSToby Isaac     const PetscInt Nv         = 8;
1950dfccc68fSToby Isaac     const PetscInt zToPlex[8] = {0, 3, 1, 2, 4, 5, 7, 6};
1951dfccc68fSToby Isaac     const PetscInt dim        = 3;
1952dfccc68fSToby Isaac     const PetscInt dimR       = 3;
1953dfccc68fSToby Isaac     PetscReal      zOrder[24];
1954dfccc68fSToby Isaac     PetscReal      zCoeff[24];
1955dfccc68fSToby Isaac     PetscInt       i, j, k, l;
1956dfccc68fSToby Isaac 
1957dfccc68fSToby Isaac     for (i = 0; i < Nv; i++) {
1958dfccc68fSToby Isaac       PetscInt zi = zToPlex[i];
1959dfccc68fSToby Isaac 
1960ad540459SPierre Jolivet       for (j = 0; j < dim; j++) zOrder[dim * i + j] = PetscRealPart(coords[dim * zi + j]);
1961dfccc68fSToby Isaac     }
1962dfccc68fSToby Isaac     for (j = 0; j < dim; j++) {
1963dfccc68fSToby Isaac       zCoeff[dim * 0 + j] = 0.125 * (zOrder[dim * 0 + j] + zOrder[dim * 1 + j] + zOrder[dim * 2 + j] + zOrder[dim * 3 + j] + zOrder[dim * 4 + j] + zOrder[dim * 5 + j] + zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1964dfccc68fSToby Isaac       zCoeff[dim * 1 + j] = 0.125 * (-zOrder[dim * 0 + j] + zOrder[dim * 1 + j] - zOrder[dim * 2 + j] + zOrder[dim * 3 + j] - zOrder[dim * 4 + j] + zOrder[dim * 5 + j] - zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1965dfccc68fSToby Isaac       zCoeff[dim * 2 + j] = 0.125 * (-zOrder[dim * 0 + j] - zOrder[dim * 1 + j] + zOrder[dim * 2 + j] + zOrder[dim * 3 + j] - zOrder[dim * 4 + j] - zOrder[dim * 5 + j] + zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1966dfccc68fSToby Isaac       zCoeff[dim * 3 + j] = 0.125 * (zOrder[dim * 0 + j] - zOrder[dim * 1 + j] - zOrder[dim * 2 + j] + zOrder[dim * 3 + j] + zOrder[dim * 4 + j] - zOrder[dim * 5 + j] - zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1967dfccc68fSToby Isaac       zCoeff[dim * 4 + j] = 0.125 * (-zOrder[dim * 0 + j] - zOrder[dim * 1 + j] - zOrder[dim * 2 + j] - zOrder[dim * 3 + j] + zOrder[dim * 4 + j] + zOrder[dim * 5 + j] + zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1968dfccc68fSToby Isaac       zCoeff[dim * 5 + j] = 0.125 * (+zOrder[dim * 0 + j] - zOrder[dim * 1 + j] + zOrder[dim * 2 + j] - zOrder[dim * 3 + j] - zOrder[dim * 4 + j] + zOrder[dim * 5 + j] - zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1969dfccc68fSToby Isaac       zCoeff[dim * 6 + j] = 0.125 * (+zOrder[dim * 0 + j] + zOrder[dim * 1 + j] - zOrder[dim * 2 + j] - zOrder[dim * 3 + j] - zOrder[dim * 4 + j] - zOrder[dim * 5 + j] + zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1970dfccc68fSToby Isaac       zCoeff[dim * 7 + j] = 0.125 * (-zOrder[dim * 0 + j] + zOrder[dim * 1 + j] + zOrder[dim * 2 + j] - zOrder[dim * 3 + j] + zOrder[dim * 4 + j] - zOrder[dim * 5 + j] - zOrder[dim * 6 + j] + zOrder[dim * 7 + j]);
1971dfccc68fSToby Isaac     }
1972dfccc68fSToby Isaac     for (i = 0; i < Nq; i++) {
1973dfccc68fSToby Isaac       PetscReal xi = points[dimR * i], eta = points[dimR * i + 1], theta = points[dimR * i + 2];
1974dfccc68fSToby Isaac 
1975dfccc68fSToby Isaac       if (v) {
197691d2b7ceSToby Isaac         PetscReal extPoint[8];
1977dfccc68fSToby Isaac 
1978dfccc68fSToby Isaac         extPoint[0] = 1.;
1979dfccc68fSToby Isaac         extPoint[1] = xi;
1980dfccc68fSToby Isaac         extPoint[2] = eta;
1981dfccc68fSToby Isaac         extPoint[3] = xi * eta;
1982dfccc68fSToby Isaac         extPoint[4] = theta;
1983dfccc68fSToby Isaac         extPoint[5] = theta * xi;
1984dfccc68fSToby Isaac         extPoint[6] = theta * eta;
1985dfccc68fSToby Isaac         extPoint[7] = theta * eta * xi;
1986dfccc68fSToby Isaac         for (j = 0; j < dim; j++) {
1987dfccc68fSToby Isaac           PetscReal val = 0.;
1988dfccc68fSToby Isaac 
1989ad540459SPierre Jolivet           for (k = 0; k < Nv; k++) val += extPoint[k] * zCoeff[dim * k + j];
1990dfccc68fSToby Isaac           v[i * dim + j] = val;
1991dfccc68fSToby Isaac         }
1992dfccc68fSToby Isaac       }
1993dfccc68fSToby Isaac       if (J) {
1994dfccc68fSToby Isaac         PetscReal extJ[24];
1995dfccc68fSToby Isaac 
19969371c9d4SSatish Balay         extJ[0]  = 0.;
19979371c9d4SSatish Balay         extJ[1]  = 0.;
19989371c9d4SSatish Balay         extJ[2]  = 0.;
19999371c9d4SSatish Balay         extJ[3]  = 1.;
20009371c9d4SSatish Balay         extJ[4]  = 0.;
20019371c9d4SSatish Balay         extJ[5]  = 0.;
20029371c9d4SSatish Balay         extJ[6]  = 0.;
20039371c9d4SSatish Balay         extJ[7]  = 1.;
20049371c9d4SSatish Balay         extJ[8]  = 0.;
20059371c9d4SSatish Balay         extJ[9]  = eta;
20069371c9d4SSatish Balay         extJ[10] = xi;
20079371c9d4SSatish Balay         extJ[11] = 0.;
20089371c9d4SSatish Balay         extJ[12] = 0.;
20099371c9d4SSatish Balay         extJ[13] = 0.;
20109371c9d4SSatish Balay         extJ[14] = 1.;
20119371c9d4SSatish Balay         extJ[15] = theta;
20129371c9d4SSatish Balay         extJ[16] = 0.;
20139371c9d4SSatish Balay         extJ[17] = xi;
20149371c9d4SSatish Balay         extJ[18] = 0.;
20159371c9d4SSatish Balay         extJ[19] = theta;
20169371c9d4SSatish Balay         extJ[20] = eta;
20179371c9d4SSatish Balay         extJ[21] = theta * eta;
20189371c9d4SSatish Balay         extJ[22] = theta * xi;
20199371c9d4SSatish Balay         extJ[23] = eta * xi;
2020dfccc68fSToby Isaac 
2021dfccc68fSToby Isaac         for (j = 0; j < dim; j++) {
2022dfccc68fSToby Isaac           for (k = 0; k < dimR; k++) {
2023dfccc68fSToby Isaac             PetscReal val = 0.;
2024dfccc68fSToby Isaac 
2025ad540459SPierre Jolivet             for (l = 0; l < Nv; l++) val += zCoeff[dim * l + j] * extJ[dimR * l + k];
2026dfccc68fSToby Isaac             J[i * dim * dim + dim * j + k] = val;
2027dfccc68fSToby Isaac           }
2028dfccc68fSToby Isaac         }
2029dfccc68fSToby Isaac         DMPlex_Det3D_Internal(&detJ[i], &J[i * dim * dim]);
2030ad540459SPierre Jolivet         if (invJ) DMPlex_Invert3D_Internal(&invJ[i * dim * dim], &J[i * dim * dim], detJ[i]);
2031dfccc68fSToby Isaac       }
2032dfccc68fSToby Isaac     }
2033dfccc68fSToby Isaac   }
20346858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
20353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2036ccd2543fSMatthew G Knepley }
2037ccd2543fSMatthew G Knepley 
2038d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeTriangularPrismGeometry_Internal(DM dm, PetscInt e, PetscInt Nq, const PetscReal points[], PetscReal v[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
2039d71ae5a4SJacob Faibussowitsch {
20406858538eSMatthew G. Knepley   const PetscScalar *array;
20412df84da0SMatthew G. Knepley   PetscScalar       *coords = NULL;
20422df84da0SMatthew G. Knepley   const PetscInt     dim    = 3;
20436858538eSMatthew G. Knepley   PetscInt           numCoords, d;
20446858538eSMatthew G. Knepley   PetscBool          isDG;
20452df84da0SMatthew G. Knepley 
20462df84da0SMatthew G. Knepley   PetscFunctionBegin;
20476858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
20486858538eSMatthew G. Knepley   PetscCheck(!invJ || J, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "In order to compute invJ, J must not be NULL");
20492df84da0SMatthew G. Knepley   if (!Nq) {
20502df84da0SMatthew G. Knepley     /* Assume that the map to the reference is affine */
20512df84da0SMatthew G. Knepley     *detJ = 0.0;
20529371c9d4SSatish Balay     if (v) {
20539371c9d4SSatish Balay       for (d = 0; d < dim; d++) v[d] = PetscRealPart(coords[d]);
20549371c9d4SSatish Balay     }
20552df84da0SMatthew G. Knepley     if (J) {
20562df84da0SMatthew G. Knepley       for (d = 0; d < dim; d++) {
20572df84da0SMatthew G. Knepley         J[d * dim + 0] = 0.5 * (PetscRealPart(coords[2 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
20582df84da0SMatthew G. Knepley         J[d * dim + 1] = 0.5 * (PetscRealPart(coords[1 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
20592df84da0SMatthew G. Knepley         J[d * dim + 2] = 0.5 * (PetscRealPart(coords[4 * dim + d]) - PetscRealPart(coords[0 * dim + d]));
20602df84da0SMatthew G. Knepley       }
20619566063dSJacob Faibussowitsch       PetscCall(PetscLogFlops(18.0));
20622df84da0SMatthew G. Knepley       DMPlex_Det3D_Internal(detJ, J);
20632df84da0SMatthew G. Knepley     }
2064ad540459SPierre Jolivet     if (invJ) DMPlex_Invert3D_Internal(invJ, J, *detJ);
20652df84da0SMatthew G. Knepley   } else {
20662df84da0SMatthew G. Knepley     const PetscInt dim  = 3;
20672df84da0SMatthew G. Knepley     const PetscInt dimR = 3;
20682df84da0SMatthew G. Knepley     const PetscInt Nv   = 6;
20692df84da0SMatthew G. Knepley     PetscReal      verts[18];
20702df84da0SMatthew G. Knepley     PetscReal      coeff[18];
20712df84da0SMatthew G. Knepley     PetscInt       i, j, k, l;
20722df84da0SMatthew G. Knepley 
20739371c9d4SSatish Balay     for (i = 0; i < Nv; ++i)
20749371c9d4SSatish Balay       for (j = 0; j < dim; ++j) verts[dim * i + j] = PetscRealPart(coords[dim * i + j]);
20752df84da0SMatthew G. Knepley     for (j = 0; j < dim; ++j) {
20762df84da0SMatthew G. Knepley       /* Check for triangle,
20772df84da0SMatthew G. Knepley            phi^0 = -1/2 (xi + eta)  chi^0 = delta(-1, -1)   x(xi) = \sum_k x_k phi^k(xi) = \sum_k chi^k(x) phi^k(xi)
20782df84da0SMatthew G. Knepley            phi^1 =  1/2 (1 + xi)    chi^1 = delta( 1, -1)   y(xi) = \sum_k y_k phi^k(xi) = \sum_k chi^k(y) phi^k(xi)
20792df84da0SMatthew G. Knepley            phi^2 =  1/2 (1 + eta)   chi^2 = delta(-1,  1)
20802df84da0SMatthew G. Knepley 
20812df84da0SMatthew G. Knepley            phi^0 + phi^1 + phi^2 = 1    coef_1   = 1/2 (         chi^1 + chi^2)
20822df84da0SMatthew G. Knepley           -phi^0 + phi^1 - phi^2 = xi   coef_xi  = 1/2 (-chi^0 + chi^1)
20832df84da0SMatthew G. Knepley           -phi^0 - phi^1 + phi^2 = eta  coef_eta = 1/2 (-chi^0         + chi^2)
20842df84da0SMatthew G. Knepley 
20852df84da0SMatthew G. Knepley           < chi_0 chi_1 chi_2> A /  1  1  1 \ / phi_0 \   <chi> I <phi>^T  so we need the inverse transpose
20862df84da0SMatthew G. Knepley                                  | -1  1 -1 | | phi_1 | =
20872df84da0SMatthew G. Knepley                                  \ -1 -1  1 / \ phi_2 /
20882df84da0SMatthew G. Knepley 
20892df84da0SMatthew G. Knepley           Check phi^0: 1/2 (phi^0 chi^1 + phi^0 chi^2 + phi^0 chi^0 - phi^0 chi^1 + phi^0 chi^0 - phi^0 chi^2) = phi^0 chi^0
20902df84da0SMatthew G. Knepley       */
20912df84da0SMatthew G. Knepley       /* Nodal basis for evaluation at the vertices: {-xi - eta, 1 + xi, 1 + eta} (1 \mp zeta):
20922df84da0SMatthew G. Knepley            \phi^0 = 1/4 (   -xi - eta        + xi zeta + eta zeta) --> /  1  1  1  1  1  1 \ 1
20932df84da0SMatthew G. Knepley            \phi^1 = 1/4 (1      + eta - zeta           - eta zeta) --> | -1  1 -1 -1 -1  1 | eta
20942df84da0SMatthew G. Knepley            \phi^2 = 1/4 (1 + xi       - zeta - xi zeta)            --> | -1 -1  1 -1  1 -1 | xi
20952df84da0SMatthew G. Knepley            \phi^3 = 1/4 (   -xi - eta        - xi zeta - eta zeta) --> | -1 -1 -1  1  1  1 | zeta
20962df84da0SMatthew G. Knepley            \phi^4 = 1/4 (1 + xi       + zeta + xi zeta)            --> |  1  1 -1 -1  1 -1 | xi zeta
20972df84da0SMatthew G. Knepley            \phi^5 = 1/4 (1      + eta + zeta           + eta zeta) --> \  1 -1  1 -1 -1  1 / eta zeta
20982df84da0SMatthew G. Knepley            1/4 /  0  1  1  0  1  1 \
20992df84da0SMatthew G. Knepley                | -1  1  0 -1  0  1 |
21002df84da0SMatthew G. Knepley                | -1  0  1 -1  1  0 |
21012df84da0SMatthew G. Knepley                |  0 -1 -1  0  1  1 |
21022df84da0SMatthew G. Knepley                |  1  0 -1 -1  1  0 |
21032df84da0SMatthew G. Knepley                \  1 -1  0 -1  0  1 /
21042df84da0SMatthew G. Knepley       */
21052df84da0SMatthew G. Knepley       coeff[dim * 0 + j] = (1. / 4.) * (verts[dim * 1 + j] + verts[dim * 2 + j] + verts[dim * 4 + j] + verts[dim * 5 + j]);
21062df84da0SMatthew G. Knepley       coeff[dim * 1 + j] = (1. / 4.) * (-verts[dim * 0 + j] + verts[dim * 1 + j] - verts[dim * 3 + j] + verts[dim * 5 + j]);
21072df84da0SMatthew G. Knepley       coeff[dim * 2 + j] = (1. / 4.) * (-verts[dim * 0 + j] + verts[dim * 2 + j] - verts[dim * 3 + j] + verts[dim * 4 + j]);
21082df84da0SMatthew G. Knepley       coeff[dim * 3 + j] = (1. / 4.) * (-verts[dim * 1 + j] - verts[dim * 2 + j] + verts[dim * 4 + j] + verts[dim * 5 + j]);
21092df84da0SMatthew G. Knepley       coeff[dim * 4 + j] = (1. / 4.) * (verts[dim * 0 + j] - verts[dim * 2 + j] - verts[dim * 3 + j] + verts[dim * 4 + j]);
21102df84da0SMatthew G. Knepley       coeff[dim * 5 + j] = (1. / 4.) * (verts[dim * 0 + j] - verts[dim * 1 + j] - verts[dim * 3 + j] + verts[dim * 5 + j]);
21112df84da0SMatthew G. Knepley       /* For reference prism:
21122df84da0SMatthew G. Knepley       {0, 0, 0}
21132df84da0SMatthew G. Knepley       {0, 1, 0}
21142df84da0SMatthew G. Knepley       {1, 0, 0}
21152df84da0SMatthew G. Knepley       {0, 0, 1}
21162df84da0SMatthew G. Knepley       {0, 0, 0}
21172df84da0SMatthew G. Knepley       {0, 0, 0}
21182df84da0SMatthew G. Knepley       */
21192df84da0SMatthew G. Knepley     }
21202df84da0SMatthew G. Knepley     for (i = 0; i < Nq; ++i) {
21212df84da0SMatthew G. Knepley       const PetscReal xi = points[dimR * i], eta = points[dimR * i + 1], zeta = points[dimR * i + 2];
21222df84da0SMatthew G. Knepley 
21232df84da0SMatthew G. Knepley       if (v) {
21242df84da0SMatthew G. Knepley         PetscReal extPoint[6];
21252df84da0SMatthew G. Knepley         PetscInt  c;
21262df84da0SMatthew G. Knepley 
21272df84da0SMatthew G. Knepley         extPoint[0] = 1.;
21282df84da0SMatthew G. Knepley         extPoint[1] = eta;
21292df84da0SMatthew G. Knepley         extPoint[2] = xi;
21302df84da0SMatthew G. Knepley         extPoint[3] = zeta;
21312df84da0SMatthew G. Knepley         extPoint[4] = xi * zeta;
21322df84da0SMatthew G. Knepley         extPoint[5] = eta * zeta;
21332df84da0SMatthew G. Knepley         for (c = 0; c < dim; ++c) {
21342df84da0SMatthew G. Knepley           PetscReal val = 0.;
21352df84da0SMatthew G. Knepley 
2136ad540459SPierre Jolivet           for (k = 0; k < Nv; ++k) val += extPoint[k] * coeff[k * dim + c];
21372df84da0SMatthew G. Knepley           v[i * dim + c] = val;
21382df84da0SMatthew G. Knepley         }
21392df84da0SMatthew G. Knepley       }
21402df84da0SMatthew G. Knepley       if (J) {
21412df84da0SMatthew G. Knepley         PetscReal extJ[18];
21422df84da0SMatthew G. Knepley 
21439371c9d4SSatish Balay         extJ[0]  = 0.;
21449371c9d4SSatish Balay         extJ[1]  = 0.;
21459371c9d4SSatish Balay         extJ[2]  = 0.;
21469371c9d4SSatish Balay         extJ[3]  = 0.;
21479371c9d4SSatish Balay         extJ[4]  = 1.;
21489371c9d4SSatish Balay         extJ[5]  = 0.;
21499371c9d4SSatish Balay         extJ[6]  = 1.;
21509371c9d4SSatish Balay         extJ[7]  = 0.;
21519371c9d4SSatish Balay         extJ[8]  = 0.;
21529371c9d4SSatish Balay         extJ[9]  = 0.;
21539371c9d4SSatish Balay         extJ[10] = 0.;
21549371c9d4SSatish Balay         extJ[11] = 1.;
21559371c9d4SSatish Balay         extJ[12] = zeta;
21569371c9d4SSatish Balay         extJ[13] = 0.;
21579371c9d4SSatish Balay         extJ[14] = xi;
21589371c9d4SSatish Balay         extJ[15] = 0.;
21599371c9d4SSatish Balay         extJ[16] = zeta;
21609371c9d4SSatish Balay         extJ[17] = eta;
21612df84da0SMatthew G. Knepley 
21622df84da0SMatthew G. Knepley         for (j = 0; j < dim; j++) {
21632df84da0SMatthew G. Knepley           for (k = 0; k < dimR; k++) {
21642df84da0SMatthew G. Knepley             PetscReal val = 0.;
21652df84da0SMatthew G. Knepley 
2166ad540459SPierre Jolivet             for (l = 0; l < Nv; l++) val += coeff[dim * l + j] * extJ[dimR * l + k];
21672df84da0SMatthew G. Knepley             J[i * dim * dim + dim * j + k] = val;
21682df84da0SMatthew G. Knepley           }
21692df84da0SMatthew G. Knepley         }
21702df84da0SMatthew G. Knepley         DMPlex_Det3D_Internal(&detJ[i], &J[i * dim * dim]);
2171ad540459SPierre Jolivet         if (invJ) DMPlex_Invert3D_Internal(&invJ[i * dim * dim], &J[i * dim * dim], detJ[i]);
21722df84da0SMatthew G. Knepley       }
21732df84da0SMatthew G. Knepley     }
21742df84da0SMatthew G. Knepley   }
21756858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, e, &isDG, &numCoords, &array, &coords));
21763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
21772df84da0SMatthew G. Knepley }
21782df84da0SMatthew G. Knepley 
2179d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeCellGeometryFEM_Implicit(DM dm, PetscInt cell, PetscQuadrature quad, PetscReal *v, PetscReal *J, PetscReal *invJ, PetscReal *detJ)
2180d71ae5a4SJacob Faibussowitsch {
2181ba2698f1SMatthew G. Knepley   DMPolytopeType   ct;
2182dfccc68fSToby Isaac   PetscInt         depth, dim, coordDim, coneSize, i;
2183dfccc68fSToby Isaac   PetscInt         Nq     = 0;
2184dfccc68fSToby Isaac   const PetscReal *points = NULL;
2185dfccc68fSToby Isaac   DMLabel          depthLabel;
2186c330f8ffSToby Isaac   PetscReal        xi0[3]   = {-1., -1., -1.}, v0[3], J0[9], detJ0;
2187dfccc68fSToby Isaac   PetscBool        isAffine = PETSC_TRUE;
2188dfccc68fSToby Isaac 
2189dfccc68fSToby Isaac   PetscFunctionBegin;
21909566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
21919566063dSJacob Faibussowitsch   PetscCall(DMPlexGetConeSize(dm, cell, &coneSize));
21929566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepthLabel(dm, &depthLabel));
21939566063dSJacob Faibussowitsch   PetscCall(DMLabelGetValue(depthLabel, cell, &dim));
219448a46eb9SPierre Jolivet   if (depth == 1 && dim == 1) PetscCall(DMGetDimension(dm, &dim));
21959566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &coordDim));
219663a3b9bcSJacob Faibussowitsch   PetscCheck(coordDim <= 3, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported coordinate dimension %" PetscInt_FMT " > 3", coordDim);
21979566063dSJacob Faibussowitsch   if (quad) PetscCall(PetscQuadratureGetData(quad, NULL, NULL, &Nq, &points, NULL));
21989566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCellType(dm, cell, &ct));
2199ba2698f1SMatthew G. Knepley   switch (ct) {
2200ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_POINT:
22019566063dSJacob Faibussowitsch     PetscCall(DMPlexComputePointGeometry_Internal(dm, cell, v, J, invJ, detJ));
2202dfccc68fSToby Isaac     isAffine = PETSC_FALSE;
2203dfccc68fSToby Isaac     break;
2204ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_SEGMENT:
2205412e9a14SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
22069566063dSJacob Faibussowitsch     if (Nq) PetscCall(DMPlexComputeLineGeometry_Internal(dm, cell, v0, J0, NULL, &detJ0));
22079566063dSJacob Faibussowitsch     else PetscCall(DMPlexComputeLineGeometry_Internal(dm, cell, v, J, invJ, detJ));
2208dfccc68fSToby Isaac     break;
2209ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_TRIANGLE:
22109566063dSJacob Faibussowitsch     if (Nq) PetscCall(DMPlexComputeTriangleGeometry_Internal(dm, cell, v0, J0, NULL, &detJ0));
22119566063dSJacob Faibussowitsch     else PetscCall(DMPlexComputeTriangleGeometry_Internal(dm, cell, v, J, invJ, detJ));
2212dfccc68fSToby Isaac     break;
2213ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_QUADRILATERAL:
22149566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeRectangleGeometry_Internal(dm, cell, PETSC_FALSE, Nq, points, v, J, invJ, detJ));
2215412e9a14SMatthew G. Knepley     isAffine = PETSC_FALSE;
2216412e9a14SMatthew G. Knepley     break;
2217412e9a14SMatthew G. Knepley   case DM_POLYTOPE_SEG_PRISM_TENSOR:
22189566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeRectangleGeometry_Internal(dm, cell, PETSC_TRUE, Nq, points, v, J, invJ, detJ));
2219dfccc68fSToby Isaac     isAffine = PETSC_FALSE;
2220dfccc68fSToby Isaac     break;
2221ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_TETRAHEDRON:
22229566063dSJacob Faibussowitsch     if (Nq) PetscCall(DMPlexComputeTetrahedronGeometry_Internal(dm, cell, v0, J0, NULL, &detJ0));
22239566063dSJacob Faibussowitsch     else PetscCall(DMPlexComputeTetrahedronGeometry_Internal(dm, cell, v, J, invJ, detJ));
2224dfccc68fSToby Isaac     break;
2225ba2698f1SMatthew G. Knepley   case DM_POLYTOPE_HEXAHEDRON:
22269566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeHexahedronGeometry_Internal(dm, cell, Nq, points, v, J, invJ, detJ));
2227dfccc68fSToby Isaac     isAffine = PETSC_FALSE;
2228dfccc68fSToby Isaac     break;
22292df84da0SMatthew G. Knepley   case DM_POLYTOPE_TRI_PRISM:
22309566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeTriangularPrismGeometry_Internal(dm, cell, Nq, points, v, J, invJ, detJ));
22312df84da0SMatthew G. Knepley     isAffine = PETSC_FALSE;
22322df84da0SMatthew G. Knepley     break;
2233d71ae5a4SJacob Faibussowitsch   default:
2234d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_ARG_OUTOFRANGE, "No element geometry for cell %" PetscInt_FMT " with type %s", cell, DMPolytopeTypes[PetscMax(0, PetscMin(ct, DM_NUM_POLYTOPES))]);
2235dfccc68fSToby Isaac   }
22367318780aSToby Isaac   if (isAffine && Nq) {
2237dfccc68fSToby Isaac     if (v) {
2238ad540459SPierre Jolivet       for (i = 0; i < Nq; i++) CoordinatesRefToReal(coordDim, dim, xi0, v0, J0, &points[dim * i], &v[coordDim * i]);
2239dfccc68fSToby Isaac     }
22407318780aSToby Isaac     if (detJ) {
2241ad540459SPierre Jolivet       for (i = 0; i < Nq; i++) detJ[i] = detJ0;
22427318780aSToby Isaac     }
22437318780aSToby Isaac     if (J) {
22447318780aSToby Isaac       PetscInt k;
22457318780aSToby Isaac 
22467318780aSToby Isaac       for (i = 0, k = 0; i < Nq; i++) {
2247dfccc68fSToby Isaac         PetscInt j;
2248dfccc68fSToby Isaac 
2249ad540459SPierre Jolivet         for (j = 0; j < coordDim * coordDim; j++, k++) J[k] = J0[j];
22507318780aSToby Isaac       }
22517318780aSToby Isaac     }
22527318780aSToby Isaac     if (invJ) {
22537318780aSToby Isaac       PetscInt k;
22547318780aSToby Isaac       switch (coordDim) {
2255d71ae5a4SJacob Faibussowitsch       case 0:
2256d71ae5a4SJacob Faibussowitsch         break;
2257d71ae5a4SJacob Faibussowitsch       case 1:
2258d71ae5a4SJacob Faibussowitsch         invJ[0] = 1. / J0[0];
2259d71ae5a4SJacob Faibussowitsch         break;
2260d71ae5a4SJacob Faibussowitsch       case 2:
2261d71ae5a4SJacob Faibussowitsch         DMPlex_Invert2D_Internal(invJ, J0, detJ0);
2262d71ae5a4SJacob Faibussowitsch         break;
2263d71ae5a4SJacob Faibussowitsch       case 3:
2264d71ae5a4SJacob Faibussowitsch         DMPlex_Invert3D_Internal(invJ, J0, detJ0);
2265d71ae5a4SJacob Faibussowitsch         break;
22667318780aSToby Isaac       }
22677318780aSToby Isaac       for (i = 1, k = coordDim * coordDim; i < Nq; i++) {
22687318780aSToby Isaac         PetscInt j;
22697318780aSToby Isaac 
2270ad540459SPierre Jolivet         for (j = 0; j < coordDim * coordDim; j++, k++) invJ[k] = invJ[j];
2271dfccc68fSToby Isaac       }
2272dfccc68fSToby Isaac     }
2273dfccc68fSToby Isaac   }
22743ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2275dfccc68fSToby Isaac }
2276dfccc68fSToby Isaac 
2277ccd2543fSMatthew G Knepley /*@C
22788e0841e0SMatthew G. Knepley   DMPlexComputeCellGeometryAffineFEM - Assuming an affine map, compute the Jacobian, inverse Jacobian, and Jacobian determinant for a given cell
2279ccd2543fSMatthew G Knepley 
228020f4b53cSBarry Smith   Collective
2281ccd2543fSMatthew G Knepley 
22824165533cSJose E. Roman   Input Parameters:
228320f4b53cSBarry Smith + dm   - the `DMPLEX`
2284ccd2543fSMatthew G Knepley - cell - the cell
2285ccd2543fSMatthew G Knepley 
22864165533cSJose E. Roman   Output Parameters:
22879b172b3aSMatthew Knepley + v0   - the translation part of this affine transform, meaning the translation to the origin (not the first vertex of the reference cell)
2288ccd2543fSMatthew G Knepley . J    - the Jacobian of the transform from the reference element
2289ccd2543fSMatthew G Knepley . invJ - the inverse of the Jacobian
2290ccd2543fSMatthew G Knepley - detJ - the Jacobian determinant
2291ccd2543fSMatthew G Knepley 
2292ccd2543fSMatthew G Knepley   Level: advanced
2293ccd2543fSMatthew G Knepley 
229420f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexComputeCellGeometryFEM()`, `DMGetCoordinateSection()`, `DMGetCoordinates()`
2295ccd2543fSMatthew G Knepley @*/
2296d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeCellGeometryAffineFEM(DM dm, PetscInt cell, PetscReal *v0, PetscReal *J, PetscReal *invJ, PetscReal *detJ)
2297d71ae5a4SJacob Faibussowitsch {
2298ccd2543fSMatthew G Knepley   PetscFunctionBegin;
22999566063dSJacob Faibussowitsch   PetscCall(DMPlexComputeCellGeometryFEM_Implicit(dm, cell, NULL, v0, J, invJ, detJ));
23003ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
23018e0841e0SMatthew G. Knepley }
23028e0841e0SMatthew G. Knepley 
2303d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeCellGeometryFEM_FE(DM dm, PetscFE fe, PetscInt point, PetscQuadrature quad, PetscReal v[], PetscReal J[], PetscReal invJ[], PetscReal *detJ)
2304d71ae5a4SJacob Faibussowitsch {
23056858538eSMatthew G. Knepley   const PetscScalar *array;
23068e0841e0SMatthew G. Knepley   PetscScalar       *coords = NULL;
23076858538eSMatthew G. Knepley   PetscInt           numCoords;
23086858538eSMatthew G. Knepley   PetscBool          isDG;
23096858538eSMatthew G. Knepley   PetscQuadrature    feQuad;
23108e0841e0SMatthew G. Knepley   const PetscReal   *quadPoints;
2311ef0bb6c7SMatthew G. Knepley   PetscTabulation    T;
23126858538eSMatthew G. Knepley   PetscInt           dim, cdim, pdim, qdim, Nq, q;
23138e0841e0SMatthew G. Knepley 
23148e0841e0SMatthew G. Knepley   PetscFunctionBegin;
23159566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
23169566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &cdim));
23176858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, point, &isDG, &numCoords, &array, &coords));
2318dfccc68fSToby Isaac   if (!quad) { /* use the first point of the first functional of the dual space */
2319dfccc68fSToby Isaac     PetscDualSpace dsp;
2320dfccc68fSToby Isaac 
23219566063dSJacob Faibussowitsch     PetscCall(PetscFEGetDualSpace(fe, &dsp));
23229566063dSJacob Faibussowitsch     PetscCall(PetscDualSpaceGetFunctional(dsp, 0, &quad));
23239566063dSJacob Faibussowitsch     PetscCall(PetscQuadratureGetData(quad, &qdim, NULL, &Nq, &quadPoints, NULL));
2324dfccc68fSToby Isaac     Nq = 1;
2325dfccc68fSToby Isaac   } else {
23269566063dSJacob Faibussowitsch     PetscCall(PetscQuadratureGetData(quad, &qdim, NULL, &Nq, &quadPoints, NULL));
2327dfccc68fSToby Isaac   }
23289566063dSJacob Faibussowitsch   PetscCall(PetscFEGetDimension(fe, &pdim));
23299566063dSJacob Faibussowitsch   PetscCall(PetscFEGetQuadrature(fe, &feQuad));
2330dfccc68fSToby Isaac   if (feQuad == quad) {
23319566063dSJacob Faibussowitsch     PetscCall(PetscFEGetCellTabulation(fe, J ? 1 : 0, &T));
233263a3b9bcSJacob Faibussowitsch     PetscCheck(numCoords == pdim * cdim, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "There are %" PetscInt_FMT " coordinates for point %" PetscInt_FMT " != %" PetscInt_FMT "*%" PetscInt_FMT, numCoords, point, pdim, cdim);
2333dfccc68fSToby Isaac   } else {
23349566063dSJacob Faibussowitsch     PetscCall(PetscFECreateTabulation(fe, 1, Nq, quadPoints, J ? 1 : 0, &T));
2335dfccc68fSToby Isaac   }
233663a3b9bcSJacob Faibussowitsch   PetscCheck(qdim == dim, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Point dimension %" PetscInt_FMT " != quadrature dimension %" PetscInt_FMT, dim, qdim);
2337ef0bb6c7SMatthew G. Knepley   {
2338ef0bb6c7SMatthew G. Knepley     const PetscReal *basis    = T->T[0];
2339ef0bb6c7SMatthew G. Knepley     const PetscReal *basisDer = T->T[1];
2340ef0bb6c7SMatthew G. Knepley     PetscReal        detJt;
2341ef0bb6c7SMatthew G. Knepley 
2342a2a9e04cSMatthew G. Knepley #if defined(PETSC_USE_DEBUG)
234363a3b9bcSJacob Faibussowitsch     PetscCheck(Nq == T->Np, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Np %" PetscInt_FMT " != %" PetscInt_FMT, Nq, T->Np);
234463a3b9bcSJacob Faibussowitsch     PetscCheck(pdim == T->Nb, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Nb %" PetscInt_FMT " != %" PetscInt_FMT, pdim, T->Nb);
234563a3b9bcSJacob Faibussowitsch     PetscCheck(dim == T->Nc, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Nc %" PetscInt_FMT " != %" PetscInt_FMT, dim, T->Nc);
234663a3b9bcSJacob Faibussowitsch     PetscCheck(cdim == T->cdim, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "cdim %" PetscInt_FMT " != %" PetscInt_FMT, cdim, T->cdim);
2347a2a9e04cSMatthew G. Knepley #endif
2348dfccc68fSToby Isaac     if (v) {
23499566063dSJacob Faibussowitsch       PetscCall(PetscArrayzero(v, Nq * cdim));
2350f960e424SToby Isaac       for (q = 0; q < Nq; ++q) {
2351f960e424SToby Isaac         PetscInt i, k;
2352f960e424SToby Isaac 
2353301b184aSMatthew G. Knepley         for (k = 0; k < pdim; ++k) {
2354301b184aSMatthew G. Knepley           const PetscInt vertex = k / cdim;
2355ad540459SPierre Jolivet           for (i = 0; i < cdim; ++i) v[q * cdim + i] += basis[(q * pdim + k) * cdim + i] * PetscRealPart(coords[vertex * cdim + i]);
2356301b184aSMatthew G. Knepley         }
23579566063dSJacob Faibussowitsch         PetscCall(PetscLogFlops(2.0 * pdim * cdim));
2358f960e424SToby Isaac       }
2359f960e424SToby Isaac     }
23608e0841e0SMatthew G. Knepley     if (J) {
23619566063dSJacob Faibussowitsch       PetscCall(PetscArrayzero(J, Nq * cdim * cdim));
23628e0841e0SMatthew G. Knepley       for (q = 0; q < Nq; ++q) {
23638e0841e0SMatthew G. Knepley         PetscInt i, j, k, c, r;
23648e0841e0SMatthew G. Knepley 
23658e0841e0SMatthew G. Knepley         /* J = dx_i/d\xi_j = sum[k=0,n-1] dN_k/d\xi_j * x_i(k) */
2366301b184aSMatthew G. Knepley         for (k = 0; k < pdim; ++k) {
2367301b184aSMatthew G. Knepley           const PetscInt vertex = k / cdim;
2368301b184aSMatthew G. Knepley           for (j = 0; j < dim; ++j) {
2369ad540459SPierre Jolivet             for (i = 0; i < cdim; ++i) J[(q * cdim + i) * cdim + j] += basisDer[((q * pdim + k) * cdim + i) * dim + j] * PetscRealPart(coords[vertex * cdim + i]);
2370301b184aSMatthew G. Knepley           }
2371301b184aSMatthew G. Knepley         }
23729566063dSJacob Faibussowitsch         PetscCall(PetscLogFlops(2.0 * pdim * dim * cdim));
23738e0841e0SMatthew G. Knepley         if (cdim > dim) {
23748e0841e0SMatthew G. Knepley           for (c = dim; c < cdim; ++c)
23759371c9d4SSatish Balay             for (r = 0; r < cdim; ++r) J[r * cdim + c] = r == c ? 1.0 : 0.0;
23768e0841e0SMatthew G. Knepley         }
2377f960e424SToby Isaac         if (!detJ && !invJ) continue;
2378a63b72c6SToby Isaac         detJt = 0.;
23798e0841e0SMatthew G. Knepley         switch (cdim) {
23808e0841e0SMatthew G. Knepley         case 3:
2381037dc194SToby Isaac           DMPlex_Det3D_Internal(&detJt, &J[q * cdim * dim]);
2382ad540459SPierre Jolivet           if (invJ) DMPlex_Invert3D_Internal(&invJ[q * cdim * dim], &J[q * cdim * dim], detJt);
238317fe8556SMatthew G. Knepley           break;
238449dc4407SMatthew G. Knepley         case 2:
23859f328543SToby Isaac           DMPlex_Det2D_Internal(&detJt, &J[q * cdim * dim]);
2386ad540459SPierre Jolivet           if (invJ) DMPlex_Invert2D_Internal(&invJ[q * cdim * dim], &J[q * cdim * dim], detJt);
238749dc4407SMatthew G. Knepley           break;
23888e0841e0SMatthew G. Knepley         case 1:
2389037dc194SToby Isaac           detJt = J[q * cdim * dim];
2390037dc194SToby Isaac           if (invJ) invJ[q * cdim * dim] = 1.0 / detJt;
239149dc4407SMatthew G. Knepley         }
2392f960e424SToby Isaac         if (detJ) detJ[q] = detJt;
239349dc4407SMatthew G. Knepley       }
239408401ef6SPierre Jolivet     } else PetscCheck(!detJ && !invJ, PETSC_COMM_SELF, PETSC_ERR_ARG_SIZ, "Need J to compute invJ or detJ");
239549dc4407SMatthew G. Knepley   }
23969566063dSJacob Faibussowitsch   if (feQuad != quad) PetscCall(PetscTabulationDestroy(&T));
23976858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, point, &isDG, &numCoords, &array, &coords));
23983ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
23998e0841e0SMatthew G. Knepley }
24008e0841e0SMatthew G. Knepley 
24018e0841e0SMatthew G. Knepley /*@C
24028e0841e0SMatthew G. Knepley   DMPlexComputeCellGeometryFEM - Compute the Jacobian, inverse Jacobian, and Jacobian determinant at each quadrature point in the given cell
24038e0841e0SMatthew G. Knepley 
240420f4b53cSBarry Smith   Collective
24058e0841e0SMatthew G. Knepley 
24064165533cSJose E. Roman   Input Parameters:
240720f4b53cSBarry Smith + dm   - the `DMPLEX`
24088e0841e0SMatthew G. Knepley . cell - the cell
240920f4b53cSBarry Smith - quad - the quadrature containing the points in the reference element where the geometry will be evaluated.  If `quad` is `NULL`, geometry will be
2410dfccc68fSToby Isaac          evaluated at the first vertex of the reference element
24118e0841e0SMatthew G. Knepley 
24124165533cSJose E. Roman   Output Parameters:
2413dfccc68fSToby Isaac + v    - the image of the transformed quadrature points, otherwise the image of the first vertex in the closure of the reference element
24148e0841e0SMatthew G. Knepley . J    - the Jacobian of the transform from the reference element at each quadrature point
24158e0841e0SMatthew G. Knepley . invJ - the inverse of the Jacobian at each quadrature point
24168e0841e0SMatthew G. Knepley - detJ - the Jacobian determinant at each quadrature point
24178e0841e0SMatthew G. Knepley 
24188e0841e0SMatthew G. Knepley   Level: advanced
24198e0841e0SMatthew G. Knepley 
242020f4b53cSBarry Smith .seealso: `DMPLEX`, `DMGetCoordinateSection()`, `DMGetCoordinates()`
24218e0841e0SMatthew G. Knepley @*/
2422d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeCellGeometryFEM(DM dm, PetscInt cell, PetscQuadrature quad, PetscReal *v, PetscReal *J, PetscReal *invJ, PetscReal *detJ)
2423d71ae5a4SJacob Faibussowitsch {
2424bb4a5db5SMatthew G. Knepley   DM      cdm;
2425dfccc68fSToby Isaac   PetscFE fe = NULL;
24268e0841e0SMatthew G. Knepley 
24278e0841e0SMatthew G. Knepley   PetscFunctionBegin;
2428dadcf809SJacob Faibussowitsch   PetscValidRealPointer(detJ, 7);
24299566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
2430bb4a5db5SMatthew G. Knepley   if (cdm) {
2431dfccc68fSToby Isaac     PetscClassId id;
2432dfccc68fSToby Isaac     PetscInt     numFields;
2433e5e52638SMatthew G. Knepley     PetscDS      prob;
2434dfccc68fSToby Isaac     PetscObject  disc;
2435dfccc68fSToby Isaac 
24369566063dSJacob Faibussowitsch     PetscCall(DMGetNumFields(cdm, &numFields));
2437dfccc68fSToby Isaac     if (numFields) {
24389566063dSJacob Faibussowitsch       PetscCall(DMGetDS(cdm, &prob));
24399566063dSJacob Faibussowitsch       PetscCall(PetscDSGetDiscretization(prob, 0, &disc));
24409566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(disc, &id));
2441ad540459SPierre Jolivet       if (id == PETSCFE_CLASSID) fe = (PetscFE)disc;
2442dfccc68fSToby Isaac     }
2443dfccc68fSToby Isaac   }
24449566063dSJacob Faibussowitsch   if (!fe) PetscCall(DMPlexComputeCellGeometryFEM_Implicit(dm, cell, quad, v, J, invJ, detJ));
24459566063dSJacob Faibussowitsch   else PetscCall(DMPlexComputeCellGeometryFEM_FE(dm, fe, cell, quad, v, J, invJ, detJ));
24463ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2447ccd2543fSMatthew G Knepley }
2448834e62ceSMatthew G. Knepley 
2449d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeGeometryFVM_0D_Internal(DM dm, PetscInt dim, PetscInt cell, PetscReal *vol, PetscReal centroid[], PetscReal normal[])
2450d71ae5a4SJacob Faibussowitsch {
24519bf2564aSMatt McGurn   PetscSection       coordSection;
24529bf2564aSMatt McGurn   Vec                coordinates;
24539bf2564aSMatt McGurn   const PetscScalar *coords = NULL;
24549bf2564aSMatt McGurn   PetscInt           d, dof, off;
24559bf2564aSMatt McGurn 
24569bf2564aSMatt McGurn   PetscFunctionBegin;
24579566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
24589566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
24599566063dSJacob Faibussowitsch   PetscCall(VecGetArrayRead(coordinates, &coords));
24609bf2564aSMatt McGurn 
24619bf2564aSMatt McGurn   /* for a point the centroid is just the coord */
24629bf2564aSMatt McGurn   if (centroid) {
24639566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetDof(coordSection, cell, &dof));
24649566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetOffset(coordSection, cell, &off));
2465ad540459SPierre Jolivet     for (d = 0; d < dof; d++) centroid[d] = PetscRealPart(coords[off + d]);
24669bf2564aSMatt McGurn   }
24679bf2564aSMatt McGurn   if (normal) {
24689bf2564aSMatt McGurn     const PetscInt *support, *cones;
24699bf2564aSMatt McGurn     PetscInt        supportSize;
24709bf2564aSMatt McGurn     PetscReal       norm, sign;
24719bf2564aSMatt McGurn 
24729bf2564aSMatt McGurn     /* compute the norm based upon the support centroids */
24739566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupportSize(dm, cell, &supportSize));
24749566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupport(dm, cell, &support));
24759566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeCellGeometryFVM(dm, support[0], NULL, normal, NULL));
24769bf2564aSMatt McGurn 
24779bf2564aSMatt McGurn     /* Take the normal from the centroid of the support to the vertex*/
24789566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetDof(coordSection, cell, &dof));
24799566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetOffset(coordSection, cell, &off));
2480ad540459SPierre Jolivet     for (d = 0; d < dof; d++) normal[d] -= PetscRealPart(coords[off + d]);
24819bf2564aSMatt McGurn 
24829bf2564aSMatt McGurn     /* Determine the sign of the normal based upon its location in the support */
24839566063dSJacob Faibussowitsch     PetscCall(DMPlexGetCone(dm, support[0], &cones));
24849bf2564aSMatt McGurn     sign = cones[0] == cell ? 1.0 : -1.0;
24859bf2564aSMatt McGurn 
24869bf2564aSMatt McGurn     norm = DMPlex_NormD_Internal(dim, normal);
24879bf2564aSMatt McGurn     for (d = 0; d < dim; ++d) normal[d] /= (norm * sign);
24889bf2564aSMatt McGurn   }
2489ad540459SPierre Jolivet   if (vol) *vol = 1.0;
24909566063dSJacob Faibussowitsch   PetscCall(VecRestoreArrayRead(coordinates, &coords));
24913ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
24929bf2564aSMatt McGurn }
24939bf2564aSMatt McGurn 
2494d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeGeometryFVM_1D_Internal(DM dm, PetscInt dim, PetscInt cell, PetscReal *vol, PetscReal centroid[], PetscReal normal[])
2495d71ae5a4SJacob Faibussowitsch {
24966858538eSMatthew G. Knepley   const PetscScalar *array;
2497a1e44745SMatthew G. Knepley   PetscScalar       *coords = NULL;
249821d6a034SMatthew G. Knepley   PetscInt           cdim, coordSize, d;
24996858538eSMatthew G. Knepley   PetscBool          isDG;
2500cc08537eSMatthew G. Knepley 
2501cc08537eSMatthew G. Knepley   PetscFunctionBegin;
250221d6a034SMatthew G. Knepley   PetscCall(DMGetCoordinateDim(dm, &cdim));
25036858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
250421d6a034SMatthew G. Knepley   PetscCheck(coordSize == cdim * 2, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Edge has %" PetscInt_FMT " coordinates != %" PetscInt_FMT, coordSize, cdim * 2);
2505cc08537eSMatthew G. Knepley   if (centroid) {
250621d6a034SMatthew G. Knepley     for (d = 0; d < cdim; ++d) centroid[d] = 0.5 * PetscRealPart(coords[d] + coords[cdim + d]);
2507cc08537eSMatthew G. Knepley   }
2508cc08537eSMatthew G. Knepley   if (normal) {
2509a60a936bSMatthew G. Knepley     PetscReal norm;
2510a60a936bSMatthew G. Knepley 
251121d6a034SMatthew G. Knepley     switch (cdim) {
251221d6a034SMatthew G. Knepley     case 3:
2513f315e28eSPierre Jolivet       normal[2] = 0.; /* fall through */
251421d6a034SMatthew G. Knepley     case 2:
251521d6a034SMatthew G. Knepley       normal[0] = -PetscRealPart(coords[1] - coords[cdim + 1]);
251621d6a034SMatthew G. Knepley       normal[1] = PetscRealPart(coords[0] - coords[cdim + 0]);
251721d6a034SMatthew G. Knepley       break;
251821d6a034SMatthew G. Knepley     case 1:
251921d6a034SMatthew G. Knepley       normal[0] = 1.0;
252021d6a034SMatthew G. Knepley       break;
252121d6a034SMatthew G. Knepley     default:
252221d6a034SMatthew G. Knepley       SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Dimension %" PetscInt_FMT " not supported", cdim);
252321d6a034SMatthew G. Knepley     }
252421d6a034SMatthew G. Knepley     norm = DMPlex_NormD_Internal(cdim, normal);
252521d6a034SMatthew G. Knepley     for (d = 0; d < cdim; ++d) normal[d] /= norm;
2526cc08537eSMatthew G. Knepley   }
2527cc08537eSMatthew G. Knepley   if (vol) {
2528714b99b6SMatthew G. Knepley     *vol = 0.0;
252921d6a034SMatthew G. Knepley     for (d = 0; d < cdim; ++d) *vol += PetscSqr(PetscRealPart(coords[d] - coords[cdim + d]));
2530714b99b6SMatthew G. Knepley     *vol = PetscSqrtReal(*vol);
2531cc08537eSMatthew G. Knepley   }
25326858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
25333ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2534cc08537eSMatthew G. Knepley }
2535cc08537eSMatthew G. Knepley 
2536cc08537eSMatthew G. Knepley /* Centroid_i = (\sum_n A_n Cn_i) / A */
2537d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeGeometryFVM_2D_Internal(DM dm, PetscInt dim, PetscInt cell, PetscReal *vol, PetscReal centroid[], PetscReal normal[])
2538d71ae5a4SJacob Faibussowitsch {
2539412e9a14SMatthew G. Knepley   DMPolytopeType     ct;
25406858538eSMatthew G. Knepley   const PetscScalar *array;
2541cc08537eSMatthew G. Knepley   PetscScalar       *coords = NULL;
25426858538eSMatthew G. Knepley   PetscInt           coordSize;
25436858538eSMatthew G. Knepley   PetscBool          isDG;
2544793a2a13SMatthew G. Knepley   PetscInt           fv[4] = {0, 1, 2, 3};
25456858538eSMatthew G. Knepley   PetscInt           cdim, numCorners, p, d;
2546cc08537eSMatthew G. Knepley 
2547cc08537eSMatthew G. Knepley   PetscFunctionBegin;
2548793a2a13SMatthew G. Knepley   /* Must check for hybrid cells because prisms have a different orientation scheme */
25499566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCellType(dm, cell, &ct));
2550412e9a14SMatthew G. Knepley   switch (ct) {
25519371c9d4SSatish Balay   case DM_POLYTOPE_SEG_PRISM_TENSOR:
25529371c9d4SSatish Balay     fv[2] = 3;
25539371c9d4SSatish Balay     fv[3] = 2;
25549371c9d4SSatish Balay     break;
2555d71ae5a4SJacob Faibussowitsch   default:
2556d71ae5a4SJacob Faibussowitsch     break;
2557412e9a14SMatthew G. Knepley   }
25589566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &cdim));
25596858538eSMatthew G. Knepley   PetscCall(DMPlexGetConeSize(dm, cell, &numCorners));
25606858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
25613f27a4e6SJed Brown   {
25623f27a4e6SJed Brown     PetscReal c[3] = {0., 0., 0.}, n[3] = {0., 0., 0.}, origin[3] = {0., 0., 0.}, norm;
2563793a2a13SMatthew G. Knepley 
25643f27a4e6SJed Brown     for (d = 0; d < cdim; d++) origin[d] = PetscRealPart(coords[d]);
25654f99dae5SMatthew G. Knepley     for (p = 0; p < numCorners - 2; ++p) {
25663f27a4e6SJed Brown       PetscReal e0[3] = {0., 0., 0.}, e1[3] = {0., 0., 0.};
25673f27a4e6SJed Brown       for (d = 0; d < cdim; d++) {
25683f27a4e6SJed Brown         e0[d] = PetscRealPart(coords[cdim * fv[p + 1] + d]) - origin[d];
25693f27a4e6SJed Brown         e1[d] = PetscRealPart(coords[cdim * fv[p + 2] + d]) - origin[d];
25703f27a4e6SJed Brown       }
25713f27a4e6SJed Brown       const PetscReal dx = e0[1] * e1[2] - e0[2] * e1[1];
25723f27a4e6SJed Brown       const PetscReal dy = e0[2] * e1[0] - e0[0] * e1[2];
25733f27a4e6SJed Brown       const PetscReal dz = e0[0] * e1[1] - e0[1] * e1[0];
25743f27a4e6SJed Brown       const PetscReal a  = PetscSqrtReal(dx * dx + dy * dy + dz * dz);
25754f99dae5SMatthew G. Knepley 
25764f99dae5SMatthew G. Knepley       n[0] += dx;
25774f99dae5SMatthew G. Knepley       n[1] += dy;
25784f99dae5SMatthew G. Knepley       n[2] += dz;
2579ad540459SPierre Jolivet       for (d = 0; d < cdim; d++) c[d] += a * PetscRealPart(origin[d] + coords[cdim * fv[p + 1] + d] + coords[cdim * fv[p + 2] + d]) / 3.;
2580ceee4971SMatthew G. Knepley     }
25814f99dae5SMatthew G. Knepley     norm = PetscSqrtReal(n[0] * n[0] + n[1] * n[1] + n[2] * n[2]);
258261451c10SMatthew G. Knepley     // Allow zero volume cells
258361451c10SMatthew G. Knepley     if (norm != 0) {
25844f99dae5SMatthew G. Knepley       n[0] /= norm;
25854f99dae5SMatthew G. Knepley       n[1] /= norm;
25864f99dae5SMatthew G. Knepley       n[2] /= norm;
25874f99dae5SMatthew G. Knepley       c[0] /= norm;
25884f99dae5SMatthew G. Knepley       c[1] /= norm;
25894f99dae5SMatthew G. Knepley       c[2] /= norm;
259061451c10SMatthew G. Knepley     }
25914f99dae5SMatthew G. Knepley     if (vol) *vol = 0.5 * norm;
25929371c9d4SSatish Balay     if (centroid)
25939371c9d4SSatish Balay       for (d = 0; d < cdim; ++d) centroid[d] = c[d];
25949371c9d4SSatish Balay     if (normal)
25959371c9d4SSatish Balay       for (d = 0; d < cdim; ++d) normal[d] = n[d];
25960a1d6728SMatthew G. Knepley   }
25976858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
25983ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2599cc08537eSMatthew G. Knepley }
2600cc08537eSMatthew G. Knepley 
26010ec8681fSMatthew G. Knepley /* Centroid_i = (\sum_n V_n Cn_i) / V */
2602d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexComputeGeometryFVM_3D_Internal(DM dm, PetscInt dim, PetscInt cell, PetscReal *vol, PetscReal centroid[], PetscReal normal[])
2603d71ae5a4SJacob Faibussowitsch {
2604412e9a14SMatthew G. Knepley   DMPolytopeType        ct;
26056858538eSMatthew G. Knepley   const PetscScalar    *array;
26060ec8681fSMatthew G. Knepley   PetscScalar          *coords = NULL;
26076858538eSMatthew G. Knepley   PetscInt              coordSize;
26086858538eSMatthew G. Knepley   PetscBool             isDG;
26093f27a4e6SJed Brown   PetscReal             vsum      = 0.0, vtmp, coordsTmp[3 * 3], origin[3];
26106858538eSMatthew G. Knepley   const PetscInt        order[16] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};
26116858538eSMatthew G. Knepley   const PetscInt       *cone, *faceSizes, *faces;
26126858538eSMatthew G. Knepley   const DMPolytopeType *faceTypes;
2613793a2a13SMatthew G. Knepley   PetscBool             isHybrid = PETSC_FALSE;
26146858538eSMatthew G. Knepley   PetscInt              numFaces, f, fOff = 0, p, d;
26150ec8681fSMatthew G. Knepley 
26160ec8681fSMatthew G. Knepley   PetscFunctionBegin;
261763a3b9bcSJacob Faibussowitsch   PetscCheck(dim <= 3, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "No support for dim %" PetscInt_FMT " > 3", dim);
2618793a2a13SMatthew G. Knepley   /* Must check for hybrid cells because prisms have a different orientation scheme */
26199566063dSJacob Faibussowitsch   PetscCall(DMPlexGetCellType(dm, cell, &ct));
2620412e9a14SMatthew G. Knepley   switch (ct) {
2621412e9a14SMatthew G. Knepley   case DM_POLYTOPE_POINT_PRISM_TENSOR:
2622412e9a14SMatthew G. Knepley   case DM_POLYTOPE_SEG_PRISM_TENSOR:
2623412e9a14SMatthew G. Knepley   case DM_POLYTOPE_TRI_PRISM_TENSOR:
2624d71ae5a4SJacob Faibussowitsch   case DM_POLYTOPE_QUAD_PRISM_TENSOR:
2625d71ae5a4SJacob Faibussowitsch     isHybrid = PETSC_TRUE;
2626d71ae5a4SJacob Faibussowitsch   default:
2627d71ae5a4SJacob Faibussowitsch     break;
2628412e9a14SMatthew G. Knepley   }
2629793a2a13SMatthew G. Knepley 
26309371c9d4SSatish Balay   if (centroid)
26319371c9d4SSatish Balay     for (d = 0; d < dim; ++d) centroid[d] = 0.0;
26326858538eSMatthew G. Knepley   PetscCall(DMPlexGetCone(dm, cell, &cone));
26336858538eSMatthew G. Knepley 
26346858538eSMatthew G. Knepley   // Using the closure of faces for coordinates does not work in periodic geometries, so we index into the cell coordinates
26356858538eSMatthew G. Knepley   PetscCall(DMPlexGetRawFaces_Internal(dm, ct, order, &numFaces, &faceTypes, &faceSizes, &faces));
26366858538eSMatthew G. Knepley   PetscCall(DMPlexGetCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
26370ec8681fSMatthew G. Knepley   for (f = 0; f < numFaces; ++f) {
2638793a2a13SMatthew G. Knepley     PetscBool flip = isHybrid && f == 0 ? PETSC_TRUE : PETSC_FALSE; /* The first hybrid face is reversed */
2639793a2a13SMatthew G. Knepley 
26403f27a4e6SJed Brown     // If using zero as the origin vertex for each tetrahedron, an element far from the origin will have positive and
26413f27a4e6SJed Brown     // negative volumes that nearly cancel, thus incurring rounding error. Here we define origin[] as the first vertex
26423f27a4e6SJed Brown     // so that all tetrahedra have positive volume.
26439371c9d4SSatish Balay     if (f == 0)
26449371c9d4SSatish Balay       for (d = 0; d < dim; d++) origin[d] = PetscRealPart(coords[d]);
26456858538eSMatthew G. Knepley     switch (faceTypes[f]) {
2646ba2698f1SMatthew G. Knepley     case DM_POLYTOPE_TRIANGLE:
26470ec8681fSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
26486858538eSMatthew G. Knepley         coordsTmp[0 * dim + d] = PetscRealPart(coords[faces[fOff + 0] * dim + d]) - origin[d];
26496858538eSMatthew G. Knepley         coordsTmp[1 * dim + d] = PetscRealPart(coords[faces[fOff + 1] * dim + d]) - origin[d];
26506858538eSMatthew G. Knepley         coordsTmp[2 * dim + d] = PetscRealPart(coords[faces[fOff + 2] * dim + d]) - origin[d];
26510ec8681fSMatthew G. Knepley       }
26520ec8681fSMatthew G. Knepley       Volume_Tetrahedron_Origin_Internal(&vtmp, coordsTmp);
26536858538eSMatthew G. Knepley       if (flip) vtmp = -vtmp;
26540ec8681fSMatthew G. Knepley       vsum += vtmp;
26554f25033aSJed Brown       if (centroid) { /* Centroid of OABC = (a+b+c)/4 */
26560ec8681fSMatthew G. Knepley         for (d = 0; d < dim; ++d) {
26571ee9d5ecSMatthew G. Knepley           for (p = 0; p < 3; ++p) centroid[d] += coordsTmp[p * dim + d] * vtmp;
26580ec8681fSMatthew G. Knepley         }
26590ec8681fSMatthew G. Knepley       }
26600ec8681fSMatthew G. Knepley       break;
2661ba2698f1SMatthew G. Knepley     case DM_POLYTOPE_QUADRILATERAL:
26629371c9d4SSatish Balay     case DM_POLYTOPE_SEG_PRISM_TENSOR: {
2663793a2a13SMatthew G. Knepley       PetscInt fv[4] = {0, 1, 2, 3};
2664793a2a13SMatthew G. Knepley 
2665793a2a13SMatthew G. Knepley       /* Side faces for hybrid cells are are stored as tensor products */
26669371c9d4SSatish Balay       if (isHybrid && f > 1) {
26679371c9d4SSatish Balay         fv[2] = 3;
26689371c9d4SSatish Balay         fv[3] = 2;
26699371c9d4SSatish Balay       }
26700ec8681fSMatthew G. Knepley       /* DO FOR PYRAMID */
26710ec8681fSMatthew G. Knepley       /* First tet */
26720ec8681fSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
26736858538eSMatthew G. Knepley         coordsTmp[0 * dim + d] = PetscRealPart(coords[faces[fOff + fv[0]] * dim + d]) - origin[d];
26746858538eSMatthew G. Knepley         coordsTmp[1 * dim + d] = PetscRealPart(coords[faces[fOff + fv[1]] * dim + d]) - origin[d];
26756858538eSMatthew G. Knepley         coordsTmp[2 * dim + d] = PetscRealPart(coords[faces[fOff + fv[3]] * dim + d]) - origin[d];
26760ec8681fSMatthew G. Knepley       }
26770ec8681fSMatthew G. Knepley       Volume_Tetrahedron_Origin_Internal(&vtmp, coordsTmp);
26786858538eSMatthew G. Knepley       if (flip) vtmp = -vtmp;
26790ec8681fSMatthew G. Knepley       vsum += vtmp;
26800ec8681fSMatthew G. Knepley       if (centroid) {
26810ec8681fSMatthew G. Knepley         for (d = 0; d < dim; ++d) {
26820ec8681fSMatthew G. Knepley           for (p = 0; p < 3; ++p) centroid[d] += coordsTmp[p * dim + d] * vtmp;
26830ec8681fSMatthew G. Knepley         }
26840ec8681fSMatthew G. Knepley       }
26850ec8681fSMatthew G. Knepley       /* Second tet */
26860ec8681fSMatthew G. Knepley       for (d = 0; d < dim; ++d) {
26876858538eSMatthew G. Knepley         coordsTmp[0 * dim + d] = PetscRealPart(coords[faces[fOff + fv[1]] * dim + d]) - origin[d];
26886858538eSMatthew G. Knepley         coordsTmp[1 * dim + d] = PetscRealPart(coords[faces[fOff + fv[2]] * dim + d]) - origin[d];
26896858538eSMatthew G. Knepley         coordsTmp[2 * dim + d] = PetscRealPart(coords[faces[fOff + fv[3]] * dim + d]) - origin[d];
26900ec8681fSMatthew G. Knepley       }
26910ec8681fSMatthew G. Knepley       Volume_Tetrahedron_Origin_Internal(&vtmp, coordsTmp);
26926858538eSMatthew G. Knepley       if (flip) vtmp = -vtmp;
26930ec8681fSMatthew G. Knepley       vsum += vtmp;
26940ec8681fSMatthew G. Knepley       if (centroid) {
26950ec8681fSMatthew G. Knepley         for (d = 0; d < dim; ++d) {
26960ec8681fSMatthew G. Knepley           for (p = 0; p < 3; ++p) centroid[d] += coordsTmp[p * dim + d] * vtmp;
26970ec8681fSMatthew G. Knepley         }
26980ec8681fSMatthew G. Knepley       }
26990ec8681fSMatthew G. Knepley       break;
2700793a2a13SMatthew G. Knepley     }
2701d71ae5a4SJacob Faibussowitsch     default:
2702d71ae5a4SJacob Faibussowitsch       SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "Cannot handle face %" PetscInt_FMT " of type %s", cone[f], DMPolytopeTypes[ct]);
27030ec8681fSMatthew G. Knepley     }
27046858538eSMatthew G. Knepley     fOff += faceSizes[f];
27050ec8681fSMatthew G. Knepley   }
27066858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreRawFaces_Internal(dm, ct, order, &numFaces, &faceTypes, &faceSizes, &faces));
27076858538eSMatthew G. Knepley   PetscCall(DMPlexRestoreCellCoordinates(dm, cell, &isDG, &coordSize, &array, &coords));
27088763be8eSMatthew G. Knepley   if (vol) *vol = PetscAbsReal(vsum);
27099371c9d4SSatish Balay   if (normal)
27109371c9d4SSatish Balay     for (d = 0; d < dim; ++d) normal[d] = 0.0;
27119371c9d4SSatish Balay   if (centroid)
27129371c9d4SSatish Balay     for (d = 0; d < dim; ++d) centroid[d] = centroid[d] / (vsum * 4) + origin[d];
27133ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
27140ec8681fSMatthew G. Knepley }
27150ec8681fSMatthew G. Knepley 
2716834e62ceSMatthew G. Knepley /*@C
2717834e62ceSMatthew G. Knepley   DMPlexComputeCellGeometryFVM - Compute the volume for a given cell
2718834e62ceSMatthew G. Knepley 
271920f4b53cSBarry Smith   Collective
2720834e62ceSMatthew G. Knepley 
27214165533cSJose E. Roman   Input Parameters:
272220f4b53cSBarry Smith + dm   - the `DMPLEX`
2723834e62ceSMatthew G. Knepley - cell - the cell
2724834e62ceSMatthew G. Knepley 
27254165533cSJose E. Roman   Output Parameters:
2726834e62ceSMatthew G. Knepley + volume   - the cell volume
2727cc08537eSMatthew G. Knepley . centroid - the cell centroid
2728cc08537eSMatthew G. Knepley - normal - the cell normal, if appropriate
2729834e62ceSMatthew G. Knepley 
2730834e62ceSMatthew G. Knepley   Level: advanced
2731834e62ceSMatthew G. Knepley 
273220f4b53cSBarry Smith .seealso: `DMPLEX`, `DMGetCoordinateSection()`, `DMGetCoordinates()`
2733834e62ceSMatthew G. Knepley @*/
2734d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeCellGeometryFVM(DM dm, PetscInt cell, PetscReal *vol, PetscReal centroid[], PetscReal normal[])
2735d71ae5a4SJacob Faibussowitsch {
27360ec8681fSMatthew G. Knepley   PetscInt depth, dim;
2737834e62ceSMatthew G. Knepley 
2738834e62ceSMatthew G. Knepley   PetscFunctionBegin;
27399566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
27409566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
274108401ef6SPierre Jolivet   PetscCheck(depth == dim, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Mesh must be interpolated");
27429566063dSJacob Faibussowitsch   PetscCall(DMPlexGetPointDepth(dm, cell, &depth));
2743011ea5d8SMatthew G. Knepley   switch (depth) {
2744d71ae5a4SJacob Faibussowitsch   case 0:
2745d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexComputeGeometryFVM_0D_Internal(dm, dim, cell, vol, centroid, normal));
2746d71ae5a4SJacob Faibussowitsch     break;
2747d71ae5a4SJacob Faibussowitsch   case 1:
2748d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexComputeGeometryFVM_1D_Internal(dm, dim, cell, vol, centroid, normal));
2749d71ae5a4SJacob Faibussowitsch     break;
2750d71ae5a4SJacob Faibussowitsch   case 2:
2751d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexComputeGeometryFVM_2D_Internal(dm, dim, cell, vol, centroid, normal));
2752d71ae5a4SJacob Faibussowitsch     break;
2753d71ae5a4SJacob Faibussowitsch   case 3:
2754d71ae5a4SJacob Faibussowitsch     PetscCall(DMPlexComputeGeometryFVM_3D_Internal(dm, dim, cell, vol, centroid, normal));
2755d71ae5a4SJacob Faibussowitsch     break;
2756d71ae5a4SJacob Faibussowitsch   default:
2757d71ae5a4SJacob Faibussowitsch     SETERRQ(PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "Unsupported dimension %" PetscInt_FMT " (depth %" PetscInt_FMT ") for element geometry computation", dim, depth);
2758834e62ceSMatthew G. Knepley   }
27593ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2760834e62ceSMatthew G. Knepley }
2761113c68e6SMatthew G. Knepley 
2762c501906fSMatthew G. Knepley /*@
2763891a9168SMatthew G. Knepley   DMPlexComputeGeometryFVM - Computes the cell and face geometry for a finite volume method
2764891a9168SMatthew G. Knepley 
2765891a9168SMatthew G. Knepley   Input Parameter:
276620f4b53cSBarry Smith . dm - The `DMPLEX`
2767891a9168SMatthew G. Knepley 
2768891a9168SMatthew G. Knepley   Output Parameters:
276920f4b53cSBarry Smith + cellgeom - A `Vec` of `PetscFVCellGeom` data
277020f4b53cSBarry Smith - facegeom - A `Vec` of `PetscFVFaceGeom` data
2771891a9168SMatthew G. Knepley 
2772891a9168SMatthew G. Knepley   Level: developer
2773891a9168SMatthew G. Knepley 
277420f4b53cSBarry Smith .seealso: `DMPLEX`, `PetscFVFaceGeom`, `PetscFVCellGeom`
2775891a9168SMatthew G. Knepley @*/
2776d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeGeometryFVM(DM dm, Vec *cellgeom, Vec *facegeom)
2777d71ae5a4SJacob Faibussowitsch {
2778113c68e6SMatthew G. Knepley   DM           dmFace, dmCell;
2779113c68e6SMatthew G. Knepley   DMLabel      ghostLabel;
2780113c68e6SMatthew G. Knepley   PetscSection sectionFace, sectionCell;
2781113c68e6SMatthew G. Knepley   PetscSection coordSection;
2782113c68e6SMatthew G. Knepley   Vec          coordinates;
2783113c68e6SMatthew G. Knepley   PetscScalar *fgeom, *cgeom;
2784113c68e6SMatthew G. Knepley   PetscReal    minradius, gminradius;
2785113c68e6SMatthew G. Knepley   PetscInt     dim, cStart, cEnd, cEndInterior, c, fStart, fEnd, f;
2786113c68e6SMatthew G. Knepley 
2787113c68e6SMatthew G. Knepley   PetscFunctionBegin;
27889566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
27899566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateSection(dm, &coordSection));
27909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &coordinates));
2791113c68e6SMatthew G. Knepley   /* Make cell centroids and volumes */
27929566063dSJacob Faibussowitsch   PetscCall(DMClone(dm, &dmCell));
27939566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinateSection(dmCell, PETSC_DETERMINE, coordSection));
27949566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dmCell, coordinates));
27959566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &sectionCell));
27969566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
2797*2827ebadSStefano Zampini   PetscCall(DMPlexGetCellTypeStratum(dm, DM_POLYTOPE_FV_GHOST, &cEndInterior, NULL));
27989566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(sectionCell, cStart, cEnd));
27999566063dSJacob Faibussowitsch   for (c = cStart; c < cEnd; ++c) PetscCall(PetscSectionSetDof(sectionCell, c, (PetscInt)PetscCeilReal(((PetscReal)sizeof(PetscFVCellGeom)) / sizeof(PetscScalar))));
28009566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(sectionCell));
28019566063dSJacob Faibussowitsch   PetscCall(DMSetLocalSection(dmCell, sectionCell));
28029566063dSJacob Faibussowitsch   PetscCall(PetscSectionDestroy(&sectionCell));
28039566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(dmCell, cellgeom));
2804485ad865SMatthew G. Knepley   if (cEndInterior < 0) cEndInterior = cEnd;
28059566063dSJacob Faibussowitsch   PetscCall(VecGetArray(*cellgeom, &cgeom));
2806113c68e6SMatthew G. Knepley   for (c = cStart; c < cEndInterior; ++c) {
2807113c68e6SMatthew G. Knepley     PetscFVCellGeom *cg;
2808113c68e6SMatthew G. Knepley 
28099566063dSJacob Faibussowitsch     PetscCall(DMPlexPointLocalRef(dmCell, c, cgeom, &cg));
28109566063dSJacob Faibussowitsch     PetscCall(PetscArrayzero(cg, 1));
28119566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeCellGeometryFVM(dmCell, c, &cg->volume, cg->centroid, NULL));
2812113c68e6SMatthew G. Knepley   }
2813113c68e6SMatthew G. Knepley   /* Compute face normals and minimum cell radius */
28149566063dSJacob Faibussowitsch   PetscCall(DMClone(dm, &dmFace));
28159566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &sectionFace));
28169566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
28179566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(sectionFace, fStart, fEnd));
28189566063dSJacob Faibussowitsch   for (f = fStart; f < fEnd; ++f) PetscCall(PetscSectionSetDof(sectionFace, f, (PetscInt)PetscCeilReal(((PetscReal)sizeof(PetscFVFaceGeom)) / sizeof(PetscScalar))));
28199566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(sectionFace));
28209566063dSJacob Faibussowitsch   PetscCall(DMSetLocalSection(dmFace, sectionFace));
28219566063dSJacob Faibussowitsch   PetscCall(PetscSectionDestroy(&sectionFace));
28229566063dSJacob Faibussowitsch   PetscCall(DMCreateLocalVector(dmFace, facegeom));
28239566063dSJacob Faibussowitsch   PetscCall(VecGetArray(*facegeom, &fgeom));
28249566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "ghost", &ghostLabel));
2825113c68e6SMatthew G. Knepley   minradius = PETSC_MAX_REAL;
2826113c68e6SMatthew G. Knepley   for (f = fStart; f < fEnd; ++f) {
2827113c68e6SMatthew G. Knepley     PetscFVFaceGeom *fg;
2828113c68e6SMatthew G. Knepley     PetscReal        area;
2829412e9a14SMatthew G. Knepley     const PetscInt  *cells;
2830412e9a14SMatthew G. Knepley     PetscInt         ncells, ghost = -1, d, numChildren;
2831113c68e6SMatthew G. Knepley 
28329566063dSJacob Faibussowitsch     if (ghostLabel) PetscCall(DMLabelGetValue(ghostLabel, f, &ghost));
28339566063dSJacob Faibussowitsch     PetscCall(DMPlexGetTreeChildren(dm, f, &numChildren, NULL));
28349566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupport(dm, f, &cells));
28359566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupportSize(dm, f, &ncells));
2836412e9a14SMatthew G. Knepley     /* It is possible to get a face with no support when using partition overlap */
2837412e9a14SMatthew G. Knepley     if (!ncells || ghost >= 0 || numChildren) continue;
28389566063dSJacob Faibussowitsch     PetscCall(DMPlexPointLocalRef(dmFace, f, fgeom, &fg));
28399566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeCellGeometryFVM(dm, f, &area, fg->centroid, fg->normal));
2840113c68e6SMatthew G. Knepley     for (d = 0; d < dim; ++d) fg->normal[d] *= area;
2841113c68e6SMatthew G. Knepley     /* Flip face orientation if necessary to match ordering in support, and Update minimum radius */
2842113c68e6SMatthew G. Knepley     {
2843113c68e6SMatthew G. Knepley       PetscFVCellGeom *cL, *cR;
2844113c68e6SMatthew G. Knepley       PetscReal       *lcentroid, *rcentroid;
28450453c0cdSMatthew G. Knepley       PetscReal        l[3], r[3], v[3];
2846113c68e6SMatthew G. Knepley 
28479566063dSJacob Faibussowitsch       PetscCall(DMPlexPointLocalRead(dmCell, cells[0], cgeom, &cL));
2848113c68e6SMatthew G. Knepley       lcentroid = cells[0] >= cEndInterior ? fg->centroid : cL->centroid;
284906348e87SToby Isaac       if (ncells > 1) {
28509566063dSJacob Faibussowitsch         PetscCall(DMPlexPointLocalRead(dmCell, cells[1], cgeom, &cR));
2851113c68e6SMatthew G. Knepley         rcentroid = cells[1] >= cEndInterior ? fg->centroid : cR->centroid;
28529371c9d4SSatish Balay       } else {
285306348e87SToby Isaac         rcentroid = fg->centroid;
285406348e87SToby Isaac       }
28559566063dSJacob Faibussowitsch       PetscCall(DMLocalizeCoordinateReal_Internal(dm, dim, fg->centroid, lcentroid, l));
28569566063dSJacob Faibussowitsch       PetscCall(DMLocalizeCoordinateReal_Internal(dm, dim, fg->centroid, rcentroid, r));
28570453c0cdSMatthew G. Knepley       DMPlex_WaxpyD_Internal(dim, -1, l, r, v);
2858113c68e6SMatthew G. Knepley       if (DMPlex_DotRealD_Internal(dim, fg->normal, v) < 0) {
2859113c68e6SMatthew G. Knepley         for (d = 0; d < dim; ++d) fg->normal[d] = -fg->normal[d];
2860113c68e6SMatthew G. Knepley       }
2861113c68e6SMatthew G. Knepley       if (DMPlex_DotRealD_Internal(dim, fg->normal, v) <= 0) {
286263a3b9bcSJacob Faibussowitsch         PetscCheck(dim != 2, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Direction for face %" PetscInt_FMT " could not be fixed, normal (%g,%g) v (%g,%g)", f, (double)fg->normal[0], (double)fg->normal[1], (double)v[0], (double)v[1]);
286363a3b9bcSJacob Faibussowitsch         PetscCheck(dim != 3, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Direction for face %" PetscInt_FMT " could not be fixed, normal (%g,%g,%g) v (%g,%g,%g)", f, (double)fg->normal[0], (double)fg->normal[1], (double)fg->normal[2], (double)v[0], (double)v[1], (double)v[2]);
286463a3b9bcSJacob Faibussowitsch         SETERRQ(PETSC_COMM_SELF, PETSC_ERR_PLIB, "Direction for face %" PetscInt_FMT " could not be fixed", f);
2865113c68e6SMatthew G. Knepley       }
2866113c68e6SMatthew G. Knepley       if (cells[0] < cEndInterior) {
2867113c68e6SMatthew G. Knepley         DMPlex_WaxpyD_Internal(dim, -1, fg->centroid, cL->centroid, v);
2868113c68e6SMatthew G. Knepley         minradius = PetscMin(minradius, DMPlex_NormD_Internal(dim, v));
2869113c68e6SMatthew G. Knepley       }
287006348e87SToby Isaac       if (ncells > 1 && cells[1] < cEndInterior) {
2871113c68e6SMatthew G. Knepley         DMPlex_WaxpyD_Internal(dim, -1, fg->centroid, cR->centroid, v);
2872113c68e6SMatthew G. Knepley         minradius = PetscMin(minradius, DMPlex_NormD_Internal(dim, v));
2873113c68e6SMatthew G. Knepley       }
2874113c68e6SMatthew G. Knepley     }
2875113c68e6SMatthew G. Knepley   }
28761c2dc1cbSBarry Smith   PetscCall(MPIU_Allreduce(&minradius, &gminradius, 1, MPIU_REAL, MPIU_MIN, PetscObjectComm((PetscObject)dm)));
28779566063dSJacob Faibussowitsch   PetscCall(DMPlexSetMinRadius(dm, gminradius));
2878113c68e6SMatthew G. Knepley   /* Compute centroids of ghost cells */
2879113c68e6SMatthew G. Knepley   for (c = cEndInterior; c < cEnd; ++c) {
2880113c68e6SMatthew G. Knepley     PetscFVFaceGeom *fg;
2881113c68e6SMatthew G. Knepley     const PetscInt  *cone, *support;
2882113c68e6SMatthew G. Knepley     PetscInt         coneSize, supportSize, s;
2883113c68e6SMatthew G. Knepley 
28849566063dSJacob Faibussowitsch     PetscCall(DMPlexGetConeSize(dmCell, c, &coneSize));
288563a3b9bcSJacob Faibussowitsch     PetscCheck(coneSize == 1, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Ghost cell %" PetscInt_FMT " has cone size %" PetscInt_FMT " != 1", c, coneSize);
28869566063dSJacob Faibussowitsch     PetscCall(DMPlexGetCone(dmCell, c, &cone));
28879566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupportSize(dmCell, cone[0], &supportSize));
288863a3b9bcSJacob Faibussowitsch     PetscCheck(supportSize == 2, PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Face %" PetscInt_FMT " has support size %" PetscInt_FMT " != 2", cone[0], supportSize);
28899566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupport(dmCell, cone[0], &support));
28909566063dSJacob Faibussowitsch     PetscCall(DMPlexPointLocalRef(dmFace, cone[0], fgeom, &fg));
2891113c68e6SMatthew G. Knepley     for (s = 0; s < 2; ++s) {
2892113c68e6SMatthew G. Knepley       /* Reflect ghost centroid across plane of face */
2893113c68e6SMatthew G. Knepley       if (support[s] == c) {
2894640bce14SSatish Balay         PetscFVCellGeom *ci;
2895113c68e6SMatthew G. Knepley         PetscFVCellGeom *cg;
2896113c68e6SMatthew G. Knepley         PetscReal        c2f[3], a;
2897113c68e6SMatthew G. Knepley 
28989566063dSJacob Faibussowitsch         PetscCall(DMPlexPointLocalRead(dmCell, support[(s + 1) % 2], cgeom, &ci));
2899113c68e6SMatthew G. Knepley         DMPlex_WaxpyD_Internal(dim, -1, ci->centroid, fg->centroid, c2f); /* cell to face centroid */
2900113c68e6SMatthew G. Knepley         a = DMPlex_DotRealD_Internal(dim, c2f, fg->normal) / DMPlex_DotRealD_Internal(dim, fg->normal, fg->normal);
29019566063dSJacob Faibussowitsch         PetscCall(DMPlexPointLocalRef(dmCell, support[s], cgeom, &cg));
2902113c68e6SMatthew G. Knepley         DMPlex_WaxpyD_Internal(dim, 2 * a, fg->normal, ci->centroid, cg->centroid);
2903113c68e6SMatthew G. Knepley         cg->volume = ci->volume;
2904113c68e6SMatthew G. Knepley       }
2905113c68e6SMatthew G. Knepley     }
2906113c68e6SMatthew G. Knepley   }
29079566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(*facegeom, &fgeom));
29089566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(*cellgeom, &cgeom));
29099566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&dmCell));
29109566063dSJacob Faibussowitsch   PetscCall(DMDestroy(&dmFace));
29113ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2912113c68e6SMatthew G. Knepley }
2913113c68e6SMatthew G. Knepley 
2914113c68e6SMatthew G. Knepley /*@C
2915113c68e6SMatthew G. Knepley   DMPlexGetMinRadius - Returns the minimum distance from any cell centroid to a face
2916113c68e6SMatthew G. Knepley 
291720f4b53cSBarry Smith   Not Collective
2918113c68e6SMatthew G. Knepley 
29194165533cSJose E. Roman   Input Parameter:
292020f4b53cSBarry Smith . dm - the `DMPLEX`
2921113c68e6SMatthew G. Knepley 
29224165533cSJose E. Roman   Output Parameter:
2923a5b23f4aSJose E. Roman . minradius - the minimum cell radius
2924113c68e6SMatthew G. Knepley 
2925113c68e6SMatthew G. Knepley   Level: developer
2926113c68e6SMatthew G. Knepley 
292720f4b53cSBarry Smith .seealso: `DMPLEX`, `DMGetCoordinates()`
2928113c68e6SMatthew G. Knepley @*/
2929d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexGetMinRadius(DM dm, PetscReal *minradius)
2930d71ae5a4SJacob Faibussowitsch {
2931113c68e6SMatthew G. Knepley   PetscFunctionBegin;
2932113c68e6SMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
2933dadcf809SJacob Faibussowitsch   PetscValidRealPointer(minradius, 2);
2934113c68e6SMatthew G. Knepley   *minradius = ((DM_Plex *)dm->data)->minradius;
29353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2936113c68e6SMatthew G. Knepley }
2937113c68e6SMatthew G. Knepley 
2938113c68e6SMatthew G. Knepley /*@C
2939113c68e6SMatthew G. Knepley   DMPlexSetMinRadius - Sets the minimum distance from the cell centroid to a face
2940113c68e6SMatthew G. Knepley 
294120f4b53cSBarry Smith   Logically Collective
2942113c68e6SMatthew G. Knepley 
29434165533cSJose E. Roman   Input Parameters:
294420f4b53cSBarry Smith + dm - the `DMPLEX`
2945a5b23f4aSJose E. Roman - minradius - the minimum cell radius
2946113c68e6SMatthew G. Knepley 
2947113c68e6SMatthew G. Knepley   Level: developer
2948113c68e6SMatthew G. Knepley 
294920f4b53cSBarry Smith .seealso: `DMPLEX`, `DMSetCoordinates()`
2950113c68e6SMatthew G. Knepley @*/
2951d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexSetMinRadius(DM dm, PetscReal minradius)
2952d71ae5a4SJacob Faibussowitsch {
2953113c68e6SMatthew G. Knepley   PetscFunctionBegin;
2954113c68e6SMatthew G. Knepley   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
2955113c68e6SMatthew G. Knepley   ((DM_Plex *)dm->data)->minradius = minradius;
29563ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
2957113c68e6SMatthew G. Knepley }
2958856ac710SMatthew G. Knepley 
2959d71ae5a4SJacob Faibussowitsch static PetscErrorCode BuildGradientReconstruction_Internal(DM dm, PetscFV fvm, DM dmFace, PetscScalar *fgeom, DM dmCell, PetscScalar *cgeom)
2960d71ae5a4SJacob Faibussowitsch {
2961856ac710SMatthew G. Knepley   DMLabel      ghostLabel;
2962856ac710SMatthew G. Knepley   PetscScalar *dx, *grad, **gref;
2963856ac710SMatthew G. Knepley   PetscInt     dim, cStart, cEnd, c, cEndInterior, maxNumFaces;
2964856ac710SMatthew G. Knepley 
2965856ac710SMatthew G. Knepley   PetscFunctionBegin;
29669566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
29679566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
2968*2827ebadSStefano Zampini   PetscCall(DMPlexGetCellTypeStratum(dm, DM_POLYTOPE_FV_GHOST, &cEndInterior, NULL));
2969089217ebSMatthew G. Knepley   cEndInterior = cEndInterior < 0 ? cEnd : cEndInterior;
29709566063dSJacob Faibussowitsch   PetscCall(DMPlexGetMaxSizes(dm, &maxNumFaces, NULL));
29719566063dSJacob Faibussowitsch   PetscCall(PetscFVLeastSquaresSetMaxFaces(fvm, maxNumFaces));
29729566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "ghost", &ghostLabel));
29739566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(maxNumFaces * dim, &dx, maxNumFaces * dim, &grad, maxNumFaces, &gref));
2974856ac710SMatthew G. Knepley   for (c = cStart; c < cEndInterior; c++) {
2975856ac710SMatthew G. Knepley     const PetscInt  *faces;
2976856ac710SMatthew G. Knepley     PetscInt         numFaces, usedFaces, f, d;
2977640bce14SSatish Balay     PetscFVCellGeom *cg;
2978856ac710SMatthew G. Knepley     PetscBool        boundary;
2979856ac710SMatthew G. Knepley     PetscInt         ghost;
2980856ac710SMatthew G. Knepley 
2981a79418b7SMatt McGurn     // do not attempt to compute a gradient reconstruction stencil in a ghost cell.  It will never be used
2982a79418b7SMatt McGurn     PetscCall(DMLabelGetValue(ghostLabel, c, &ghost));
2983a79418b7SMatt McGurn     if (ghost >= 0) continue;
2984a79418b7SMatt McGurn 
29859566063dSJacob Faibussowitsch     PetscCall(DMPlexPointLocalRead(dmCell, c, cgeom, &cg));
29869566063dSJacob Faibussowitsch     PetscCall(DMPlexGetConeSize(dm, c, &numFaces));
29879566063dSJacob Faibussowitsch     PetscCall(DMPlexGetCone(dm, c, &faces));
298863a3b9bcSJacob Faibussowitsch     PetscCheck(numFaces >= dim, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Cell %" PetscInt_FMT " has only %" PetscInt_FMT " faces, not enough for gradient reconstruction", c, numFaces);
2989856ac710SMatthew G. Knepley     for (f = 0, usedFaces = 0; f < numFaces; ++f) {
2990640bce14SSatish Balay       PetscFVCellGeom *cg1;
2991856ac710SMatthew G. Knepley       PetscFVFaceGeom *fg;
2992856ac710SMatthew G. Knepley       const PetscInt  *fcells;
2993856ac710SMatthew G. Knepley       PetscInt         ncell, side;
2994856ac710SMatthew G. Knepley 
29959566063dSJacob Faibussowitsch       PetscCall(DMLabelGetValue(ghostLabel, faces[f], &ghost));
29969566063dSJacob Faibussowitsch       PetscCall(DMIsBoundaryPoint(dm, faces[f], &boundary));
2997856ac710SMatthew G. Knepley       if ((ghost >= 0) || boundary) continue;
29989566063dSJacob Faibussowitsch       PetscCall(DMPlexGetSupport(dm, faces[f], &fcells));
2999856ac710SMatthew G. Knepley       side  = (c != fcells[0]); /* c is on left=0 or right=1 of face */
3000856ac710SMatthew G. Knepley       ncell = fcells[!side];    /* the neighbor */
30019566063dSJacob Faibussowitsch       PetscCall(DMPlexPointLocalRef(dmFace, faces[f], fgeom, &fg));
30029566063dSJacob Faibussowitsch       PetscCall(DMPlexPointLocalRead(dmCell, ncell, cgeom, &cg1));
3003856ac710SMatthew G. Knepley       for (d = 0; d < dim; ++d) dx[usedFaces * dim + d] = cg1->centroid[d] - cg->centroid[d];
3004856ac710SMatthew G. Knepley       gref[usedFaces++] = fg->grad[side]; /* Gradient reconstruction term will go here */
3005856ac710SMatthew G. Knepley     }
300628b400f6SJacob Faibussowitsch     PetscCheck(usedFaces, PETSC_COMM_SELF, PETSC_ERR_USER, "Mesh contains isolated cell (no neighbors). Is it intentional?");
30079566063dSJacob Faibussowitsch     PetscCall(PetscFVComputeGradient(fvm, usedFaces, dx, grad));
3008856ac710SMatthew G. Knepley     for (f = 0, usedFaces = 0; f < numFaces; ++f) {
30099566063dSJacob Faibussowitsch       PetscCall(DMLabelGetValue(ghostLabel, faces[f], &ghost));
30109566063dSJacob Faibussowitsch       PetscCall(DMIsBoundaryPoint(dm, faces[f], &boundary));
3011856ac710SMatthew G. Knepley       if ((ghost >= 0) || boundary) continue;
3012856ac710SMatthew G. Knepley       for (d = 0; d < dim; ++d) gref[usedFaces][d] = grad[usedFaces * dim + d];
3013856ac710SMatthew G. Knepley       ++usedFaces;
3014856ac710SMatthew G. Knepley     }
3015856ac710SMatthew G. Knepley   }
30169566063dSJacob Faibussowitsch   PetscCall(PetscFree3(dx, grad, gref));
30173ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3018856ac710SMatthew G. Knepley }
3019856ac710SMatthew G. Knepley 
3020d71ae5a4SJacob Faibussowitsch static PetscErrorCode BuildGradientReconstruction_Internal_Tree(DM dm, PetscFV fvm, DM dmFace, PetscScalar *fgeom, DM dmCell, PetscScalar *cgeom)
3021d71ae5a4SJacob Faibussowitsch {
3022b81db932SToby Isaac   DMLabel      ghostLabel;
3023b81db932SToby Isaac   PetscScalar *dx, *grad, **gref;
3024b81db932SToby Isaac   PetscInt     dim, cStart, cEnd, c, cEndInterior, fStart, fEnd, f, nStart, nEnd, maxNumFaces = 0;
3025b81db932SToby Isaac   PetscSection neighSec;
3026b81db932SToby Isaac   PetscInt(*neighbors)[2];
3027b81db932SToby Isaac   PetscInt *counter;
3028b81db932SToby Isaac 
3029b81db932SToby Isaac   PetscFunctionBegin;
30309566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
30319566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
3032*2827ebadSStefano Zampini   PetscCall(DMPlexGetCellTypeStratum(dm, DM_POLYTOPE_FV_GHOST, &cEndInterior, NULL));
3033485ad865SMatthew G. Knepley   if (cEndInterior < 0) cEndInterior = cEnd;
30349566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &neighSec));
30359566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(neighSec, cStart, cEndInterior));
30369566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 1, &fStart, &fEnd));
30379566063dSJacob Faibussowitsch   PetscCall(DMGetLabel(dm, "ghost", &ghostLabel));
3038b81db932SToby Isaac   for (f = fStart; f < fEnd; f++) {
3039b81db932SToby Isaac     const PetscInt *fcells;
3040b81db932SToby Isaac     PetscBool       boundary;
30415bc680faSToby Isaac     PetscInt        ghost = -1;
3042b81db932SToby Isaac     PetscInt        numChildren, numCells, c;
3043b81db932SToby Isaac 
30449566063dSJacob Faibussowitsch     if (ghostLabel) PetscCall(DMLabelGetValue(ghostLabel, f, &ghost));
30459566063dSJacob Faibussowitsch     PetscCall(DMIsBoundaryPoint(dm, f, &boundary));
30469566063dSJacob Faibussowitsch     PetscCall(DMPlexGetTreeChildren(dm, f, &numChildren, NULL));
3047b81db932SToby Isaac     if ((ghost >= 0) || boundary || numChildren) continue;
30489566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupportSize(dm, f, &numCells));
304906348e87SToby Isaac     if (numCells == 2) {
30509566063dSJacob Faibussowitsch       PetscCall(DMPlexGetSupport(dm, f, &fcells));
3051b81db932SToby Isaac       for (c = 0; c < 2; c++) {
3052b81db932SToby Isaac         PetscInt cell = fcells[c];
3053b81db932SToby Isaac 
305448a46eb9SPierre Jolivet         if (cell >= cStart && cell < cEndInterior) PetscCall(PetscSectionAddDof(neighSec, cell, 1));
3055b81db932SToby Isaac       }
3056b81db932SToby Isaac     }
305706348e87SToby Isaac   }
30589566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(neighSec));
30599566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetMaxDof(neighSec, &maxNumFaces));
30609566063dSJacob Faibussowitsch   PetscCall(PetscFVLeastSquaresSetMaxFaces(fvm, maxNumFaces));
3061b81db932SToby Isaac   nStart = 0;
30629566063dSJacob Faibussowitsch   PetscCall(PetscSectionGetStorageSize(neighSec, &nEnd));
30639566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1((nEnd - nStart), &neighbors));
30649566063dSJacob Faibussowitsch   PetscCall(PetscCalloc1((cEndInterior - cStart), &counter));
3065b81db932SToby Isaac   for (f = fStart; f < fEnd; f++) {
3066b81db932SToby Isaac     const PetscInt *fcells;
3067b81db932SToby Isaac     PetscBool       boundary;
30685bc680faSToby Isaac     PetscInt        ghost = -1;
3069b81db932SToby Isaac     PetscInt        numChildren, numCells, c;
3070b81db932SToby Isaac 
30719566063dSJacob Faibussowitsch     if (ghostLabel) PetscCall(DMLabelGetValue(ghostLabel, f, &ghost));
30729566063dSJacob Faibussowitsch     PetscCall(DMIsBoundaryPoint(dm, f, &boundary));
30739566063dSJacob Faibussowitsch     PetscCall(DMPlexGetTreeChildren(dm, f, &numChildren, NULL));
3074b81db932SToby Isaac     if ((ghost >= 0) || boundary || numChildren) continue;
30759566063dSJacob Faibussowitsch     PetscCall(DMPlexGetSupportSize(dm, f, &numCells));
307606348e87SToby Isaac     if (numCells == 2) {
30779566063dSJacob Faibussowitsch       PetscCall(DMPlexGetSupport(dm, f, &fcells));
3078b81db932SToby Isaac       for (c = 0; c < 2; c++) {
3079b81db932SToby Isaac         PetscInt cell = fcells[c], off;
3080b81db932SToby Isaac 
3081e6885bbbSToby Isaac         if (cell >= cStart && cell < cEndInterior) {
30829566063dSJacob Faibussowitsch           PetscCall(PetscSectionGetOffset(neighSec, cell, &off));
3083b81db932SToby Isaac           off += counter[cell - cStart]++;
3084b81db932SToby Isaac           neighbors[off][0] = f;
3085b81db932SToby Isaac           neighbors[off][1] = fcells[1 - c];
3086b81db932SToby Isaac         }
3087b81db932SToby Isaac       }
3088b81db932SToby Isaac     }
308906348e87SToby Isaac   }
30909566063dSJacob Faibussowitsch   PetscCall(PetscFree(counter));
30919566063dSJacob Faibussowitsch   PetscCall(PetscMalloc3(maxNumFaces * dim, &dx, maxNumFaces * dim, &grad, maxNumFaces, &gref));
3092b81db932SToby Isaac   for (c = cStart; c < cEndInterior; c++) {
3093317218b9SToby Isaac     PetscInt         numFaces, f, d, off, ghost = -1;
3094640bce14SSatish Balay     PetscFVCellGeom *cg;
3095b81db932SToby Isaac 
30969566063dSJacob Faibussowitsch     PetscCall(DMPlexPointLocalRead(dmCell, c, cgeom, &cg));
30979566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetDof(neighSec, c, &numFaces));
30989566063dSJacob Faibussowitsch     PetscCall(PetscSectionGetOffset(neighSec, c, &off));
3099a79418b7SMatt McGurn 
3100a79418b7SMatt McGurn     // do not attempt to compute a gradient reconstruction stencil in a ghost cell.  It will never be used
31019566063dSJacob Faibussowitsch     if (ghostLabel) PetscCall(DMLabelGetValue(ghostLabel, c, &ghost));
3102a79418b7SMatt McGurn     if (ghost >= 0) continue;
3103a79418b7SMatt McGurn 
310463a3b9bcSJacob Faibussowitsch     PetscCheck(numFaces >= dim, PETSC_COMM_SELF, PETSC_ERR_ARG_INCOMP, "Cell %" PetscInt_FMT " has only %" PetscInt_FMT " faces, not enough for gradient reconstruction", c, numFaces);
3105b81db932SToby Isaac     for (f = 0; f < numFaces; ++f) {
3106640bce14SSatish Balay       PetscFVCellGeom *cg1;
3107b81db932SToby Isaac       PetscFVFaceGeom *fg;
3108b81db932SToby Isaac       const PetscInt  *fcells;
3109b81db932SToby Isaac       PetscInt         ncell, side, nface;
3110b81db932SToby Isaac 
3111b81db932SToby Isaac       nface = neighbors[off + f][0];
3112b81db932SToby Isaac       ncell = neighbors[off + f][1];
31139566063dSJacob Faibussowitsch       PetscCall(DMPlexGetSupport(dm, nface, &fcells));
3114b81db932SToby Isaac       side = (c != fcells[0]);
31159566063dSJacob Faibussowitsch       PetscCall(DMPlexPointLocalRef(dmFace, nface, fgeom, &fg));
31169566063dSJacob Faibussowitsch       PetscCall(DMPlexPointLocalRead(dmCell, ncell, cgeom, &cg1));
3117b81db932SToby Isaac       for (d = 0; d < dim; ++d) dx[f * dim + d] = cg1->centroid[d] - cg->centroid[d];
3118b81db932SToby Isaac       gref[f] = fg->grad[side]; /* Gradient reconstruction term will go here */
3119b81db932SToby Isaac     }
31209566063dSJacob Faibussowitsch     PetscCall(PetscFVComputeGradient(fvm, numFaces, dx, grad));
3121b81db932SToby Isaac     for (f = 0; f < numFaces; ++f) {
3122b81db932SToby Isaac       for (d = 0; d < dim; ++d) gref[f][d] = grad[f * dim + d];
3123b81db932SToby Isaac     }
3124b81db932SToby Isaac   }
31259566063dSJacob Faibussowitsch   PetscCall(PetscFree3(dx, grad, gref));
31269566063dSJacob Faibussowitsch   PetscCall(PetscSectionDestroy(&neighSec));
31279566063dSJacob Faibussowitsch   PetscCall(PetscFree(neighbors));
31283ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3129b81db932SToby Isaac }
3130b81db932SToby Isaac 
3131856ac710SMatthew G. Knepley /*@
3132856ac710SMatthew G. Knepley   DMPlexComputeGradientFVM - Compute geometric factors for gradient reconstruction, which are stored in the geometry data, and compute layout for gradient data
3133856ac710SMatthew G. Knepley 
313420f4b53cSBarry Smith   Collective
3135856ac710SMatthew G. Knepley 
31364165533cSJose E. Roman   Input Parameters:
313720f4b53cSBarry Smith + dm  - The `DMPLEX`
313820f4b53cSBarry Smith . fvm - The `PetscFV`
313920f4b53cSBarry Smith - cellGeometry - The face geometry from `DMPlexComputeCellGeometryFVM()`
3140856ac710SMatthew G. Knepley 
31416b867d5aSJose E. Roman   Input/Output Parameter:
314220f4b53cSBarry Smith . faceGeometry - The face geometry from `DMPlexComputeFaceGeometryFVM()`; on output
31436b867d5aSJose E. Roman                  the geometric factors for gradient calculation are inserted
31446b867d5aSJose E. Roman 
31456b867d5aSJose E. Roman   Output Parameter:
314620f4b53cSBarry Smith . dmGrad - The `DM` describing the layout of gradient data
3147856ac710SMatthew G. Knepley 
3148856ac710SMatthew G. Knepley   Level: developer
3149856ac710SMatthew G. Knepley 
315020f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexGetFaceGeometryFVM()`, `DMPlexGetCellGeometryFVM()`
3151856ac710SMatthew G. Knepley @*/
3152d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexComputeGradientFVM(DM dm, PetscFV fvm, Vec faceGeometry, Vec cellGeometry, DM *dmGrad)
3153d71ae5a4SJacob Faibussowitsch {
3154856ac710SMatthew G. Knepley   DM           dmFace, dmCell;
3155856ac710SMatthew G. Knepley   PetscScalar *fgeom, *cgeom;
3156b81db932SToby Isaac   PetscSection sectionGrad, parentSection;
3157856ac710SMatthew G. Knepley   PetscInt     dim, pdim, cStart, cEnd, cEndInterior, c;
3158856ac710SMatthew G. Knepley 
3159856ac710SMatthew G. Knepley   PetscFunctionBegin;
31609566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dim));
31619566063dSJacob Faibussowitsch   PetscCall(PetscFVGetNumComponents(fvm, &pdim));
31629566063dSJacob Faibussowitsch   PetscCall(DMPlexGetHeightStratum(dm, 0, &cStart, &cEnd));
3163*2827ebadSStefano Zampini   PetscCall(DMPlexGetCellTypeStratum(dm, DM_POLYTOPE_FV_GHOST, &cEndInterior, NULL));
3164856ac710SMatthew G. Knepley   /* Construct the interpolant corresponding to each face from the least-square solution over the cell neighborhood */
31659566063dSJacob Faibussowitsch   PetscCall(VecGetDM(faceGeometry, &dmFace));
31669566063dSJacob Faibussowitsch   PetscCall(VecGetDM(cellGeometry, &dmCell));
31679566063dSJacob Faibussowitsch   PetscCall(VecGetArray(faceGeometry, &fgeom));
31689566063dSJacob Faibussowitsch   PetscCall(VecGetArray(cellGeometry, &cgeom));
31699566063dSJacob Faibussowitsch   PetscCall(DMPlexGetTree(dm, &parentSection, NULL, NULL, NULL, NULL));
3170b81db932SToby Isaac   if (!parentSection) {
31719566063dSJacob Faibussowitsch     PetscCall(BuildGradientReconstruction_Internal(dm, fvm, dmFace, fgeom, dmCell, cgeom));
3172b5a3613cSMatthew G. Knepley   } else {
31739566063dSJacob Faibussowitsch     PetscCall(BuildGradientReconstruction_Internal_Tree(dm, fvm, dmFace, fgeom, dmCell, cgeom));
3174b81db932SToby Isaac   }
31759566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(faceGeometry, &fgeom));
31769566063dSJacob Faibussowitsch   PetscCall(VecRestoreArray(cellGeometry, &cgeom));
3177856ac710SMatthew G. Knepley   /* Create storage for gradients */
31789566063dSJacob Faibussowitsch   PetscCall(DMClone(dm, dmGrad));
31799566063dSJacob Faibussowitsch   PetscCall(PetscSectionCreate(PetscObjectComm((PetscObject)dm), &sectionGrad));
31809566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetChart(sectionGrad, cStart, cEnd));
31819566063dSJacob Faibussowitsch   for (c = cStart; c < cEnd; ++c) PetscCall(PetscSectionSetDof(sectionGrad, c, pdim * dim));
31829566063dSJacob Faibussowitsch   PetscCall(PetscSectionSetUp(sectionGrad));
31839566063dSJacob Faibussowitsch   PetscCall(DMSetLocalSection(*dmGrad, sectionGrad));
31849566063dSJacob Faibussowitsch   PetscCall(PetscSectionDestroy(&sectionGrad));
31853ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3186856ac710SMatthew G. Knepley }
3187b27d5b9eSToby Isaac 
3188c501906fSMatthew G. Knepley /*@
3189c501906fSMatthew G. Knepley   DMPlexGetDataFVM - Retrieve precomputed cell geometry
3190c501906fSMatthew G. Knepley 
319120f4b53cSBarry Smith   Collective
3192c501906fSMatthew G. Knepley 
31934165533cSJose E. Roman   Input Parameters:
319420f4b53cSBarry Smith + dm  - The `DM`
319520f4b53cSBarry Smith - fv  - The `PetscFV`
3196c501906fSMatthew G. Knepley 
3197c501906fSMatthew G. Knepley   Output Parameters:
3198c501906fSMatthew G. Knepley + cellGeometry - The cell geometry
3199c501906fSMatthew G. Knepley . faceGeometry - The face geometry
32006b867d5aSJose E. Roman - gradDM       - The gradient matrices
3201c501906fSMatthew G. Knepley 
3202c501906fSMatthew G. Knepley   Level: developer
3203c501906fSMatthew G. Knepley 
320420f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexComputeGeometryFVM()`
3205c501906fSMatthew G. Knepley @*/
3206d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexGetDataFVM(DM dm, PetscFV fv, Vec *cellgeom, Vec *facegeom, DM *gradDM)
3207d71ae5a4SJacob Faibussowitsch {
3208b27d5b9eSToby Isaac   PetscObject cellgeomobj, facegeomobj;
3209b27d5b9eSToby Isaac 
3210b27d5b9eSToby Isaac   PetscFunctionBegin;
32119566063dSJacob Faibussowitsch   PetscCall(PetscObjectQuery((PetscObject)dm, "DMPlex_cellgeom_fvm", &cellgeomobj));
3212b27d5b9eSToby Isaac   if (!cellgeomobj) {
3213b27d5b9eSToby Isaac     Vec cellgeomInt, facegeomInt;
3214b27d5b9eSToby Isaac 
32159566063dSJacob Faibussowitsch     PetscCall(DMPlexComputeGeometryFVM(dm, &cellgeomInt, &facegeomInt));
32169566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)dm, "DMPlex_cellgeom_fvm", (PetscObject)cellgeomInt));
32179566063dSJacob Faibussowitsch     PetscCall(PetscObjectCompose((PetscObject)dm, "DMPlex_facegeom_fvm", (PetscObject)facegeomInt));
32189566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&cellgeomInt));
32199566063dSJacob Faibussowitsch     PetscCall(VecDestroy(&facegeomInt));
32209566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)dm, "DMPlex_cellgeom_fvm", &cellgeomobj));
3221b27d5b9eSToby Isaac   }
32229566063dSJacob Faibussowitsch   PetscCall(PetscObjectQuery((PetscObject)dm, "DMPlex_facegeom_fvm", &facegeomobj));
3223b27d5b9eSToby Isaac   if (cellgeom) *cellgeom = (Vec)cellgeomobj;
3224b27d5b9eSToby Isaac   if (facegeom) *facegeom = (Vec)facegeomobj;
3225b27d5b9eSToby Isaac   if (gradDM) {
3226b27d5b9eSToby Isaac     PetscObject gradobj;
3227b27d5b9eSToby Isaac     PetscBool   computeGradients;
3228b27d5b9eSToby Isaac 
32299566063dSJacob Faibussowitsch     PetscCall(PetscFVGetComputeGradients(fv, &computeGradients));
3230b27d5b9eSToby Isaac     if (!computeGradients) {
3231b27d5b9eSToby Isaac       *gradDM = NULL;
32323ba16761SJacob Faibussowitsch       PetscFunctionReturn(PETSC_SUCCESS);
3233b27d5b9eSToby Isaac     }
32349566063dSJacob Faibussowitsch     PetscCall(PetscObjectQuery((PetscObject)dm, "DMPlex_dmgrad_fvm", &gradobj));
3235b27d5b9eSToby Isaac     if (!gradobj) {
3236b27d5b9eSToby Isaac       DM dmGradInt;
3237b27d5b9eSToby Isaac 
32389566063dSJacob Faibussowitsch       PetscCall(DMPlexComputeGradientFVM(dm, fv, (Vec)facegeomobj, (Vec)cellgeomobj, &dmGradInt));
32399566063dSJacob Faibussowitsch       PetscCall(PetscObjectCompose((PetscObject)dm, "DMPlex_dmgrad_fvm", (PetscObject)dmGradInt));
32409566063dSJacob Faibussowitsch       PetscCall(DMDestroy(&dmGradInt));
32419566063dSJacob Faibussowitsch       PetscCall(PetscObjectQuery((PetscObject)dm, "DMPlex_dmgrad_fvm", &gradobj));
3242b27d5b9eSToby Isaac     }
3243b27d5b9eSToby Isaac     *gradDM = (DM)gradobj;
3244b27d5b9eSToby Isaac   }
32453ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3246b27d5b9eSToby Isaac }
3247d6143a4eSToby Isaac 
3248d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCoordinatesToReference_NewtonUpdate(PetscInt dimC, PetscInt dimR, PetscScalar *J, PetscScalar *invJ, PetscScalar *work, PetscReal *resNeg, PetscReal *guess)
3249d71ae5a4SJacob Faibussowitsch {
32509d150b73SToby Isaac   PetscInt l, m;
32519d150b73SToby Isaac 
3252cd345991SToby Isaac   PetscFunctionBeginHot;
32539d150b73SToby Isaac   if (dimC == dimR && dimR <= 3) {
32549d150b73SToby Isaac     /* invert Jacobian, multiply */
32559d150b73SToby Isaac     PetscScalar det, idet;
32569d150b73SToby Isaac 
32579d150b73SToby Isaac     switch (dimR) {
3258d71ae5a4SJacob Faibussowitsch     case 1:
3259d71ae5a4SJacob Faibussowitsch       invJ[0] = 1. / J[0];
3260d71ae5a4SJacob Faibussowitsch       break;
32619d150b73SToby Isaac     case 2:
32629d150b73SToby Isaac       det     = J[0] * J[3] - J[1] * J[2];
32639d150b73SToby Isaac       idet    = 1. / det;
32649d150b73SToby Isaac       invJ[0] = J[3] * idet;
32659d150b73SToby Isaac       invJ[1] = -J[1] * idet;
32669d150b73SToby Isaac       invJ[2] = -J[2] * idet;
32679d150b73SToby Isaac       invJ[3] = J[0] * idet;
32689d150b73SToby Isaac       break;
32699371c9d4SSatish Balay     case 3: {
32709d150b73SToby Isaac       invJ[0] = J[4] * J[8] - J[5] * J[7];
32719d150b73SToby Isaac       invJ[1] = J[2] * J[7] - J[1] * J[8];
32729d150b73SToby Isaac       invJ[2] = J[1] * J[5] - J[2] * J[4];
32739d150b73SToby Isaac       det     = invJ[0] * J[0] + invJ[1] * J[3] + invJ[2] * J[6];
32749d150b73SToby Isaac       idet    = 1. / det;
32759d150b73SToby Isaac       invJ[0] *= idet;
32769d150b73SToby Isaac       invJ[1] *= idet;
32779d150b73SToby Isaac       invJ[2] *= idet;
32789d150b73SToby Isaac       invJ[3] = idet * (J[5] * J[6] - J[3] * J[8]);
32799d150b73SToby Isaac       invJ[4] = idet * (J[0] * J[8] - J[2] * J[6]);
32809d150b73SToby Isaac       invJ[5] = idet * (J[2] * J[3] - J[0] * J[5]);
32819d150b73SToby Isaac       invJ[6] = idet * (J[3] * J[7] - J[4] * J[6]);
32829d150b73SToby Isaac       invJ[7] = idet * (J[1] * J[6] - J[0] * J[7]);
32839d150b73SToby Isaac       invJ[8] = idet * (J[0] * J[4] - J[1] * J[3]);
32849371c9d4SSatish Balay     } break;
32859d150b73SToby Isaac     }
32869d150b73SToby Isaac     for (l = 0; l < dimR; l++) {
3287ad540459SPierre Jolivet       for (m = 0; m < dimC; m++) guess[l] += PetscRealPart(invJ[l * dimC + m]) * resNeg[m];
32889d150b73SToby Isaac     }
32899d150b73SToby Isaac   } else {
32909d150b73SToby Isaac #if defined(PETSC_USE_COMPLEX)
32919d150b73SToby Isaac     char transpose = 'C';
32929d150b73SToby Isaac #else
32939d150b73SToby Isaac     char transpose = 'T';
32949d150b73SToby Isaac #endif
32959d150b73SToby Isaac     PetscBLASInt m        = dimR;
32969d150b73SToby Isaac     PetscBLASInt n        = dimC;
32979d150b73SToby Isaac     PetscBLASInt one      = 1;
32989d150b73SToby Isaac     PetscBLASInt worksize = dimR * dimC, info;
32999d150b73SToby Isaac 
3300ad540459SPierre Jolivet     for (l = 0; l < dimC; l++) invJ[l] = resNeg[l];
33019d150b73SToby Isaac 
3302792fecdfSBarry Smith     PetscCallBLAS("LAPACKgels", LAPACKgels_(&transpose, &m, &n, &one, J, &m, invJ, &n, work, &worksize, &info));
330308401ef6SPierre Jolivet     PetscCheck(info == 0, PETSC_COMM_SELF, PETSC_ERR_LIB, "Bad argument to GELS");
33049d150b73SToby Isaac 
3305ad540459SPierre Jolivet     for (l = 0; l < dimR; l++) guess[l] += PetscRealPart(invJ[l]);
33069d150b73SToby Isaac   }
33073ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
33089d150b73SToby Isaac }
33099d150b73SToby Isaac 
3310d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCoordinatesToReference_Tensor(DM dm, PetscInt cell, PetscInt numPoints, const PetscReal realCoords[], PetscReal refCoords[], Vec coords, PetscInt dimC, PetscInt dimR)
3311d71ae5a4SJacob Faibussowitsch {
3312c0cbe899SToby Isaac   PetscInt     coordSize, i, j, k, l, m, maxIts = 7, numV = (1 << dimR);
33139d150b73SToby Isaac   PetscScalar *coordsScalar = NULL;
33149d150b73SToby Isaac   PetscReal   *cellData, *cellCoords, *cellCoeffs, *extJ, *resNeg;
33159d150b73SToby Isaac   PetscScalar *J, *invJ, *work;
33169d150b73SToby Isaac 
33179d150b73SToby Isaac   PetscFunctionBegin;
33189d150b73SToby Isaac   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
33199566063dSJacob Faibussowitsch   PetscCall(DMPlexVecGetClosure(dm, NULL, coords, cell, &coordSize, &coordsScalar));
33201dca8a05SBarry Smith   PetscCheck(coordSize >= dimC * numV, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Expecting at least %" PetscInt_FMT " coordinates, got %" PetscInt_FMT, dimC * (1 << dimR), coordSize);
33219566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, 2 * coordSize + dimR + dimC, MPIU_REAL, &cellData));
33229566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, 3 * dimR * dimC, MPIU_SCALAR, &J));
33239d150b73SToby Isaac   cellCoords = &cellData[0];
33249d150b73SToby Isaac   cellCoeffs = &cellData[coordSize];
33259d150b73SToby Isaac   extJ       = &cellData[2 * coordSize];
33269d150b73SToby Isaac   resNeg     = &cellData[2 * coordSize + dimR];
33279d150b73SToby Isaac   invJ       = &J[dimR * dimC];
33289d150b73SToby Isaac   work       = &J[2 * dimR * dimC];
33299d150b73SToby Isaac   if (dimR == 2) {
33309d150b73SToby Isaac     const PetscInt zToPlex[4] = {0, 1, 3, 2};
33319d150b73SToby Isaac 
33329d150b73SToby Isaac     for (i = 0; i < 4; i++) {
33339d150b73SToby Isaac       PetscInt plexI = zToPlex[i];
33349d150b73SToby Isaac 
3335ad540459SPierre Jolivet       for (j = 0; j < dimC; j++) cellCoords[dimC * i + j] = PetscRealPart(coordsScalar[dimC * plexI + j]);
33369d150b73SToby Isaac     }
33379d150b73SToby Isaac   } else if (dimR == 3) {
33389d150b73SToby Isaac     const PetscInt zToPlex[8] = {0, 3, 1, 2, 4, 5, 7, 6};
33399d150b73SToby Isaac 
33409d150b73SToby Isaac     for (i = 0; i < 8; i++) {
33419d150b73SToby Isaac       PetscInt plexI = zToPlex[i];
33429d150b73SToby Isaac 
3343ad540459SPierre Jolivet       for (j = 0; j < dimC; j++) cellCoords[dimC * i + j] = PetscRealPart(coordsScalar[dimC * plexI + j]);
33449d150b73SToby Isaac     }
33459d150b73SToby Isaac   } else {
3346ad540459SPierre Jolivet     for (i = 0; i < coordSize; i++) cellCoords[i] = PetscRealPart(coordsScalar[i]);
33479d150b73SToby Isaac   }
33489d150b73SToby Isaac   /* Perform the shuffling transform that converts values at the corners of [-1,1]^d to coefficients */
33499d150b73SToby Isaac   for (i = 0; i < dimR; i++) {
33509d150b73SToby Isaac     PetscReal *swap;
33519d150b73SToby Isaac 
33529d150b73SToby Isaac     for (j = 0; j < (numV / 2); j++) {
33539d150b73SToby Isaac       for (k = 0; k < dimC; k++) {
33549d150b73SToby Isaac         cellCoeffs[dimC * j + k]                = 0.5 * (cellCoords[dimC * (2 * j + 1) + k] + cellCoords[dimC * 2 * j + k]);
33559d150b73SToby Isaac         cellCoeffs[dimC * (j + (numV / 2)) + k] = 0.5 * (cellCoords[dimC * (2 * j + 1) + k] - cellCoords[dimC * 2 * j + k]);
33569d150b73SToby Isaac       }
33579d150b73SToby Isaac     }
33589d150b73SToby Isaac 
33599d150b73SToby Isaac     if (i < dimR - 1) {
33609d150b73SToby Isaac       swap       = cellCoeffs;
33619d150b73SToby Isaac       cellCoeffs = cellCoords;
33629d150b73SToby Isaac       cellCoords = swap;
33639d150b73SToby Isaac     }
33649d150b73SToby Isaac   }
33659566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(refCoords, numPoints * dimR));
33669d150b73SToby Isaac   for (j = 0; j < numPoints; j++) {
33679d150b73SToby Isaac     for (i = 0; i < maxIts; i++) {
33689d150b73SToby Isaac       PetscReal *guess = &refCoords[dimR * j];
33699d150b73SToby Isaac 
33709d150b73SToby Isaac       /* compute -residual and Jacobian */
3371ad540459SPierre Jolivet       for (k = 0; k < dimC; k++) resNeg[k] = realCoords[dimC * j + k];
3372ad540459SPierre Jolivet       for (k = 0; k < dimC * dimR; k++) J[k] = 0.;
33739d150b73SToby Isaac       for (k = 0; k < numV; k++) {
33749d150b73SToby Isaac         PetscReal extCoord = 1.;
33759d150b73SToby Isaac         for (l = 0; l < dimR; l++) {
33769d150b73SToby Isaac           PetscReal coord = guess[l];
33779d150b73SToby Isaac           PetscInt  dep   = (k & (1 << l)) >> l;
33789d150b73SToby Isaac 
33799d150b73SToby Isaac           extCoord *= dep * coord + !dep;
33809d150b73SToby Isaac           extJ[l] = dep;
33819d150b73SToby Isaac 
33829d150b73SToby Isaac           for (m = 0; m < dimR; m++) {
33839d150b73SToby Isaac             PetscReal coord = guess[m];
33849d150b73SToby Isaac             PetscInt  dep   = ((k & (1 << m)) >> m) && (m != l);
33859d150b73SToby Isaac             PetscReal mult  = dep * coord + !dep;
33869d150b73SToby Isaac 
33879d150b73SToby Isaac             extJ[l] *= mult;
33889d150b73SToby Isaac           }
33899d150b73SToby Isaac         }
33909d150b73SToby Isaac         for (l = 0; l < dimC; l++) {
33919d150b73SToby Isaac           PetscReal coeff = cellCoeffs[dimC * k + l];
33929d150b73SToby Isaac 
33939d150b73SToby Isaac           resNeg[l] -= coeff * extCoord;
3394ad540459SPierre Jolivet           for (m = 0; m < dimR; m++) J[dimR * l + m] += coeff * extJ[m];
33959d150b73SToby Isaac         }
33969d150b73SToby Isaac       }
339776bd3646SJed Brown       if (0 && PetscDefined(USE_DEBUG)) {
33980611203eSToby Isaac         PetscReal maxAbs = 0.;
33990611203eSToby Isaac 
3400ad540459SPierre Jolivet         for (l = 0; l < dimC; l++) maxAbs = PetscMax(maxAbs, PetscAbsReal(resNeg[l]));
340163a3b9bcSJacob Faibussowitsch         PetscCall(PetscInfo(dm, "cell %" PetscInt_FMT ", point %" PetscInt_FMT ", iter %" PetscInt_FMT ": res %g\n", cell, j, i, (double)maxAbs));
34020611203eSToby Isaac       }
34039d150b73SToby Isaac 
34049566063dSJacob Faibussowitsch       PetscCall(DMPlexCoordinatesToReference_NewtonUpdate(dimC, dimR, J, invJ, work, resNeg, guess));
34059d150b73SToby Isaac     }
34069d150b73SToby Isaac   }
34079566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, 3 * dimR * dimC, MPIU_SCALAR, &J));
34089566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, 2 * coordSize + dimR + dimC, MPIU_REAL, &cellData));
34099566063dSJacob Faibussowitsch   PetscCall(DMPlexVecRestoreClosure(dm, NULL, coords, cell, &coordSize, &coordsScalar));
34103ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
34119d150b73SToby Isaac }
34129d150b73SToby Isaac 
3413d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexReferenceToCoordinates_Tensor(DM dm, PetscInt cell, PetscInt numPoints, const PetscReal refCoords[], PetscReal realCoords[], Vec coords, PetscInt dimC, PetscInt dimR)
3414d71ae5a4SJacob Faibussowitsch {
34159d150b73SToby Isaac   PetscInt     coordSize, i, j, k, l, numV = (1 << dimR);
34169d150b73SToby Isaac   PetscScalar *coordsScalar = NULL;
34179d150b73SToby Isaac   PetscReal   *cellData, *cellCoords, *cellCoeffs;
34189d150b73SToby Isaac 
34199d150b73SToby Isaac   PetscFunctionBegin;
34209d150b73SToby Isaac   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
34219566063dSJacob Faibussowitsch   PetscCall(DMPlexVecGetClosure(dm, NULL, coords, cell, &coordSize, &coordsScalar));
34221dca8a05SBarry Smith   PetscCheck(coordSize >= dimC * numV, PETSC_COMM_SELF, PETSC_ERR_PLIB, "Expecting at least %" PetscInt_FMT " coordinates, got %" PetscInt_FMT, dimC * (1 << dimR), coordSize);
34239566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, 2 * coordSize, MPIU_REAL, &cellData));
34249d150b73SToby Isaac   cellCoords = &cellData[0];
34259d150b73SToby Isaac   cellCoeffs = &cellData[coordSize];
34269d150b73SToby Isaac   if (dimR == 2) {
34279d150b73SToby Isaac     const PetscInt zToPlex[4] = {0, 1, 3, 2};
34289d150b73SToby Isaac 
34299d150b73SToby Isaac     for (i = 0; i < 4; i++) {
34309d150b73SToby Isaac       PetscInt plexI = zToPlex[i];
34319d150b73SToby Isaac 
3432ad540459SPierre Jolivet       for (j = 0; j < dimC; j++) cellCoords[dimC * i + j] = PetscRealPart(coordsScalar[dimC * plexI + j]);
34339d150b73SToby Isaac     }
34349d150b73SToby Isaac   } else if (dimR == 3) {
34359d150b73SToby Isaac     const PetscInt zToPlex[8] = {0, 3, 1, 2, 4, 5, 7, 6};
34369d150b73SToby Isaac 
34379d150b73SToby Isaac     for (i = 0; i < 8; i++) {
34389d150b73SToby Isaac       PetscInt plexI = zToPlex[i];
34399d150b73SToby Isaac 
3440ad540459SPierre Jolivet       for (j = 0; j < dimC; j++) cellCoords[dimC * i + j] = PetscRealPart(coordsScalar[dimC * plexI + j]);
34419d150b73SToby Isaac     }
34429d150b73SToby Isaac   } else {
3443ad540459SPierre Jolivet     for (i = 0; i < coordSize; i++) cellCoords[i] = PetscRealPart(coordsScalar[i]);
34449d150b73SToby Isaac   }
34459d150b73SToby Isaac   /* Perform the shuffling transform that converts values at the corners of [-1,1]^d to coefficients */
34469d150b73SToby Isaac   for (i = 0; i < dimR; i++) {
34479d150b73SToby Isaac     PetscReal *swap;
34489d150b73SToby Isaac 
34499d150b73SToby Isaac     for (j = 0; j < (numV / 2); j++) {
34509d150b73SToby Isaac       for (k = 0; k < dimC; k++) {
34519d150b73SToby Isaac         cellCoeffs[dimC * j + k]                = 0.5 * (cellCoords[dimC * (2 * j + 1) + k] + cellCoords[dimC * 2 * j + k]);
34529d150b73SToby Isaac         cellCoeffs[dimC * (j + (numV / 2)) + k] = 0.5 * (cellCoords[dimC * (2 * j + 1) + k] - cellCoords[dimC * 2 * j + k]);
34539d150b73SToby Isaac       }
34549d150b73SToby Isaac     }
34559d150b73SToby Isaac 
34569d150b73SToby Isaac     if (i < dimR - 1) {
34579d150b73SToby Isaac       swap       = cellCoeffs;
34589d150b73SToby Isaac       cellCoeffs = cellCoords;
34599d150b73SToby Isaac       cellCoords = swap;
34609d150b73SToby Isaac     }
34619d150b73SToby Isaac   }
34629566063dSJacob Faibussowitsch   PetscCall(PetscArrayzero(realCoords, numPoints * dimC));
34639d150b73SToby Isaac   for (j = 0; j < numPoints; j++) {
34649d150b73SToby Isaac     const PetscReal *guess  = &refCoords[dimR * j];
34659d150b73SToby Isaac     PetscReal       *mapped = &realCoords[dimC * j];
34669d150b73SToby Isaac 
34679d150b73SToby Isaac     for (k = 0; k < numV; k++) {
34689d150b73SToby Isaac       PetscReal extCoord = 1.;
34699d150b73SToby Isaac       for (l = 0; l < dimR; l++) {
34709d150b73SToby Isaac         PetscReal coord = guess[l];
34719d150b73SToby Isaac         PetscInt  dep   = (k & (1 << l)) >> l;
34729d150b73SToby Isaac 
34739d150b73SToby Isaac         extCoord *= dep * coord + !dep;
34749d150b73SToby Isaac       }
34759d150b73SToby Isaac       for (l = 0; l < dimC; l++) {
34769d150b73SToby Isaac         PetscReal coeff = cellCoeffs[dimC * k + l];
34779d150b73SToby Isaac 
34789d150b73SToby Isaac         mapped[l] += coeff * extCoord;
34799d150b73SToby Isaac       }
34809d150b73SToby Isaac     }
34819d150b73SToby Isaac   }
34829566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, 2 * coordSize, MPIU_REAL, &cellData));
34839566063dSJacob Faibussowitsch   PetscCall(DMPlexVecRestoreClosure(dm, NULL, coords, cell, &coordSize, &coordsScalar));
34843ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
34859d150b73SToby Isaac }
34869d150b73SToby Isaac 
34879c3cf19fSMatthew G. Knepley /* TODO: TOBY please fix this for Nc > 1 */
3488d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexCoordinatesToReference_FE(DM dm, PetscFE fe, PetscInt cell, PetscInt numPoints, const PetscReal realCoords[], PetscReal refCoords[], Vec coords, PetscInt Nc, PetscInt dimR)
3489d71ae5a4SJacob Faibussowitsch {
34909c3cf19fSMatthew G. Knepley   PetscInt     numComp, pdim, i, j, k, l, m, maxIter = 7, coordSize;
3491c6e120d1SToby Isaac   PetscScalar *nodes = NULL;
3492c6e120d1SToby Isaac   PetscReal   *invV, *modes;
3493c6e120d1SToby Isaac   PetscReal   *B, *D, *resNeg;
3494c6e120d1SToby Isaac   PetscScalar *J, *invJ, *work;
34959d150b73SToby Isaac 
34969d150b73SToby Isaac   PetscFunctionBegin;
34979566063dSJacob Faibussowitsch   PetscCall(PetscFEGetDimension(fe, &pdim));
34989566063dSJacob Faibussowitsch   PetscCall(PetscFEGetNumComponents(fe, &numComp));
349963a3b9bcSJacob Faibussowitsch   PetscCheck(numComp == Nc, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "coordinate discretization must have as many components (%" PetscInt_FMT ") as embedding dimension (!= %" PetscInt_FMT ")", numComp, Nc);
35009566063dSJacob Faibussowitsch   PetscCall(DMPlexVecGetClosure(dm, NULL, coords, cell, &coordSize, &nodes));
35019d150b73SToby Isaac   /* convert nodes to values in the stable evaluation basis */
35029566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, pdim, MPIU_REAL, &modes));
35039d150b73SToby Isaac   invV = fe->invV;
3504012b7cc6SMatthew G. Knepley   for (i = 0; i < pdim; ++i) {
3505012b7cc6SMatthew G. Knepley     modes[i] = 0.;
3506ad540459SPierre Jolivet     for (j = 0; j < pdim; ++j) modes[i] += invV[i * pdim + j] * PetscRealPart(nodes[j]);
35079d150b73SToby Isaac   }
35089566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, pdim * Nc + pdim * Nc * dimR + Nc, MPIU_REAL, &B));
35099c3cf19fSMatthew G. Knepley   D      = &B[pdim * Nc];
35109c3cf19fSMatthew G. Knepley   resNeg = &D[pdim * Nc * dimR];
35119566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, 3 * Nc * dimR, MPIU_SCALAR, &J));
35129c3cf19fSMatthew G. Knepley   invJ = &J[Nc * dimR];
35139c3cf19fSMatthew G. Knepley   work = &invJ[Nc * dimR];
3514ad540459SPierre Jolivet   for (i = 0; i < numPoints * dimR; i++) refCoords[i] = 0.;
35159d150b73SToby Isaac   for (j = 0; j < numPoints; j++) {
35169b1f03cbSToby Isaac     for (i = 0; i < maxIter; i++) { /* we could batch this so that we're not making big B and D arrays all the time */
35179d150b73SToby Isaac       PetscReal *guess = &refCoords[j * dimR];
35189566063dSJacob Faibussowitsch       PetscCall(PetscSpaceEvaluate(fe->basisSpace, 1, guess, B, D, NULL));
3519ad540459SPierre Jolivet       for (k = 0; k < Nc; k++) resNeg[k] = realCoords[j * Nc + k];
3520ad540459SPierre Jolivet       for (k = 0; k < Nc * dimR; k++) J[k] = 0.;
35219c3cf19fSMatthew G. Knepley       for (k = 0; k < pdim; k++) {
35229c3cf19fSMatthew G. Knepley         for (l = 0; l < Nc; l++) {
3523012b7cc6SMatthew G. Knepley           resNeg[l] -= modes[k] * B[k * Nc + l];
3524ad540459SPierre Jolivet           for (m = 0; m < dimR; m++) J[l * dimR + m] += modes[k] * D[(k * Nc + l) * dimR + m];
35259d150b73SToby Isaac         }
35269d150b73SToby Isaac       }
352776bd3646SJed Brown       if (0 && PetscDefined(USE_DEBUG)) {
35280611203eSToby Isaac         PetscReal maxAbs = 0.;
35290611203eSToby Isaac 
3530ad540459SPierre Jolivet         for (l = 0; l < Nc; l++) maxAbs = PetscMax(maxAbs, PetscAbsReal(resNeg[l]));
353163a3b9bcSJacob Faibussowitsch         PetscCall(PetscInfo(dm, "cell %" PetscInt_FMT ", point %" PetscInt_FMT ", iter %" PetscInt_FMT ": res %g\n", cell, j, i, (double)maxAbs));
35320611203eSToby Isaac       }
35339566063dSJacob Faibussowitsch       PetscCall(DMPlexCoordinatesToReference_NewtonUpdate(Nc, dimR, J, invJ, work, resNeg, guess));
35349d150b73SToby Isaac     }
35359d150b73SToby Isaac   }
35369566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, 3 * Nc * dimR, MPIU_SCALAR, &J));
35379566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, pdim * Nc + pdim * Nc * dimR + Nc, MPIU_REAL, &B));
35389566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, pdim, MPIU_REAL, &modes));
35399566063dSJacob Faibussowitsch   PetscCall(DMPlexVecRestoreClosure(dm, NULL, coords, cell, &coordSize, &nodes));
35403ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
35419d150b73SToby Isaac }
35429d150b73SToby Isaac 
35439c3cf19fSMatthew G. Knepley /* TODO: TOBY please fix this for Nc > 1 */
3544d71ae5a4SJacob Faibussowitsch static PetscErrorCode DMPlexReferenceToCoordinates_FE(DM dm, PetscFE fe, PetscInt cell, PetscInt numPoints, const PetscReal refCoords[], PetscReal realCoords[], Vec coords, PetscInt Nc, PetscInt dimR)
3545d71ae5a4SJacob Faibussowitsch {
35469c3cf19fSMatthew G. Knepley   PetscInt     numComp, pdim, i, j, k, l, coordSize;
3547c6e120d1SToby Isaac   PetscScalar *nodes = NULL;
3548c6e120d1SToby Isaac   PetscReal   *invV, *modes;
35499d150b73SToby Isaac   PetscReal   *B;
35509d150b73SToby Isaac 
35519d150b73SToby Isaac   PetscFunctionBegin;
35529566063dSJacob Faibussowitsch   PetscCall(PetscFEGetDimension(fe, &pdim));
35539566063dSJacob Faibussowitsch   PetscCall(PetscFEGetNumComponents(fe, &numComp));
355463a3b9bcSJacob Faibussowitsch   PetscCheck(numComp == Nc, PetscObjectComm((PetscObject)dm), PETSC_ERR_SUP, "coordinate discretization must have as many components (%" PetscInt_FMT ") as embedding dimension (!= %" PetscInt_FMT ")", numComp, Nc);
35559566063dSJacob Faibussowitsch   PetscCall(DMPlexVecGetClosure(dm, NULL, coords, cell, &coordSize, &nodes));
35569d150b73SToby Isaac   /* convert nodes to values in the stable evaluation basis */
35579566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, pdim, MPIU_REAL, &modes));
35589d150b73SToby Isaac   invV = fe->invV;
3559012b7cc6SMatthew G. Knepley   for (i = 0; i < pdim; ++i) {
3560012b7cc6SMatthew G. Knepley     modes[i] = 0.;
3561ad540459SPierre Jolivet     for (j = 0; j < pdim; ++j) modes[i] += invV[i * pdim + j] * PetscRealPart(nodes[j]);
35629d150b73SToby Isaac   }
35639566063dSJacob Faibussowitsch   PetscCall(DMGetWorkArray(dm, numPoints * pdim * Nc, MPIU_REAL, &B));
35649566063dSJacob Faibussowitsch   PetscCall(PetscSpaceEvaluate(fe->basisSpace, numPoints, refCoords, B, NULL, NULL));
3565ad540459SPierre Jolivet   for (i = 0; i < numPoints * Nc; i++) realCoords[i] = 0.;
35669d150b73SToby Isaac   for (j = 0; j < numPoints; j++) {
35679c3cf19fSMatthew G. Knepley     PetscReal *mapped = &realCoords[j * Nc];
35689d150b73SToby Isaac 
35699c3cf19fSMatthew G. Knepley     for (k = 0; k < pdim; k++) {
3570ad540459SPierre Jolivet       for (l = 0; l < Nc; l++) mapped[l] += modes[k] * B[(j * pdim + k) * Nc + l];
35719d150b73SToby Isaac     }
35729d150b73SToby Isaac   }
35739566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, numPoints * pdim * Nc, MPIU_REAL, &B));
35749566063dSJacob Faibussowitsch   PetscCall(DMRestoreWorkArray(dm, pdim, MPIU_REAL, &modes));
35759566063dSJacob Faibussowitsch   PetscCall(DMPlexVecRestoreClosure(dm, NULL, coords, cell, &coordSize, &nodes));
35763ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
35779d150b73SToby Isaac }
35789d150b73SToby Isaac 
3579d6143a4eSToby Isaac /*@
3580d6143a4eSToby Isaac   DMPlexCoordinatesToReference - Pull coordinates back from the mesh to the reference element using a single element
3581d6143a4eSToby Isaac   map.  This inversion will be accurate inside the reference element, but may be inaccurate for mappings that do not
3582d6143a4eSToby Isaac   extend uniquely outside the reference cell (e.g, most non-affine maps)
3583d6143a4eSToby Isaac 
358420f4b53cSBarry Smith   Not Collective
3585d6143a4eSToby Isaac 
3586d6143a4eSToby Isaac   Input Parameters:
358720f4b53cSBarry Smith + dm         - The mesh, with coordinate maps defined either by a `PetscDS` for the coordinate `DM` (see `DMGetCoordinateDM()`) or
3588d6143a4eSToby Isaac                implicitly by the coordinates of the corner vertices of the cell: as an affine map for simplicial elements, or
3589d6143a4eSToby Isaac                as a multilinear map for tensor-product elements
3590d6143a4eSToby Isaac . cell       - the cell whose map is used.
3591d6143a4eSToby Isaac . numPoints  - the number of points to locate
359220f4b53cSBarry Smith - realCoords - (numPoints x coordinate dimension) array of coordinates (see `DMGetCoordinateDim()`)
3593d6143a4eSToby Isaac 
35942fe279fdSBarry Smith   Output Parameter:
359520f4b53cSBarry Smith . refCoords  - (`numPoints` x `dimension`) array of reference coordinates (see `DMGetDimension()`)
35961b266c99SBarry Smith 
35971b266c99SBarry Smith   Level: intermediate
359873c9229bSMatthew Knepley 
359920f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexReferenceToCoordinates()`
3600d6143a4eSToby Isaac @*/
3601d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexCoordinatesToReference(DM dm, PetscInt cell, PetscInt numPoints, const PetscReal realCoords[], PetscReal refCoords[])
3602d71ae5a4SJacob Faibussowitsch {
3603485ad865SMatthew G. Knepley   PetscInt dimC, dimR, depth, cStart, cEnd, i;
36049d150b73SToby Isaac   DM       coordDM = NULL;
36059d150b73SToby Isaac   Vec      coords;
36069d150b73SToby Isaac   PetscFE  fe = NULL;
36079d150b73SToby Isaac 
3608d6143a4eSToby Isaac   PetscFunctionBegin;
36099d150b73SToby Isaac   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
36109566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dimR));
36119566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimC));
36123ba16761SJacob Faibussowitsch   if (dimR <= 0 || dimC <= 0 || numPoints <= 0) PetscFunctionReturn(PETSC_SUCCESS);
36139566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
36149566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &coords));
36159566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &coordDM));
36169d150b73SToby Isaac   if (coordDM) {
36179d150b73SToby Isaac     PetscInt coordFields;
36189d150b73SToby Isaac 
36199566063dSJacob Faibussowitsch     PetscCall(DMGetNumFields(coordDM, &coordFields));
36209d150b73SToby Isaac     if (coordFields) {
36219d150b73SToby Isaac       PetscClassId id;
36229d150b73SToby Isaac       PetscObject  disc;
36239d150b73SToby Isaac 
36249566063dSJacob Faibussowitsch       PetscCall(DMGetField(coordDM, 0, NULL, &disc));
36259566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(disc, &id));
3626ad540459SPierre Jolivet       if (id == PETSCFE_CLASSID) fe = (PetscFE)disc;
36279d150b73SToby Isaac     }
36289d150b73SToby Isaac   }
36299566063dSJacob Faibussowitsch   PetscCall(DMPlexGetSimplexOrBoxCells(dm, 0, &cStart, &cEnd));
36301dca8a05SBarry Smith   PetscCheck(cell >= cStart && cell < cEnd, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "point %" PetscInt_FMT " not in cell range [%" PetscInt_FMT ",%" PetscInt_FMT ")", cell, cStart, cEnd);
36319d150b73SToby Isaac   if (!fe) { /* implicit discretization: affine or multilinear */
36329d150b73SToby Isaac     PetscInt  coneSize;
36339d150b73SToby Isaac     PetscBool isSimplex, isTensor;
36349d150b73SToby Isaac 
36359566063dSJacob Faibussowitsch     PetscCall(DMPlexGetConeSize(dm, cell, &coneSize));
36369d150b73SToby Isaac     isSimplex = (coneSize == (dimR + 1)) ? PETSC_TRUE : PETSC_FALSE;
36379d150b73SToby Isaac     isTensor  = (coneSize == ((depth == 1) ? (1 << dimR) : (2 * dimR))) ? PETSC_TRUE : PETSC_FALSE;
36389d150b73SToby Isaac     if (isSimplex) {
36399d150b73SToby Isaac       PetscReal detJ, *v0, *J, *invJ;
36409d150b73SToby Isaac 
36419566063dSJacob Faibussowitsch       PetscCall(DMGetWorkArray(dm, dimC + 2 * dimC * dimC, MPIU_REAL, &v0));
36429d150b73SToby Isaac       J    = &v0[dimC];
36439d150b73SToby Isaac       invJ = &J[dimC * dimC];
36449566063dSJacob Faibussowitsch       PetscCall(DMPlexComputeCellGeometryAffineFEM(dm, cell, v0, J, invJ, &detJ));
36459d150b73SToby Isaac       for (i = 0; i < numPoints; i++) { /* Apply the inverse affine transformation for each point */
3646c330f8ffSToby Isaac         const PetscReal x0[3] = {-1., -1., -1.};
3647c330f8ffSToby Isaac 
3648c330f8ffSToby Isaac         CoordinatesRealToRef(dimC, dimR, x0, v0, invJ, &realCoords[dimC * i], &refCoords[dimR * i]);
36499d150b73SToby Isaac       }
36509566063dSJacob Faibussowitsch       PetscCall(DMRestoreWorkArray(dm, dimC + 2 * dimC * dimC, MPIU_REAL, &v0));
36519d150b73SToby Isaac     } else if (isTensor) {
36529566063dSJacob Faibussowitsch       PetscCall(DMPlexCoordinatesToReference_Tensor(coordDM, cell, numPoints, realCoords, refCoords, coords, dimC, dimR));
365363a3b9bcSJacob Faibussowitsch     } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unrecognized cone size %" PetscInt_FMT, coneSize);
36549d150b73SToby Isaac   } else {
36559566063dSJacob Faibussowitsch     PetscCall(DMPlexCoordinatesToReference_FE(coordDM, fe, cell, numPoints, realCoords, refCoords, coords, dimC, dimR));
36569d150b73SToby Isaac   }
36573ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
36589d150b73SToby Isaac }
36599d150b73SToby Isaac 
36609d150b73SToby Isaac /*@
36619d150b73SToby Isaac   DMPlexReferenceToCoordinates - Map references coordinates to coordinates in the the mesh for a single element map.
36629d150b73SToby Isaac 
366320f4b53cSBarry Smith   Not Collective
36649d150b73SToby Isaac 
36659d150b73SToby Isaac   Input Parameters:
36662fe279fdSBarry Smith + dm         - The mesh, with coordinate maps defined either by a PetscDS for the coordinate `DM` (see `DMGetCoordinateDM()`) or
36679d150b73SToby Isaac                implicitly by the coordinates of the corner vertices of the cell: as an affine map for simplicial elements, or
36689d150b73SToby Isaac                as a multilinear map for tensor-product elements
36699d150b73SToby Isaac . cell       - the cell whose map is used.
36709d150b73SToby Isaac . numPoints  - the number of points to locate
36712fe279fdSBarry Smith - refCoords  - (numPoints x dimension) array of reference coordinates (see `DMGetDimension()`)
36729d150b73SToby Isaac 
36732fe279fdSBarry Smith   Output Parameter:
36742fe279fdSBarry Smith . realCoords - (numPoints x coordinate dimension) array of coordinates (see `DMGetCoordinateDim()`)
36751b266c99SBarry Smith 
36761b266c99SBarry Smith    Level: intermediate
367773c9229bSMatthew Knepley 
36782fe279fdSBarry Smith .seealso: `DMPLEX`, `DMPlexCoordinatesToReference()`
36799d150b73SToby Isaac @*/
3680d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexReferenceToCoordinates(DM dm, PetscInt cell, PetscInt numPoints, const PetscReal refCoords[], PetscReal realCoords[])
3681d71ae5a4SJacob Faibussowitsch {
3682485ad865SMatthew G. Knepley   PetscInt dimC, dimR, depth, cStart, cEnd, i;
36839d150b73SToby Isaac   DM       coordDM = NULL;
36849d150b73SToby Isaac   Vec      coords;
36859d150b73SToby Isaac   PetscFE  fe = NULL;
36869d150b73SToby Isaac 
36879d150b73SToby Isaac   PetscFunctionBegin;
36889d150b73SToby Isaac   PetscValidHeaderSpecific(dm, DM_CLASSID, 1);
36899566063dSJacob Faibussowitsch   PetscCall(DMGetDimension(dm, &dimR));
36909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dimC));
36913ba16761SJacob Faibussowitsch   if (dimR <= 0 || dimC <= 0 || numPoints <= 0) PetscFunctionReturn(PETSC_SUCCESS);
36929566063dSJacob Faibussowitsch   PetscCall(DMPlexGetDepth(dm, &depth));
36939566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &coords));
36949566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &coordDM));
36959d150b73SToby Isaac   if (coordDM) {
36969d150b73SToby Isaac     PetscInt coordFields;
36979d150b73SToby Isaac 
36989566063dSJacob Faibussowitsch     PetscCall(DMGetNumFields(coordDM, &coordFields));
36999d150b73SToby Isaac     if (coordFields) {
37009d150b73SToby Isaac       PetscClassId id;
37019d150b73SToby Isaac       PetscObject  disc;
37029d150b73SToby Isaac 
37039566063dSJacob Faibussowitsch       PetscCall(DMGetField(coordDM, 0, NULL, &disc));
37049566063dSJacob Faibussowitsch       PetscCall(PetscObjectGetClassId(disc, &id));
3705ad540459SPierre Jolivet       if (id == PETSCFE_CLASSID) fe = (PetscFE)disc;
37069d150b73SToby Isaac     }
37079d150b73SToby Isaac   }
37089566063dSJacob Faibussowitsch   PetscCall(DMPlexGetSimplexOrBoxCells(dm, 0, &cStart, &cEnd));
37091dca8a05SBarry Smith   PetscCheck(cell >= cStart && cell < cEnd, PETSC_COMM_SELF, PETSC_ERR_ARG_OUTOFRANGE, "point %" PetscInt_FMT " not in cell range [%" PetscInt_FMT ",%" PetscInt_FMT ")", cell, cStart, cEnd);
37109d150b73SToby Isaac   if (!fe) { /* implicit discretization: affine or multilinear */
37119d150b73SToby Isaac     PetscInt  coneSize;
37129d150b73SToby Isaac     PetscBool isSimplex, isTensor;
37139d150b73SToby Isaac 
37149566063dSJacob Faibussowitsch     PetscCall(DMPlexGetConeSize(dm, cell, &coneSize));
37159d150b73SToby Isaac     isSimplex = (coneSize == (dimR + 1)) ? PETSC_TRUE : PETSC_FALSE;
37169d150b73SToby Isaac     isTensor  = (coneSize == ((depth == 1) ? (1 << dimR) : (2 * dimR))) ? PETSC_TRUE : PETSC_FALSE;
37179d150b73SToby Isaac     if (isSimplex) {
37189d150b73SToby Isaac       PetscReal detJ, *v0, *J;
37199d150b73SToby Isaac 
37209566063dSJacob Faibussowitsch       PetscCall(DMGetWorkArray(dm, dimC + 2 * dimC * dimC, MPIU_REAL, &v0));
37219d150b73SToby Isaac       J = &v0[dimC];
37229566063dSJacob Faibussowitsch       PetscCall(DMPlexComputeCellGeometryAffineFEM(dm, cell, v0, J, NULL, &detJ));
3723c330f8ffSToby Isaac       for (i = 0; i < numPoints; i++) { /* Apply the affine transformation for each point */
3724c330f8ffSToby Isaac         const PetscReal xi0[3] = {-1., -1., -1.};
3725c330f8ffSToby Isaac 
3726c330f8ffSToby Isaac         CoordinatesRefToReal(dimC, dimR, xi0, v0, J, &refCoords[dimR * i], &realCoords[dimC * i]);
37279d150b73SToby Isaac       }
37289566063dSJacob Faibussowitsch       PetscCall(DMRestoreWorkArray(dm, dimC + 2 * dimC * dimC, MPIU_REAL, &v0));
37299d150b73SToby Isaac     } else if (isTensor) {
37309566063dSJacob Faibussowitsch       PetscCall(DMPlexReferenceToCoordinates_Tensor(coordDM, cell, numPoints, refCoords, realCoords, coords, dimC, dimR));
373163a3b9bcSJacob Faibussowitsch     } else SETERRQ(PETSC_COMM_SELF, PETSC_ERR_SUP, "Unrecognized cone size %" PetscInt_FMT, coneSize);
37329d150b73SToby Isaac   } else {
37339566063dSJacob Faibussowitsch     PetscCall(DMPlexReferenceToCoordinates_FE(coordDM, fe, cell, numPoints, refCoords, realCoords, coords, dimC, dimR));
37349d150b73SToby Isaac   }
37353ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
3736d6143a4eSToby Isaac }
37370139fca9SMatthew G. Knepley 
37380139fca9SMatthew G. Knepley /*@C
37392fe279fdSBarry Smith   DMPlexRemapGeometry - This function maps the original `DM` coordinates to new coordinates.
37400139fca9SMatthew G. Knepley 
374120f4b53cSBarry Smith   Not Collective
37420139fca9SMatthew G. Knepley 
37430139fca9SMatthew G. Knepley   Input Parameters:
37442fe279fdSBarry Smith + dm      - The `DM`
37450139fca9SMatthew G. Knepley . time    - The time
37460139fca9SMatthew G. Knepley - func    - The function transforming current coordinates to new coordaintes
37470139fca9SMatthew G. Knepley 
374820f4b53cSBarry Smith    Calling sequence of `func`:
374920f4b53cSBarry Smith .vb
375020f4b53cSBarry Smith    void func(PetscInt dim, PetscInt Nf, PetscInt NfAux,
375120f4b53cSBarry Smith              const PetscInt uOff[], const PetscInt uOff_x[], const PetscScalar u[], const PetscScalar u_t[], const PetscScalar u_x[],
375220f4b53cSBarry Smith              const PetscInt aOff[], const PetscInt aOff_x[], const PetscScalar a[], const PetscScalar a_t[], const PetscScalar a_x[],
375320f4b53cSBarry Smith              PetscReal t, const PetscReal x[], PetscInt numConstants, const PetscScalar constants[], PetscScalar f[]);
375420f4b53cSBarry Smith .ve
37550139fca9SMatthew G. Knepley +  dim          - The spatial dimension
37560139fca9SMatthew G. Knepley .  Nf           - The number of input fields (here 1)
37570139fca9SMatthew G. Knepley .  NfAux        - The number of input auxiliary fields
37580139fca9SMatthew G. Knepley .  uOff         - The offset of the coordinates in u[] (here 0)
37590139fca9SMatthew G. Knepley .  uOff_x       - The offset of the coordinates in u_x[] (here 0)
37600139fca9SMatthew G. Knepley .  u            - The coordinate values at this point in space
376120f4b53cSBarry Smith .  u_t          - The coordinate time derivative at this point in space (here `NULL`)
37620139fca9SMatthew G. Knepley .  u_x          - The coordinate derivatives at this point in space
37630139fca9SMatthew G. Knepley .  aOff         - The offset of each auxiliary field in u[]
37640139fca9SMatthew G. Knepley .  aOff_x       - The offset of each auxiliary field in u_x[]
37650139fca9SMatthew G. Knepley .  a            - The auxiliary field values at this point in space
376620f4b53cSBarry Smith .  a_t          - The auxiliary field time derivative at this point in space (or `NULL`)
37670139fca9SMatthew G. Knepley .  a_x          - The auxiliary field derivatives at this point in space
37680139fca9SMatthew G. Knepley .  t            - The current time
37690139fca9SMatthew G. Knepley .  x            - The coordinates of this point (here not used)
37700139fca9SMatthew G. Knepley .  numConstants - The number of constants
37710139fca9SMatthew G. Knepley .  constants    - The value of each constant
37720139fca9SMatthew G. Knepley -  f            - The new coordinates at this point in space
37730139fca9SMatthew G. Knepley 
37740139fca9SMatthew G. Knepley   Level: intermediate
37750139fca9SMatthew G. Knepley 
37762fe279fdSBarry Smith .seealso: `DMPLEX`, `DMGetCoordinates()`, `DMGetCoordinatesLocal()`, `DMGetCoordinateDM()`, `DMProjectFieldLocal()`, `DMProjectFieldLabelLocal()`
37770139fca9SMatthew G. Knepley @*/
3778d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexRemapGeometry(DM dm, PetscReal time, void (*func)(PetscInt, PetscInt, PetscInt, const PetscInt[], const PetscInt[], const PetscScalar[], const PetscScalar[], const PetscScalar[], const PetscInt[], const PetscInt[], const PetscScalar[], const PetscScalar[], const PetscScalar[], PetscReal, const PetscReal[], PetscInt, const PetscScalar[], PetscScalar[]))
3779d71ae5a4SJacob Faibussowitsch {
37800139fca9SMatthew G. Knepley   DM      cdm;
37818bf1a49fSMatthew G. Knepley   DMField cf;
37820139fca9SMatthew G. Knepley   Vec     lCoords, tmpCoords;
37830139fca9SMatthew G. Knepley 
37840139fca9SMatthew G. Knepley   PetscFunctionBegin;
37859566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
37869566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinatesLocal(dm, &lCoords));
37879566063dSJacob Faibussowitsch   PetscCall(DMGetLocalVector(cdm, &tmpCoords));
37889566063dSJacob Faibussowitsch   PetscCall(VecCopy(lCoords, tmpCoords));
37898bf1a49fSMatthew G. Knepley   /* We have to do the coordinate field manually right now since the coordinate DM will not have its own */
37909566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateField(dm, &cf));
37916858538eSMatthew G. Knepley   cdm->coordinates[0].field = cf;
37929566063dSJacob Faibussowitsch   PetscCall(DMProjectFieldLocal(cdm, time, tmpCoords, &func, INSERT_VALUES, lCoords));
37936858538eSMatthew G. Knepley   cdm->coordinates[0].field = NULL;
37949566063dSJacob Faibussowitsch   PetscCall(DMRestoreLocalVector(cdm, &tmpCoords));
37959566063dSJacob Faibussowitsch   PetscCall(DMSetCoordinatesLocal(dm, lCoords));
37963ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
37970139fca9SMatthew G. Knepley }
37980139fca9SMatthew G. Knepley 
37990139fca9SMatthew G. Knepley /* Shear applies the transformation, assuming we fix z,
38000139fca9SMatthew G. Knepley   / 1  0  m_0 \
38010139fca9SMatthew G. Knepley   | 0  1  m_1 |
38020139fca9SMatthew G. Knepley   \ 0  0   1  /
38030139fca9SMatthew G. Knepley */
3804d71ae5a4SJacob Faibussowitsch static void f0_shear(PetscInt dim, PetscInt Nf, PetscInt NfAux, const PetscInt uOff[], const PetscInt uOff_x[], const PetscScalar u[], const PetscScalar u_t[], const PetscScalar u_x[], const PetscInt aOff[], const PetscInt aOff_x[], const PetscScalar a[], const PetscScalar a_t[], const PetscScalar a_x[], PetscReal t, const PetscReal x[], PetscInt numConstants, const PetscScalar constants[], PetscScalar coords[])
3805d71ae5a4SJacob Faibussowitsch {
38060139fca9SMatthew G. Knepley   const PetscInt Nc = uOff[1] - uOff[0];
3807c1f1bd54SMatthew G. Knepley   const PetscInt ax = (PetscInt)PetscRealPart(constants[0]);
38080139fca9SMatthew G. Knepley   PetscInt       c;
38090139fca9SMatthew G. Knepley 
3810ad540459SPierre Jolivet   for (c = 0; c < Nc; ++c) coords[c] = u[c] + constants[c + 1] * u[ax];
38110139fca9SMatthew G. Knepley }
38120139fca9SMatthew G. Knepley 
38130139fca9SMatthew G. Knepley /*@C
38140139fca9SMatthew G. Knepley   DMPlexShearGeometry - This shears the domain, meaning adds a multiple of the shear coordinate to all other coordinates.
38150139fca9SMatthew G. Knepley 
381620f4b53cSBarry Smith   Not Collective
38170139fca9SMatthew G. Knepley 
38180139fca9SMatthew G. Knepley   Input Parameters:
381920f4b53cSBarry Smith + dm          - The `DMPLEX`
38203ee9839eSMatthew G. Knepley . direction   - The shear coordinate direction, e.g. 0 is the x-axis
38210139fca9SMatthew G. Knepley - multipliers - The multiplier m for each direction which is not the shear direction
38220139fca9SMatthew G. Knepley 
38230139fca9SMatthew G. Knepley   Level: intermediate
38240139fca9SMatthew G. Knepley 
382520f4b53cSBarry Smith .seealso: `DMPLEX`, `DMPlexRemapGeometry()`
38260139fca9SMatthew G. Knepley @*/
3827d71ae5a4SJacob Faibussowitsch PetscErrorCode DMPlexShearGeometry(DM dm, DMDirection direction, PetscReal multipliers[])
3828d71ae5a4SJacob Faibussowitsch {
38290139fca9SMatthew G. Knepley   DM             cdm;
38300139fca9SMatthew G. Knepley   PetscDS        cds;
38310139fca9SMatthew G. Knepley   PetscObject    obj;
38320139fca9SMatthew G. Knepley   PetscClassId   id;
38330139fca9SMatthew G. Knepley   PetscScalar   *moduli;
38343ee9839eSMatthew G. Knepley   const PetscInt dir = (PetscInt)direction;
38350139fca9SMatthew G. Knepley   PetscInt       dE, d, e;
38360139fca9SMatthew G. Knepley 
38370139fca9SMatthew G. Knepley   PetscFunctionBegin;
38389566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDM(dm, &cdm));
38399566063dSJacob Faibussowitsch   PetscCall(DMGetCoordinateDim(dm, &dE));
38409566063dSJacob Faibussowitsch   PetscCall(PetscMalloc1(dE + 1, &moduli));
38410139fca9SMatthew G. Knepley   moduli[0] = dir;
3842cdaaecf7SMatthew G. Knepley   for (d = 0, e = 0; d < dE; ++d) moduli[d + 1] = d == dir ? 0.0 : (multipliers ? multipliers[e++] : 1.0);
38439566063dSJacob Faibussowitsch   PetscCall(DMGetDS(cdm, &cds));
38449566063dSJacob Faibussowitsch   PetscCall(PetscDSGetDiscretization(cds, 0, &obj));
38459566063dSJacob Faibussowitsch   PetscCall(PetscObjectGetClassId(obj, &id));
38460139fca9SMatthew G. Knepley   if (id != PETSCFE_CLASSID) {
38470139fca9SMatthew G. Knepley     Vec          lCoords;
38480139fca9SMatthew G. Knepley     PetscSection cSection;
38490139fca9SMatthew G. Knepley     PetscScalar *coords;
38500139fca9SMatthew G. Knepley     PetscInt     vStart, vEnd, v;
38510139fca9SMatthew G. Knepley 
38529566063dSJacob Faibussowitsch     PetscCall(DMPlexGetDepthStratum(dm, 0, &vStart, &vEnd));
38539566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinateSection(dm, &cSection));
38549566063dSJacob Faibussowitsch     PetscCall(DMGetCoordinatesLocal(dm, &lCoords));
38559566063dSJacob Faibussowitsch     PetscCall(VecGetArray(lCoords, &coords));
38560139fca9SMatthew G. Knepley     for (v = vStart; v < vEnd; ++v) {
38570139fca9SMatthew G. Knepley       PetscReal ds;
38580139fca9SMatthew G. Knepley       PetscInt  off, c;
38590139fca9SMatthew G. Knepley 
38609566063dSJacob Faibussowitsch       PetscCall(PetscSectionGetOffset(cSection, v, &off));
38610139fca9SMatthew G. Knepley       ds = PetscRealPart(coords[off + dir]);
38620139fca9SMatthew G. Knepley       for (c = 0; c < dE; ++c) coords[off + c] += moduli[c] * ds;
38630139fca9SMatthew G. Knepley     }
38649566063dSJacob Faibussowitsch     PetscCall(VecRestoreArray(lCoords, &coords));
38650139fca9SMatthew G. Knepley   } else {
38669566063dSJacob Faibussowitsch     PetscCall(PetscDSSetConstants(cds, dE + 1, moduli));
38679566063dSJacob Faibussowitsch     PetscCall(DMPlexRemapGeometry(dm, 0.0, f0_shear));
38680139fca9SMatthew G. Knepley   }
38699566063dSJacob Faibussowitsch   PetscCall(PetscFree(moduli));
38703ba16761SJacob Faibussowitsch   PetscFunctionReturn(PETSC_SUCCESS);
38710139fca9SMatthew G. Knepley }
3872