xref: /libCEED/rust/libceed-sys/c-src/interface/ceed-preconditioning.c (revision 32db0c4dc7e6b5d9c7baf16042a707676f075368)
19ba83ac0SJeremy L Thompson // Copyright (c) 2017-2026, Lawrence Livermore National Security, LLC and other CEED contributors.
23d8e8822SJeremy L Thompson // All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
3eaf62fffSJeremy L Thompson //
43d8e8822SJeremy L Thompson // SPDX-License-Identifier: BSD-2-Clause
5eaf62fffSJeremy L Thompson //
63d8e8822SJeremy L Thompson // This file is part of CEED:  http://github.com/ceed
7eaf62fffSJeremy L Thompson 
82b730f8bSJeremy L Thompson #include <ceed-impl.h>
949aac155SJeremy L Thompson #include <ceed.h>
102b730f8bSJeremy L Thompson #include <ceed/backend.h>
11c85e8640SSebastian Grimberg #include <assert.h>
122b730f8bSJeremy L Thompson #include <math.h>
13eaf62fffSJeremy L Thompson #include <stdbool.h>
14eaf62fffSJeremy L Thompson #include <stdio.h>
15eaf62fffSJeremy L Thompson #include <string.h>
16eaf62fffSJeremy L Thompson 
17eaf62fffSJeremy L Thompson /// @file
18eaf62fffSJeremy L Thompson /// Implementation of CeedOperator preconditioning interfaces
19eaf62fffSJeremy L Thompson 
20eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
21eaf62fffSJeremy L Thompson /// CeedOperator Library Internal Preconditioning Functions
22eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
23eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorDeveloper
24eaf62fffSJeremy L Thompson /// @{
25eaf62fffSJeremy L Thompson 
26eaf62fffSJeremy L Thompson /**
27ca94c3ddSJeremy L Thompson   @brief Duplicate a `CeedQFunction` with a reference `Ceed` to fallback for advanced `CeedOperator` functionality
289e77b9c8SJeremy L Thompson 
29ca94c3ddSJeremy L Thompson   @param[in]  fallback_ceed `Ceed` on which to create fallback `CeedQFunction`
30ca94c3ddSJeremy L Thompson   @param[in]  qf            `CeedQFunction` to create fallback for
31ca94c3ddSJeremy L Thompson   @param[out] qf_fallback   Fallback `CeedQFunction`
329e77b9c8SJeremy L Thompson 
339e77b9c8SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
349e77b9c8SJeremy L Thompson 
359e77b9c8SJeremy L Thompson   @ref Developer
369e77b9c8SJeremy L Thompson **/
372b730f8bSJeremy L Thompson static int CeedQFunctionCreateFallback(Ceed fallback_ceed, CeedQFunction qf, CeedQFunction *qf_fallback) {
381c66c397SJeremy L Thompson   char               *source_path_with_name = NULL;
391203703bSJeremy L Thompson   CeedInt             num_input_fields, num_output_fields;
401203703bSJeremy L Thompson   CeedQFunctionField *input_fields, *output_fields;
411c66c397SJeremy L Thompson 
429e77b9c8SJeremy L Thompson   // Check if NULL qf passed in
439e77b9c8SJeremy L Thompson   if (!qf) return CEED_ERROR_SUCCESS;
449e77b9c8SJeremy L Thompson 
459bc66399SJeremy L Thompson   CeedDebug(CeedQFunctionReturnCeed(qf), "Creating fallback CeedQFunction\n");
46d04bbc78SJeremy L Thompson 
479e77b9c8SJeremy L Thompson   if (qf->source_path) {
482b730f8bSJeremy L Thompson     size_t path_len = strlen(qf->source_path), name_len = strlen(qf->kernel_name);
499c25dd66SJeremy L Thompson 
502b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(path_len + name_len + 2, &source_path_with_name));
519e77b9c8SJeremy L Thompson     memcpy(source_path_with_name, qf->source_path, path_len);
529e77b9c8SJeremy L Thompson     memcpy(&source_path_with_name[path_len], ":", 1);
539e77b9c8SJeremy L Thompson     memcpy(&source_path_with_name[path_len + 1], qf->kernel_name, name_len);
549c25dd66SJeremy L Thompson   } else if (qf->user_source) {
559c25dd66SJeremy L Thompson     CeedCall(CeedStringAllocCopy(qf->user_source, &source_path_with_name));
569e77b9c8SJeremy L Thompson   } else {
572b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &source_path_with_name));
589e77b9c8SJeremy L Thompson   }
599e77b9c8SJeremy L Thompson 
601203703bSJeremy L Thompson   {
611203703bSJeremy L Thompson     CeedInt           vec_length;
621203703bSJeremy L Thompson     CeedQFunctionUser f;
631203703bSJeremy L Thompson 
641203703bSJeremy L Thompson     CeedCall(CeedQFunctionGetVectorLength(qf, &vec_length));
651203703bSJeremy L Thompson     CeedCall(CeedQFunctionGetUserFunction(qf, &f));
661203703bSJeremy L Thompson     CeedCall(CeedQFunctionCreateInterior(fallback_ceed, vec_length, f, source_path_with_name, qf_fallback));
671203703bSJeremy L Thompson   }
689e77b9c8SJeremy L Thompson   {
699e77b9c8SJeremy L Thompson     CeedQFunctionContext ctx;
709e77b9c8SJeremy L Thompson 
712b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionGetContext(qf, &ctx));
722b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(*qf_fallback, ctx));
731485364cSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx));
749e77b9c8SJeremy L Thompson   }
751203703bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &input_fields, &num_output_fields, &output_fields));
761203703bSJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
776f8994e9SJeremy L Thompson     const char  *field_name;
781203703bSJeremy L Thompson     CeedInt      size;
791203703bSJeremy L Thompson     CeedEvalMode eval_mode;
801203703bSJeremy L Thompson 
81ab747706SJeremy L Thompson     CeedCall(CeedQFunctionFieldGetData(input_fields[i], &field_name, &size, &eval_mode));
821203703bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(*qf_fallback, field_name, size, eval_mode));
839e77b9c8SJeremy L Thompson   }
841203703bSJeremy L Thompson   for (CeedInt i = 0; i < num_output_fields; i++) {
856f8994e9SJeremy L Thompson     const char  *field_name;
861203703bSJeremy L Thompson     CeedInt      size;
871203703bSJeremy L Thompson     CeedEvalMode eval_mode;
881203703bSJeremy L Thompson 
89ab747706SJeremy L Thompson     CeedCall(CeedQFunctionFieldGetData(output_fields[i], &field_name, &size, &eval_mode));
901203703bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(*qf_fallback, field_name, size, eval_mode));
919e77b9c8SJeremy L Thompson   }
922b730f8bSJeremy L Thompson   CeedCall(CeedFree(&source_path_with_name));
939e77b9c8SJeremy L Thompson   return CEED_ERROR_SUCCESS;
949e77b9c8SJeremy L Thompson }
959e77b9c8SJeremy L Thompson 
969e77b9c8SJeremy L Thompson /**
97ca94c3ddSJeremy L Thompson   @brief Duplicate a `CeedOperator` with a reference `Ceed` to fallback for advanced `CeedOperator` functionality
98eaf62fffSJeremy L Thompson 
99ca94c3ddSJeremy L Thompson   @param[in,out] op `CeedOperator` to create fallback for
100eaf62fffSJeremy L Thompson 
101eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
102eaf62fffSJeremy L Thompson 
103eaf62fffSJeremy L Thompson   @ref Developer
104eaf62fffSJeremy L Thompson **/
105d04bbc78SJeremy L Thompson static int CeedOperatorCreateFallback(CeedOperator op) {
1061c66c397SJeremy L Thompson   bool         is_composite;
1071203703bSJeremy L Thompson   Ceed         ceed, ceed_fallback;
1081c66c397SJeremy L Thompson   CeedOperator op_fallback;
109eaf62fffSJeremy L Thompson 
110805fe78eSJeremy L Thompson   // Check not already created
111805fe78eSJeremy L Thompson   if (op->op_fallback) return CEED_ERROR_SUCCESS;
112805fe78eSJeremy L Thompson 
113eaf62fffSJeremy L Thompson   // Fallback Ceed
1141203703bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
1151203703bSJeremy L Thompson   CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback));
1169bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
117d04bbc78SJeremy L Thompson   if (!ceed_fallback) return CEED_ERROR_SUCCESS;
118d04bbc78SJeremy L Thompson 
1199bc66399SJeremy L Thompson   CeedDebug(CeedOperatorReturnCeed(op), "Creating fallback CeedOperator\n");
120eaf62fffSJeremy L Thompson 
121eaf62fffSJeremy L Thompson   // Clone Op
122b275c451SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
123b275c451SJeremy L Thompson   if (is_composite) {
124b275c451SJeremy L Thompson     CeedInt       num_suboperators;
125b275c451SJeremy L Thompson     CeedOperator *sub_operators;
126b275c451SJeremy L Thompson 
127ed094490SJeremy L Thompson     CeedCall(CeedOperatorCreateComposite(ceed_fallback, &op_fallback));
128ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetNumSub(op, &num_suboperators));
129ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
130b275c451SJeremy L Thompson     for (CeedInt i = 0; i < num_suboperators; i++) {
131d04bbc78SJeremy L Thompson       CeedOperator op_sub_fallback;
132d04bbc78SJeremy L Thompson 
133b275c451SJeremy L Thompson       CeedCall(CeedOperatorGetFallback(sub_operators[i], &op_sub_fallback));
134ed094490SJeremy L Thompson       CeedCall(CeedOperatorCompositeAddSub(op_fallback, op_sub_fallback));
135805fe78eSJeremy L Thompson     }
136805fe78eSJeremy L Thompson   } else {
137bcd92680SJeremy L Thompson     bool               is_at_points = false;
1381203703bSJeremy L Thompson     CeedInt            num_input_fields, num_output_fields;
1399e77b9c8SJeremy L Thompson     CeedQFunction      qf_fallback = NULL, dqf_fallback = NULL, dqfT_fallback = NULL;
1401203703bSJeremy L Thompson     CeedOperatorField *input_fields, *output_fields;
1411c66c397SJeremy L Thompson 
1422b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->qf, &qf_fallback));
1432b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqf, &dqf_fallback));
1442b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqfT, &dqfT_fallback));
145bcd92680SJeremy L Thompson     CeedCall(CeedOperatorIsAtPoints(op, &is_at_points));
146bcd92680SJeremy L Thompson     if (is_at_points) {
147bcd92680SJeremy L Thompson       CeedVector          points;
148bcd92680SJeremy L Thompson       CeedElemRestriction rstr_points;
149bcd92680SJeremy L Thompson 
150bcd92680SJeremy L Thompson       CeedCall(CeedOperatorCreateAtPoints(ceed_fallback, qf_fallback, dqf_fallback, dqfT_fallback, &op_fallback));
151bcd92680SJeremy L Thompson       CeedCall(CeedOperatorAtPointsGetPoints(op, &rstr_points, &points));
152bcd92680SJeremy L Thompson       CeedCall(CeedOperatorAtPointsSetPoints(op_fallback, rstr_points, points));
153bcd92680SJeremy L Thompson       CeedCall(CeedVectorDestroy(&points));
154bcd92680SJeremy L Thompson       CeedCall(CeedElemRestrictionDestroy(&rstr_points));
155bcd92680SJeremy L Thompson     } else {
1562b730f8bSJeremy L Thompson       CeedCall(CeedOperatorCreate(ceed_fallback, qf_fallback, dqf_fallback, dqfT_fallback, &op_fallback));
157bcd92680SJeremy L Thompson     }
1581203703bSJeremy L Thompson     CeedCall(CeedOperatorGetFields(op, &num_input_fields, &input_fields, &num_output_fields, &output_fields));
1591203703bSJeremy L Thompson     for (CeedInt i = 0; i < num_input_fields; i++) {
1606f8994e9SJeremy L Thompson       const char         *field_name;
1611203703bSJeremy L Thompson       CeedVector          vec;
1621203703bSJeremy L Thompson       CeedElemRestriction rstr;
1631203703bSJeremy L Thompson       CeedBasis           basis;
1641203703bSJeremy L Thompson 
165ab747706SJeremy L Thompson       CeedCall(CeedOperatorFieldGetData(input_fields[i], &field_name, &rstr, &basis, &vec));
1661203703bSJeremy L Thompson       CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec));
167681d0ea7SJeremy L Thompson       CeedCall(CeedVectorDestroy(&vec));
168681d0ea7SJeremy L Thompson       CeedCall(CeedElemRestrictionDestroy(&rstr));
169681d0ea7SJeremy L Thompson       CeedCall(CeedBasisDestroy(&basis));
170805fe78eSJeremy L Thompson     }
1711203703bSJeremy L Thompson     for (CeedInt i = 0; i < num_output_fields; i++) {
1726f8994e9SJeremy L Thompson       const char         *field_name;
1731203703bSJeremy L Thompson       CeedVector          vec;
1741203703bSJeremy L Thompson       CeedElemRestriction rstr;
1751203703bSJeremy L Thompson       CeedBasis           basis;
1761203703bSJeremy L Thompson 
177ab747706SJeremy L Thompson       CeedCall(CeedOperatorFieldGetData(output_fields[i], &field_name, &rstr, &basis, &vec));
1781203703bSJeremy L Thompson       CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec));
179681d0ea7SJeremy L Thompson       CeedCall(CeedVectorDestroy(&vec));
180681d0ea7SJeremy L Thompson       CeedCall(CeedElemRestrictionDestroy(&rstr));
181681d0ea7SJeremy L Thompson       CeedCall(CeedBasisDestroy(&basis));
182805fe78eSJeremy L Thompson     }
1837d5185d7SSebastian Grimberg     {
1847d5185d7SSebastian Grimberg       CeedQFunctionAssemblyData data;
1857d5185d7SSebastian Grimberg 
1867d5185d7SSebastian Grimberg       CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data));
1877d5185d7SSebastian Grimberg       CeedCall(CeedQFunctionAssemblyDataReferenceCopy(data, &op_fallback->qf_assembled));
1887d5185d7SSebastian Grimberg     }
1899e77b9c8SJeremy L Thompson     // Cleanup
1902b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&qf_fallback));
1912b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqf_fallback));
1922b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqfT_fallback));
193805fe78eSJeremy L Thompson   }
1942b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetName(op_fallback, op->name));
1952b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fallback));
196b05f7e9fSJeremy L Thompson   // Note: No ref-counting here so we don't get caught in a reference loop.
197b05f7e9fSJeremy L Thompson   //       The op holds the only reference to op_fallback and is responsible for deleting itself and op_fallback.
198805fe78eSJeremy L Thompson   op->op_fallback                 = op_fallback;
199b05f7e9fSJeremy L Thompson   op_fallback->op_fallback_parent = op;
2009bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed_fallback));
201eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
202eaf62fffSJeremy L Thompson }
203eaf62fffSJeremy L Thompson 
204eaf62fffSJeremy L Thompson /**
205eaf62fffSJeremy L Thompson   @brief Core logic for assembling operator diagonal or point block diagonal
206eaf62fffSJeremy L Thompson 
2070cd9fdf4SJeremy L Thompson   @param[in]  op             `CeedOperator` to assemble diagonal or point block diagonal
208ca94c3ddSJeremy L Thompson   @param[in]  request        Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
209bd83916cSSebastian Grimberg   @param[in]  is_point_block Boolean flag to assemble diagonal or point block diagonal
210ca94c3ddSJeremy L Thompson   @param[out] assembled      `CeedVector` to store assembled diagonal
211eaf62fffSJeremy L Thompson 
212eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
213eaf62fffSJeremy L Thompson 
214eaf62fffSJeremy L Thompson   @ref Developer
215eaf62fffSJeremy L Thompson **/
216ed094490SJeremy L Thompson static inline int CeedOperatorLinearAssembleAddDiagonalSingle_Mesh(CeedOperator op, CeedRequest *request, const bool is_point_block,
217f3bd9308SJeremy L Thompson                                                                    CeedVector assembled) {
218506b1a0cSSebastian Grimberg   bool is_composite;
219506b1a0cSSebastian Grimberg 
220506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2219bc66399SJeremy L Thompson   CeedCheck(!is_composite, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
222506b1a0cSSebastian Grimberg 
223506b1a0cSSebastian Grimberg   // Assemble QFunction
224506b1a0cSSebastian Grimberg   CeedInt             layout_qf[3];
225437c7c90SJeremy L Thompson   const CeedScalar   *assembled_qf_array;
226c5f45aeaSJeremy L Thompson   CeedVector          assembled_qf        = NULL;
227c5f45aeaSJeremy L Thompson   CeedElemRestriction assembled_elem_rstr = NULL;
228437c7c90SJeremy L Thompson 
229437c7c90SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, request));
23056c48462SJeremy L Thompson   CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf));
231437c7c90SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr));
232437c7c90SJeremy L Thompson   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
233eaf62fffSJeremy L Thompson 
234ed9e99e6SJeremy L Thompson   // Get assembly data
235437c7c90SJeremy L Thompson   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
236506b1a0cSSebastian Grimberg   CeedInt                  num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out;
237437c7c90SJeremy L Thompson   CeedSize               **eval_mode_offsets_in, **eval_mode_offsets_out, num_output_components;
238506b1a0cSSebastian Grimberg   CeedBasis               *active_bases_in, *active_bases_out;
239506b1a0cSSebastian Grimberg   CeedElemRestriction     *active_elem_rstrs_in, *active_elem_rstrs_out;
2401c66c397SJeremy L Thompson   CeedOperatorAssemblyData data;
2411c66c397SJeremy L Thompson 
242437c7c90SJeremy L Thompson   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
243506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, &eval_mode_offsets_in,
244506b1a0cSSebastian Grimberg                                                 &num_active_bases_out, &num_eval_modes_out, &eval_modes_out, &eval_mode_offsets_out,
245506b1a0cSSebastian Grimberg                                                 &num_output_components));
246506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, NULL, NULL, &active_bases_out, NULL));
247506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, NULL, &active_elem_rstrs_in, NULL, &active_elem_rstrs_out));
248506b1a0cSSebastian Grimberg 
249934a29f5SSebastian Grimberg   // Loop over all active bases (find matching input/output pairs)
250934a29f5SSebastian Grimberg   for (CeedInt b = 0; b < CeedIntMin(num_active_bases_in, num_active_bases_out); b++) {
251934a29f5SSebastian Grimberg     CeedInt             b_in, b_out, num_elem, num_nodes, num_qpts, num_comp;
2521c66c397SJeremy L Thompson     bool                has_eval_none = false;
2531c66c397SJeremy L Thompson     CeedScalar         *elem_diag_array, *identity = NULL;
2541c66c397SJeremy L Thompson     CeedVector          elem_diag;
2557c1dbaffSSebastian Grimberg     CeedElemRestriction diag_elem_rstr;
2561c66c397SJeremy L Thompson 
257934a29f5SSebastian Grimberg     if (num_active_bases_in <= num_active_bases_out) {
258934a29f5SSebastian Grimberg       b_in = b;
259934a29f5SSebastian Grimberg       for (b_out = 0; b_out < num_active_bases_out; b_out++) {
260934a29f5SSebastian Grimberg         if (active_bases_in[b_in] == active_bases_out[b_out]) {
261934a29f5SSebastian Grimberg           break;
262934a29f5SSebastian Grimberg         }
263934a29f5SSebastian Grimberg       }
264934a29f5SSebastian Grimberg       if (b_out == num_active_bases_out) {
265934a29f5SSebastian Grimberg         continue;
266934a29f5SSebastian Grimberg       }  // No matching output basis found
267934a29f5SSebastian Grimberg     } else {
268934a29f5SSebastian Grimberg       b_out = b;
269934a29f5SSebastian Grimberg       for (b_in = 0; b_in < num_active_bases_in; b_in++) {
270934a29f5SSebastian Grimberg         if (active_bases_in[b_in] == active_bases_out[b_out]) {
271934a29f5SSebastian Grimberg           break;
272934a29f5SSebastian Grimberg         }
273934a29f5SSebastian Grimberg       }
274934a29f5SSebastian Grimberg       if (b_in == num_active_bases_in) {
275934a29f5SSebastian Grimberg         continue;
276934a29f5SSebastian Grimberg       }  // No matching output basis found
277934a29f5SSebastian Grimberg     }
2789bc66399SJeremy L Thompson     CeedCheck(active_elem_rstrs_in[b_in] == active_elem_rstrs_out[b_out], CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
279506b1a0cSSebastian Grimberg               "Cannot assemble operator diagonal with different input and output active element restrictions");
280506b1a0cSSebastian Grimberg 
2811c66c397SJeremy L Thompson     // Assemble point block diagonal restriction, if needed
282bd83916cSSebastian Grimberg     if (is_point_block) {
283934a29f5SSebastian Grimberg       CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstrs_in[b_in], &diag_elem_rstr));
2847c1dbaffSSebastian Grimberg     } else {
285934a29f5SSebastian Grimberg       CeedCall(CeedElemRestrictionCreateUnsignedCopy(active_elem_rstrs_in[b_in], &diag_elem_rstr));
286eaf62fffSJeremy L Thompson     }
287eaf62fffSJeremy L Thompson 
288eaf62fffSJeremy L Thompson     // Create diagonal vector
289437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(diag_elem_rstr, NULL, &elem_diag));
290eaf62fffSJeremy L Thompson 
291eaf62fffSJeremy L Thompson     // Assemble element operator diagonals
2922b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(elem_diag, 0.0));
2932b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArray(elem_diag, CEED_MEM_HOST, &elem_diag_array));
294437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionGetNumElements(diag_elem_rstr, &num_elem));
295934a29f5SSebastian Grimberg     CeedCall(CeedBasisGetNumNodes(active_bases_in[b_in], &num_nodes));
296934a29f5SSebastian Grimberg     CeedCall(CeedBasisGetNumComponents(active_bases_in[b_in], &num_comp));
297934a29f5SSebastian Grimberg     if (active_bases_in[b_in] == CEED_BASIS_NONE) num_qpts = num_nodes;
298934a29f5SSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(active_bases_in[b_in], &num_qpts));
299ed9e99e6SJeremy L Thompson 
300352a5e7cSSebastian Grimberg     // Construct identity matrix for basis if required
301934a29f5SSebastian Grimberg     for (CeedInt i = 0; i < num_eval_modes_in[b_in]; i++) {
302934a29f5SSebastian Grimberg       has_eval_none = has_eval_none || (eval_modes_in[b_in][i] == CEED_EVAL_NONE);
303ed9e99e6SJeremy L Thompson     }
304934a29f5SSebastian Grimberg     for (CeedInt i = 0; i < num_eval_modes_out[b_out]; i++) {
305934a29f5SSebastian Grimberg       has_eval_none = has_eval_none || (eval_modes_out[b_out][i] == CEED_EVAL_NONE);
306ed9e99e6SJeremy L Thompson     }
307ed9e99e6SJeremy L Thompson     if (has_eval_none) {
3082b730f8bSJeremy L Thompson       CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
3092b730f8bSJeremy L Thompson       for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) identity[i * num_nodes + i] = 1.0;
310eaf62fffSJeremy L Thompson     }
311352a5e7cSSebastian Grimberg 
312eaf62fffSJeremy L Thompson     // Compute the diagonal of B^T D B
313eaf62fffSJeremy L Thompson     // Each element
314b94338b9SJed Brown     for (CeedSize e = 0; e < num_elem; e++) {
315eaf62fffSJeremy L Thompson       // Each basis eval mode pair
316352a5e7cSSebastian Grimberg       CeedInt      d_out              = 0, q_comp_out;
317352a5e7cSSebastian Grimberg       CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
3181c66c397SJeremy L Thompson 
319934a29f5SSebastian Grimberg       for (CeedInt e_out = 0; e_out < num_eval_modes_out[b_out]; e_out++) {
3201c66c397SJeremy L Thompson         CeedInt           d_in              = 0, q_comp_in;
321437c7c90SJeremy L Thompson         const CeedScalar *B_t               = NULL;
3221c66c397SJeremy L Thompson         CeedEvalMode      eval_mode_in_prev = CEED_EVAL_NONE;
3231c66c397SJeremy L Thompson 
324934a29f5SSebastian Grimberg         CeedCall(CeedOperatorGetBasisPointer(active_bases_out[b_out], eval_modes_out[b_out][e_out], identity, &B_t));
325934a29f5SSebastian Grimberg         CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_out[b_out], eval_modes_out[b_out][e_out], &q_comp_out));
326352a5e7cSSebastian Grimberg         if (q_comp_out > 1) {
327934a29f5SSebastian Grimberg           if (e_out == 0 || eval_modes_out[b_out][e_out] != eval_mode_out_prev) d_out = 0;
328352a5e7cSSebastian Grimberg           else B_t = &B_t[(++d_out) * num_qpts * num_nodes];
329352a5e7cSSebastian Grimberg         }
330934a29f5SSebastian Grimberg         eval_mode_out_prev = eval_modes_out[b_out][e_out];
331352a5e7cSSebastian Grimberg 
332934a29f5SSebastian Grimberg         for (CeedInt e_in = 0; e_in < num_eval_modes_in[b_in]; e_in++) {
333437c7c90SJeremy L Thompson           const CeedScalar *B = NULL;
3341c66c397SJeremy L Thompson 
335934a29f5SSebastian Grimberg           CeedCall(CeedOperatorGetBasisPointer(active_bases_in[b_in], eval_modes_in[b_in][e_in], identity, &B));
336934a29f5SSebastian Grimberg           CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_in[b_in], eval_modes_in[b_in][e_in], &q_comp_in));
337352a5e7cSSebastian Grimberg           if (q_comp_in > 1) {
338934a29f5SSebastian Grimberg             if (e_in == 0 || eval_modes_in[b_in][e_in] != eval_mode_in_prev) d_in = 0;
339352a5e7cSSebastian Grimberg             else B = &B[(++d_in) * num_qpts * num_nodes];
340352a5e7cSSebastian Grimberg           }
341934a29f5SSebastian Grimberg           eval_mode_in_prev = eval_modes_in[b_in][e_in];
342352a5e7cSSebastian Grimberg 
343eaf62fffSJeremy L Thompson           // Each component
344506b1a0cSSebastian Grimberg           for (CeedInt c_out = 0; c_out < num_comp; c_out++) {
345437c7c90SJeremy L Thompson             // Each qpt/node pair
3462b730f8bSJeremy L Thompson             for (CeedInt q = 0; q < num_qpts; q++) {
347bd83916cSSebastian Grimberg               if (is_point_block) {
348eaf62fffSJeremy L Thompson                 // Point Block Diagonal
349506b1a0cSSebastian Grimberg                 for (CeedInt c_in = 0; c_in < num_comp; c_in++) {
350934a29f5SSebastian Grimberg                   const CeedSize c_offset =
351934a29f5SSebastian Grimberg                       (eval_mode_offsets_in[b_in][e_in] + c_in) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out;
352506b1a0cSSebastian Grimberg                   const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]];
3531c66c397SJeremy L Thompson 
3542b730f8bSJeremy L Thompson                   for (CeedInt n = 0; n < num_nodes; n++) {
355506b1a0cSSebastian Grimberg                     elem_diag_array[((e * num_comp + c_out) * num_comp + c_in) * num_nodes + n] +=
356437c7c90SJeremy L Thompson                         B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
357eaf62fffSJeremy L Thompson                   }
3582b730f8bSJeremy L Thompson                 }
359eaf62fffSJeremy L Thompson               } else {
360eaf62fffSJeremy L Thompson                 // Diagonal Only
361934a29f5SSebastian Grimberg                 const CeedInt c_offset =
362934a29f5SSebastian Grimberg                     (eval_mode_offsets_in[b_in][e_in] + c_out) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out;
363506b1a0cSSebastian Grimberg                 const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]];
3641c66c397SJeremy L Thompson 
3652b730f8bSJeremy L Thompson                 for (CeedInt n = 0; n < num_nodes; n++) {
366506b1a0cSSebastian Grimberg                   elem_diag_array[(e * num_comp + c_out) * num_nodes + n] += B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
367eaf62fffSJeremy L Thompson                 }
368eaf62fffSJeremy L Thompson               }
369eaf62fffSJeremy L Thompson             }
370eaf62fffSJeremy L Thompson           }
3712b730f8bSJeremy L Thompson         }
3722b730f8bSJeremy L Thompson       }
3732b730f8bSJeremy L Thompson     }
3742b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(elem_diag, &elem_diag_array));
375eaf62fffSJeremy L Thompson 
376eaf62fffSJeremy L Thompson     // Assemble local operator diagonal
3777c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(diag_elem_rstr, CEED_TRANSPOSE, elem_diag, assembled, request));
378eaf62fffSJeremy L Thompson 
379eaf62fffSJeremy L Thompson     // Cleanup
3807c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&diag_elem_rstr));
3812b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&elem_diag));
3822b730f8bSJeremy L Thompson     CeedCall(CeedFree(&identity));
383437c7c90SJeremy L Thompson   }
384437c7c90SJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
385437c7c90SJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
386eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
387eaf62fffSJeremy L Thompson }
388eaf62fffSJeremy L Thompson 
389eaf62fffSJeremy L Thompson /**
3900cd9fdf4SJeremy L Thompson   @brief Core logic for assembling operator diagonal or point block diagonal
3910cd9fdf4SJeremy L Thompson 
3920cd9fdf4SJeremy L Thompson   @param[in]  op             `CeedOperator` to assemble diagonal or point block diagonal
3930cd9fdf4SJeremy L Thompson   @param[in]  request        Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
3940cd9fdf4SJeremy L Thompson   @param[in]  is_point_block Boolean flag to assemble diagonal or point block diagonal
3950cd9fdf4SJeremy L Thompson   @param[out] assembled      `CeedVector` to store assembled diagonal
3960cd9fdf4SJeremy L Thompson 
3970cd9fdf4SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
3980cd9fdf4SJeremy L Thompson 
3990cd9fdf4SJeremy L Thompson   @ref Developer
4000cd9fdf4SJeremy L Thompson **/
401ed094490SJeremy L Thompson static inline int CeedOperatorLinearAssembleAddDiagonalSingle(CeedOperator op, CeedRequest *request, const bool is_point_block,
4020cd9fdf4SJeremy L Thompson                                                               CeedVector assembled) {
4030cd9fdf4SJeremy L Thompson   bool is_at_points;
4040cd9fdf4SJeremy L Thompson 
4050cd9fdf4SJeremy L Thompson   CeedCall(CeedOperatorIsAtPoints(op, &is_at_points));
4069bc66399SJeremy L Thompson   CeedCheck(!is_at_points, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "AtPoints operator not supported");
407ed094490SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddDiagonalSingle_Mesh(op, request, is_point_block, assembled));
4080cd9fdf4SJeremy L Thompson   return CEED_ERROR_SUCCESS;
4090cd9fdf4SJeremy L Thompson }
4100cd9fdf4SJeremy L Thompson 
4110cd9fdf4SJeremy L Thompson /**
412eaf62fffSJeremy L Thompson   @brief Core logic for assembling composite operator diagonal
413eaf62fffSJeremy L Thompson 
414ca94c3ddSJeremy L Thompson   @param[in]  op             `CeedOperator` to assemble point block diagonal
415ca94c3ddSJeremy L Thompson   @param[in]  request        Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
416bd83916cSSebastian Grimberg   @param[in]  is_point_block Boolean flag to assemble diagonal or point block diagonal
417ca94c3ddSJeremy L Thompson   @param[out] assembled      `CeedVector` to store assembled diagonal
418eaf62fffSJeremy L Thompson 
419eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
420eaf62fffSJeremy L Thompson 
421eaf62fffSJeremy L Thompson   @ref Developer
422eaf62fffSJeremy L Thompson **/
423ed094490SJeremy L Thompson static inline int CeedOperatorLinearAssembleAddDiagonalComposite(CeedOperator op, CeedRequest *request, const bool is_point_block,
424eaf62fffSJeremy L Thompson                                                                  CeedVector assembled) {
425eaf62fffSJeremy L Thompson   CeedInt       num_sub;
426eaf62fffSJeremy L Thompson   CeedOperator *suboperators;
4271c66c397SJeremy L Thompson 
428ed094490SJeremy L Thompson   CeedCall(CeedOperatorCompositeGetNumSub(op, &num_sub));
429ed094490SJeremy L Thompson   CeedCall(CeedOperatorCompositeGetSubList(op, &suboperators));
430eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_sub; i++) {
431bd83916cSSebastian Grimberg     if (is_point_block) {
4322b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(suboperators[i], assembled, request));
4336aa95790SJeremy L Thompson     } else {
4342b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddDiagonal(suboperators[i], assembled, request));
4356aa95790SJeremy L Thompson     }
436eaf62fffSJeremy L Thompson   }
437eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
438eaf62fffSJeremy L Thompson }
439eaf62fffSJeremy L Thompson 
440eaf62fffSJeremy L Thompson /**
441ca94c3ddSJeremy L Thompson   @brief Build nonzero pattern for non-composite CeedOperator`.
442eaf62fffSJeremy L Thompson 
443ca94c3ddSJeremy L Thompson   Users should generally use @ref CeedOperatorLinearAssembleSymbolic().
444eaf62fffSJeremy L Thompson 
445ca94c3ddSJeremy L Thompson   @param[in]  op     `CeedOperator` to assemble nonzero pattern
446eaf62fffSJeremy L Thompson   @param[in]  offset Offset for number of entries
447eaf62fffSJeremy L Thompson   @param[out] rows   Row number for each entry
448eaf62fffSJeremy L Thompson   @param[out] cols   Column number for each entry
449eaf62fffSJeremy L Thompson 
450eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
451eaf62fffSJeremy L Thompson 
452eaf62fffSJeremy L Thompson   @ref Developer
453eaf62fffSJeremy L Thompson **/
454ed094490SJeremy L Thompson static int CeedOperatorAssembleSymbolicSingle(CeedOperator op, CeedInt offset, CeedInt *rows, CeedInt *cols) {
455f3d47e36SJeremy L Thompson   Ceed                ceed;
456f3d47e36SJeremy L Thompson   bool                is_composite;
45781670346SSebastian Grimberg   CeedSize            num_nodes_in, num_nodes_out, local_num_entries, count = 0;
458506b1a0cSSebastian Grimberg   CeedInt             num_elem_in, elem_size_in, num_comp_in, layout_er_in[3];
45981670346SSebastian Grimberg   CeedInt             num_elem_out, elem_size_out, num_comp_out, layout_er_out[3];
4601c66c397SJeremy L Thompson   CeedScalar         *array;
461506b1a0cSSebastian Grimberg   const CeedScalar   *elem_dof_a_in, *elem_dof_a_out;
462506b1a0cSSebastian Grimberg   CeedVector          index_vec_in, index_vec_out, elem_dof_in, elem_dof_out;
463506b1a0cSSebastian Grimberg   CeedElemRestriction elem_rstr_in, elem_rstr_out, index_elem_rstr_in, index_elem_rstr_out;
4641c66c397SJeremy L Thompson 
465f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
4669bc66399SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
4675e1f751eSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
468eaf62fffSJeremy L Thompson 
469506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveVectorLengths(op, &num_nodes_in, &num_nodes_out));
470506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out));
471506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in));
472506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in));
473506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in));
47456c48462SJeremy L Thompson   CeedCall(CeedElemRestrictionGetELayout(elem_rstr_in, layout_er_in));
475eaf62fffSJeremy L Thompson 
476506b1a0cSSebastian Grimberg   // Determine elem_dof relation for input
477506b1a0cSSebastian Grimberg   CeedCall(CeedVectorCreate(ceed, num_nodes_in, &index_vec_in));
478506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayWrite(index_vec_in, CEED_MEM_HOST, &array));
479c81f2b9dSJames Wright   for (CeedSize i = 0; i < num_nodes_in; i++) array[i] = i;
480506b1a0cSSebastian Grimberg   CeedCall(CeedVectorRestoreArray(index_vec_in, &array));
481506b1a0cSSebastian Grimberg   CeedCall(CeedVectorCreate(ceed, num_elem_in * elem_size_in * num_comp_in, &elem_dof_in));
482506b1a0cSSebastian Grimberg   CeedCall(CeedVectorSetValue(elem_dof_in, 0.0));
483506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_in, &index_elem_rstr_in));
484506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionApply(index_elem_rstr_in, CEED_NOTRANSPOSE, index_vec_in, elem_dof_in, CEED_REQUEST_IMMEDIATE));
485506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayRead(elem_dof_in, CEED_MEM_HOST, &elem_dof_a_in));
486506b1a0cSSebastian Grimberg   CeedCall(CeedVectorDestroy(&index_vec_in));
487506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_in));
488506b1a0cSSebastian Grimberg 
489506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
490506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out));
491506b1a0cSSebastian Grimberg     CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED,
4923f08121cSJeremy L Thompson               "Active input and output operator restrictions must have the same number of elements."
4933f08121cSJeremy L Thompson               " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.",
4943f08121cSJeremy L Thompson               num_elem_in, num_elem_out);
495506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out));
496506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out));
49756c48462SJeremy L Thompson     CeedCall(CeedElemRestrictionGetELayout(elem_rstr_out, layout_er_out));
498506b1a0cSSebastian Grimberg 
499506b1a0cSSebastian Grimberg     // Determine elem_dof relation for output
500506b1a0cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed, num_nodes_out, &index_vec_out));
501506b1a0cSSebastian Grimberg     CeedCall(CeedVectorGetArrayWrite(index_vec_out, CEED_MEM_HOST, &array));
502c81f2b9dSJames Wright     for (CeedSize i = 0; i < num_nodes_out; i++) array[i] = i;
503506b1a0cSSebastian Grimberg     CeedCall(CeedVectorRestoreArray(index_vec_out, &array));
504506b1a0cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed, num_elem_out * elem_size_out * num_comp_out, &elem_dof_out));
505506b1a0cSSebastian Grimberg     CeedCall(CeedVectorSetValue(elem_dof_out, 0.0));
506506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_out, &index_elem_rstr_out));
507506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(index_elem_rstr_out, CEED_NOTRANSPOSE, index_vec_out, elem_dof_out, CEED_REQUEST_IMMEDIATE));
508506b1a0cSSebastian Grimberg     CeedCall(CeedVectorGetArrayRead(elem_dof_out, CEED_MEM_HOST, &elem_dof_a_out));
509506b1a0cSSebastian Grimberg     CeedCall(CeedVectorDestroy(&index_vec_out));
510506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_out));
511506b1a0cSSebastian Grimberg   } else {
512506b1a0cSSebastian Grimberg     num_elem_out     = num_elem_in;
513506b1a0cSSebastian Grimberg     elem_size_out    = elem_size_in;
514506b1a0cSSebastian Grimberg     num_comp_out     = num_comp_in;
515506b1a0cSSebastian Grimberg     layout_er_out[0] = layout_er_in[0];
516506b1a0cSSebastian Grimberg     layout_er_out[1] = layout_er_in[1];
517506b1a0cSSebastian Grimberg     layout_er_out[2] = layout_er_in[2];
518506b1a0cSSebastian Grimberg     elem_dof_a_out   = elem_dof_a_in;
519506b1a0cSSebastian Grimberg   }
520c81f2b9dSJames Wright   local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in;
521eaf62fffSJeremy L Thompson 
522eaf62fffSJeremy L Thompson   // Determine i, j locations for element matrices
523506b1a0cSSebastian Grimberg   for (CeedInt e = 0; e < num_elem_in; e++) {
524506b1a0cSSebastian Grimberg     for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) {
525506b1a0cSSebastian Grimberg       for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) {
526506b1a0cSSebastian Grimberg         for (CeedInt i = 0; i < elem_size_out; i++) {
527506b1a0cSSebastian Grimberg           for (CeedInt j = 0; j < elem_size_in; j++) {
528506b1a0cSSebastian Grimberg             const CeedInt elem_dof_index_row = i * layout_er_out[0] + comp_out * layout_er_out[1] + e * layout_er_out[2];
529506b1a0cSSebastian Grimberg             const CeedInt elem_dof_index_col = j * layout_er_in[0] + comp_in * layout_er_in[1] + e * layout_er_in[2];
530506b1a0cSSebastian Grimberg             const CeedInt row                = elem_dof_a_out[elem_dof_index_row];
531506b1a0cSSebastian Grimberg             const CeedInt col                = elem_dof_a_in[elem_dof_index_col];
532eaf62fffSJeremy L Thompson 
533eaf62fffSJeremy L Thompson             rows[offset + count] = row;
534eaf62fffSJeremy L Thompson             cols[offset + count] = col;
535eaf62fffSJeremy L Thompson             count++;
536eaf62fffSJeremy L Thompson           }
537eaf62fffSJeremy L Thompson         }
538eaf62fffSJeremy L Thompson       }
539eaf62fffSJeremy L Thompson     }
540eaf62fffSJeremy L Thompson   }
5416574a04fSJeremy L Thompson   CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing assembled entries");
542506b1a0cSSebastian Grimberg   CeedCall(CeedVectorRestoreArrayRead(elem_dof_in, &elem_dof_a_in));
543506b1a0cSSebastian Grimberg   CeedCall(CeedVectorDestroy(&elem_dof_in));
544506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
545506b1a0cSSebastian Grimberg     CeedCall(CeedVectorRestoreArrayRead(elem_dof_out, &elem_dof_a_out));
546506b1a0cSSebastian Grimberg     CeedCall(CeedVectorDestroy(&elem_dof_out));
547506b1a0cSSebastian Grimberg   }
548681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in));
549681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out));
5509bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
551eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
552eaf62fffSJeremy L Thompson }
553eaf62fffSJeremy L Thompson 
554eaf62fffSJeremy L Thompson /**
5550816752eSJeremy L Thompson   @brief Core logic to assemble `CeedQFunction` and store result internally.
5560816752eSJeremy L Thompson 
5570816752eSJeremy L Thompson   Return copied references of stored data to the caller.
5580816752eSJeremy L Thompson   Caller is responsible for ownership and destruction of the copied references.
5590816752eSJeremy L Thompson   See also @ref CeedOperatorLinearAssembleQFunction().
5600816752eSJeremy L Thompson 
5610816752eSJeremy L Thompson   Note: If the value of `assembled` or `rstr` passed to this function are non-`NULL` , then it is assumed that they hold valid pointers.
5620816752eSJeremy L Thompson         These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object.
5630816752eSJeremy L Thompson 
5640816752eSJeremy L Thompson   @param[in]  op         `CeedOperator` to assemble `CeedQFunction`
5650816752eSJeremy L Thompson   @param[in]  use_parent Boolean flag to check for fallback parent implementation
5660816752eSJeremy L Thompson   @param[out] assembled  `CeedVector` to store assembled `CeedQFunction` at quadrature points
5670816752eSJeremy L Thompson   @param[out] rstr       `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
5680816752eSJeremy L Thompson   @param[in]  request    Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
5690816752eSJeremy L Thompson 
5700816752eSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
5710816752eSJeremy L Thompson 
5720816752eSJeremy L Thompson   @ref User
5730816752eSJeremy L Thompson **/
5740816752eSJeremy L Thompson static int CeedOperatorLinearAssembleQFunctionBuildOrUpdate_Core(CeedOperator op, bool use_parent, CeedVector *assembled, CeedElemRestriction *rstr,
5750816752eSJeremy L Thompson                                                                  CeedRequest *request) {
5760816752eSJeremy L Thompson   int (*LinearAssembleQFunctionUpdate)(CeedOperator, CeedVector, CeedElemRestriction, CeedRequest *) = NULL;
5770816752eSJeremy L Thompson   CeedOperator op_assemble                                                                           = NULL;
5780816752eSJeremy L Thompson   CeedOperator op_fallback_parent                                                                    = NULL;
5790816752eSJeremy L Thompson 
5800816752eSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
5810816752eSJeremy L Thompson 
5820816752eSJeremy L Thompson   // Determine if fallback parent or operator has implementation
5830816752eSJeremy L Thompson   CeedCall(CeedOperatorGetFallbackParent(op, &op_fallback_parent));
5840816752eSJeremy L Thompson   if (op_fallback_parent && use_parent && op_fallback_parent->LinearAssembleQFunctionUpdate) {
5850816752eSJeremy L Thompson     // -- Backend version for op fallback parent is faster, if it exists
586ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "Using fallback parent for CeedOperatorLinearAssembleQFunctionBuildOrUpdate\n");
5870816752eSJeremy L Thompson     LinearAssembleQFunctionUpdate = op_fallback_parent->LinearAssembleQFunctionUpdate;
5880816752eSJeremy L Thompson     op_assemble                   = op_fallback_parent;
5890816752eSJeremy L Thompson   } else if (op->LinearAssembleQFunctionUpdate) {
5900816752eSJeremy L Thompson     // -- Backend version for op
5910816752eSJeremy L Thompson     LinearAssembleQFunctionUpdate = op->LinearAssembleQFunctionUpdate;
5920816752eSJeremy L Thompson     op_assemble                   = op;
5930816752eSJeremy L Thompson   }
5940816752eSJeremy L Thompson 
5950816752eSJeremy L Thompson   // Assemble QFunction
5960816752eSJeremy L Thompson   if (LinearAssembleQFunctionUpdate) {
5970816752eSJeremy L Thompson     // Backend or fallback parent version
5980816752eSJeremy L Thompson     CeedQFunctionAssemblyData data;
5990816752eSJeremy L Thompson     bool                      data_is_setup;
6000816752eSJeremy L Thompson     CeedVector                assembled_vec  = NULL;
6010816752eSJeremy L Thompson     CeedElemRestriction       assembled_rstr = NULL;
6020816752eSJeremy L Thompson 
6030816752eSJeremy L Thompson     CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data));
6040816752eSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataIsSetup(data, &data_is_setup));
6050816752eSJeremy L Thompson     if (data_is_setup) {
6060816752eSJeremy L Thompson       bool update_needed;
6070816752eSJeremy L Thompson 
6080816752eSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataGetObjects(data, &assembled_vec, &assembled_rstr));
6090816752eSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataIsUpdateNeeded(data, &update_needed));
6100816752eSJeremy L Thompson       if (update_needed) CeedCall(LinearAssembleQFunctionUpdate(op_assemble, assembled_vec, assembled_rstr, request));
6110816752eSJeremy L Thompson     } else {
6120816752eSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleQFunction(op_assemble, &assembled_vec, &assembled_rstr, request));
6130816752eSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataSetObjects(data, assembled_vec, assembled_rstr));
6140816752eSJeremy L Thompson     }
6150816752eSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataSetUpdateNeeded(data, false));
6160816752eSJeremy L Thompson 
6170816752eSJeremy L Thompson     // Copy reference from internally held copy
6180816752eSJeremy L Thompson     CeedCall(CeedVectorReferenceCopy(assembled_vec, assembled));
6190816752eSJeremy L Thompson     CeedCall(CeedElemRestrictionReferenceCopy(assembled_rstr, rstr));
6200816752eSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled_vec));
6210816752eSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&assembled_rstr));
6220816752eSJeremy L Thompson   } else {
6230816752eSJeremy L Thompson     // Operator fallback
6240816752eSJeremy L Thompson     CeedOperator op_fallback;
6250816752eSJeremy L Thompson 
626ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleQFunctionBuildOrUpdate\n");
6270816752eSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
6280816752eSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op_fallback, assembled, rstr, request));
6290816752eSJeremy L Thompson     else return CeedError(CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunctionUpdate");
6300816752eSJeremy L Thompson   }
6310816752eSJeremy L Thompson   return CEED_ERROR_SUCCESS;
6320816752eSJeremy L Thompson }
6330816752eSJeremy L Thompson 
6340816752eSJeremy L Thompson /**
6350816752eSJeremy L Thompson   @brief Assemble `CeedQFunction` and store result internally, but do not use fallback parent.
6360816752eSJeremy L Thompson 
6370816752eSJeremy L Thompson   Return copied references of stored data to the caller.
6380816752eSJeremy L Thompson   Caller is responsible for ownership and destruction of the copied references.
6390816752eSJeremy L Thompson   See also @ref CeedOperatorLinearAssembleQFunction().
6400816752eSJeremy L Thompson 
6410816752eSJeremy L Thompson   Note: If the value of `assembled` or `rstr` passed to this function are non-`NULL` , then it is assumed that they hold valid pointers.
6420816752eSJeremy L Thompson         These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object.
6430816752eSJeremy L Thompson 
6440816752eSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
6450816752eSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points
6460816752eSJeremy L Thompson   @param[out] rstr      `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
6470816752eSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
6480816752eSJeremy L Thompson 
6490816752eSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
6500816752eSJeremy L Thompson 
6510816752eSJeremy L Thompson   @ref Developer
6520816752eSJeremy L Thompson **/
653ed094490SJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdateFallback(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr,
6540816752eSJeremy L Thompson                                                              CeedRequest *request) {
6550816752eSJeremy L Thompson   return CeedOperatorLinearAssembleQFunctionBuildOrUpdate_Core(op, false, assembled, rstr, request);
6560816752eSJeremy L Thompson }
6570816752eSJeremy L Thompson 
6580816752eSJeremy L Thompson /**
659ca94c3ddSJeremy L Thompson   @brief Assemble nonzero entries for non-composite `CeedOperator`.
660eaf62fffSJeremy L Thompson 
661ca94c3ddSJeremy L Thompson   Users should generally use @ref CeedOperatorLinearAssemble().
662eaf62fffSJeremy L Thompson 
663ca94c3ddSJeremy L Thompson   @param[in]  op     `CeedOperator` to assemble
664ea61e9acSJeremy L Thompson   @param[in]  offset Offset for number of entries
665eaf62fffSJeremy L Thompson   @param[out] values Values to assemble into matrix
666eaf62fffSJeremy L Thompson 
667eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
668eaf62fffSJeremy L Thompson 
669eaf62fffSJeremy L Thompson   @ref Developer
670eaf62fffSJeremy L Thompson **/
671ed094490SJeremy L Thompson int CeedOperatorAssembleSingle(CeedOperator op, CeedInt offset, CeedVector values) {
6721b95d8c6SJeremy L Thompson   bool is_composite, is_at_points;
6731c66c397SJeremy L Thompson 
674f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
6759bc66399SJeremy L Thompson   CeedCheck(!is_composite, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
676f3d47e36SJeremy L Thompson 
677f3d47e36SJeremy L Thompson   // Early exit for empty operator
678f3d47e36SJeremy L Thompson   {
679f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
680f3d47e36SJeremy L Thompson 
681f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
682f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
683f3d47e36SJeremy L Thompson   }
684eaf62fffSJeremy L Thompson 
685cefa2673SJeremy L Thompson   if (op->LinearAssembleSingle) {
686cefa2673SJeremy L Thompson     // Backend version
6872b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSingle(op, offset, values));
688cefa2673SJeremy L Thompson     return CEED_ERROR_SUCCESS;
689cefa2673SJeremy L Thompson   } else {
690cefa2673SJeremy L Thompson     // Operator fallback
691cefa2673SJeremy L Thompson     CeedOperator op_fallback;
692cefa2673SJeremy L Thompson 
693ed094490SJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorAssembleSingle\n");
6942b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
695cefa2673SJeremy L Thompson     if (op_fallback) {
696ed094490SJeremy L Thompson       CeedCall(CeedOperatorAssembleSingle(op_fallback, offset, values));
697cefa2673SJeremy L Thompson       return CEED_ERROR_SUCCESS;
698cefa2673SJeremy L Thompson     }
699cefa2673SJeremy L Thompson   }
700cefa2673SJeremy L Thompson 
7011b95d8c6SJeremy L Thompson   CeedCall(CeedOperatorIsAtPoints(op, &is_at_points));
7021b95d8c6SJeremy L Thompson   CeedCheck(!is_at_points, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
7031b95d8c6SJeremy L Thompson             "Backend does not implement CeedOperatorLinearAssemble for AtPoints operator");
7041b95d8c6SJeremy L Thompson 
705eaf62fffSJeremy L Thompson   // Assemble QFunction
706506b1a0cSSebastian Grimberg   CeedInt             layout_qf[3];
7071c66c397SJeremy L Thompson   const CeedScalar   *assembled_qf_array;
708c5f45aeaSJeremy L Thompson   CeedVector          assembled_qf        = NULL;
709506b1a0cSSebastian Grimberg   CeedElemRestriction assembled_elem_rstr = NULL;
710eaf62fffSJeremy L Thompson 
711506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, CEED_REQUEST_IMMEDIATE));
71256c48462SJeremy L Thompson   CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf));
713506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr));
714506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
715eaf62fffSJeremy L Thompson 
716ed9e99e6SJeremy L Thompson   // Get assembly data
717506b1a0cSSebastian Grimberg   CeedInt                  num_elem_in, elem_size_in, num_comp_in, num_qpts_in;
71881670346SSebastian Grimberg   CeedInt                  num_elem_out, elem_size_out, num_comp_out, num_qpts_out;
71981670346SSebastian Grimberg   CeedSize                 local_num_entries, count = 0;
720506b1a0cSSebastian Grimberg   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
721506b1a0cSSebastian Grimberg   CeedInt                  num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out;
722506b1a0cSSebastian Grimberg   CeedBasis               *active_bases_in, *active_bases_out, basis_in, basis_out;
723506b1a0cSSebastian Grimberg   const CeedScalar       **B_mats_in, **B_mats_out, *B_mat_in, *B_mat_out;
724506b1a0cSSebastian Grimberg   CeedElemRestriction      elem_rstr_in, elem_rstr_out;
725506b1a0cSSebastian Grimberg   CeedRestrictionType      elem_rstr_type_in, elem_rstr_type_out;
726506b1a0cSSebastian Grimberg   const bool              *elem_rstr_orients_in = NULL, *elem_rstr_orients_out = NULL;
727506b1a0cSSebastian Grimberg   const CeedInt8          *elem_rstr_curl_orients_in = NULL, *elem_rstr_curl_orients_out = NULL;
728506b1a0cSSebastian Grimberg   CeedOperatorAssemblyData data;
729eaf62fffSJeremy L Thompson 
730506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
731506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, NULL, &num_active_bases_out,
732506b1a0cSSebastian Grimberg                                                 &num_eval_modes_out, &eval_modes_out, NULL, NULL));
733506b1a0cSSebastian Grimberg 
7349bc66399SJeremy L Thompson   CeedCheck(num_active_bases_in == 1 && num_active_bases_out == 1, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
735506b1a0cSSebastian Grimberg             "Cannot assemble operator with multiple active bases");
7369bc66399SJeremy L Thompson   CeedCheck(num_eval_modes_in[0] > 0 && num_eval_modes_out[0] > 0, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
7379bc66399SJeremy L Thompson             "Cannot assemble operator without inputs/outputs");
738eaf62fffSJeremy L Thompson 
739506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, &B_mats_in, NULL, &active_bases_out, &B_mats_out));
740506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out));
741506b1a0cSSebastian Grimberg   basis_in  = active_bases_in[0];
742506b1a0cSSebastian Grimberg   basis_out = active_bases_out[0];
743506b1a0cSSebastian Grimberg   B_mat_in  = B_mats_in[0];
744506b1a0cSSebastian Grimberg   B_mat_out = B_mats_out[0];
745eaf62fffSJeremy L Thompson 
746506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in));
747506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in));
748506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in));
749506b1a0cSSebastian Grimberg   if (basis_in == CEED_BASIS_NONE) num_qpts_in = elem_size_in;
750506b1a0cSSebastian Grimberg   else CeedCall(CeedBasisGetNumQuadraturePoints(basis_in, &num_qpts_in));
751506b1a0cSSebastian Grimberg 
752506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetType(elem_rstr_in, &elem_rstr_type_in));
753506b1a0cSSebastian Grimberg   if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) {
754506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_orients_in));
755506b1a0cSSebastian Grimberg   } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) {
756506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_curl_orients_in));
7577c1dbaffSSebastian Grimberg   }
7587c1dbaffSSebastian Grimberg 
759506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
760506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out));
7619bc66399SJeremy L Thompson     CeedCheck(num_elem_in == num_elem_out, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
7623f08121cSJeremy L Thompson               "Active input and output operator restrictions must have the same number of elements."
7633f08121cSJeremy L Thompson               " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.",
7643f08121cSJeremy L Thompson               num_elem_in, num_elem_out);
765506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out));
766506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out));
767506b1a0cSSebastian Grimberg     if (basis_out == CEED_BASIS_NONE) num_qpts_out = elem_size_out;
768506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(basis_out, &num_qpts_out));
7699bc66399SJeremy L Thompson     CeedCheck(num_qpts_in == num_qpts_out, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
7703f08121cSJeremy L Thompson               "Active input and output bases must have the same number of quadrature points."
7713f08121cSJeremy L Thompson               " Input has %" CeedInt_FMT " points; output has %" CeedInt_FMT "points.",
7723f08121cSJeremy L Thompson               num_qpts_in, num_qpts_out);
773eaf62fffSJeremy L Thompson 
774506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetType(elem_rstr_out, &elem_rstr_type_out));
775506b1a0cSSebastian Grimberg     if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) {
776506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_orients_out));
777506b1a0cSSebastian Grimberg     } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) {
778506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_curl_orients_out));
779506b1a0cSSebastian Grimberg     }
780506b1a0cSSebastian Grimberg   } else {
781506b1a0cSSebastian Grimberg     num_elem_out  = num_elem_in;
782506b1a0cSSebastian Grimberg     elem_size_out = elem_size_in;
783506b1a0cSSebastian Grimberg     num_comp_out  = num_comp_in;
784506b1a0cSSebastian Grimberg     num_qpts_out  = num_qpts_in;
785506b1a0cSSebastian Grimberg 
786506b1a0cSSebastian Grimberg     elem_rstr_orients_out      = elem_rstr_orients_in;
787506b1a0cSSebastian Grimberg     elem_rstr_curl_orients_out = elem_rstr_curl_orients_in;
788506b1a0cSSebastian Grimberg   }
789c81f2b9dSJames Wright   local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in;
790506b1a0cSSebastian Grimberg 
791506b1a0cSSebastian Grimberg   // Loop over elements and put in data structure
7927c1dbaffSSebastian Grimberg   // We store B_mat_in, B_mat_out, BTD, elem_mat in row-major order
7930459ebd3SSebastian Grimberg   CeedTensorContract contract;
794123d890dSSebastian Grimberg   CeedScalar        *vals, *BTD_mat = NULL, *elem_mat = NULL, *elem_mat_b = NULL;
795506b1a0cSSebastian Grimberg 
796c22497adSSebastian Grimberg   CeedCall(CeedBasisGetTensorContract(basis_in, &contract));
797123d890dSSebastian Grimberg   CeedCall(CeedCalloc(elem_size_out * num_qpts_in * num_eval_modes_in[0], &BTD_mat));
798123d890dSSebastian Grimberg   CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat));
799506b1a0cSSebastian Grimberg   if (elem_rstr_curl_orients_in || elem_rstr_curl_orients_out) CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat_b));
8001c66c397SJeremy L Thompson 
80128ec399dSJeremy L Thompson   CeedCall(CeedVectorGetArray(values, CEED_MEM_HOST, &vals));
802506b1a0cSSebastian Grimberg   for (CeedSize e = 0; e < num_elem_in; e++) {
803506b1a0cSSebastian Grimberg     for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) {
804506b1a0cSSebastian Grimberg       for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) {
805ed9e99e6SJeremy L Thompson         // Compute B^T*D
806506b1a0cSSebastian Grimberg         for (CeedSize n = 0; n < elem_size_out; n++) {
807506b1a0cSSebastian Grimberg           for (CeedSize q = 0; q < num_qpts_in; q++) {
808437c7c90SJeremy L Thompson             for (CeedInt e_in = 0; e_in < num_eval_modes_in[0]; e_in++) {
809506b1a0cSSebastian Grimberg               const CeedSize btd_index = n * (num_qpts_in * num_eval_modes_in[0]) + q * num_eval_modes_in[0] + e_in;
810067fd99fSJeremy L Thompson               CeedScalar     sum       = 0.0;
8111c66c397SJeremy L Thompson 
812437c7c90SJeremy L Thompson               for (CeedInt e_out = 0; e_out < num_eval_modes_out[0]; e_out++) {
813506b1a0cSSebastian Grimberg                 const CeedSize b_out_index     = (q * num_eval_modes_out[0] + e_out) * elem_size_out + n;
814506b1a0cSSebastian Grimberg                 const CeedSize eval_mode_index = ((e_in * num_comp_in + comp_in) * num_eval_modes_out[0] + e_out) * num_comp_out + comp_out;
815b94338b9SJed Brown                 const CeedSize qf_index        = q * layout_qf[0] + eval_mode_index * layout_qf[1] + e * layout_qf[2];
8161c66c397SJeremy L Thompson 
817067fd99fSJeremy L Thompson                 sum += B_mat_out[b_out_index] * assembled_qf_array[qf_index];
818eaf62fffSJeremy L Thompson               }
819067fd99fSJeremy L Thompson               BTD_mat[btd_index] = sum;
820ed9e99e6SJeremy L Thompson             }
821ed9e99e6SJeremy L Thompson           }
822eaf62fffSJeremy L Thompson         }
8237c1dbaffSSebastian Grimberg 
8247c1dbaffSSebastian Grimberg         // Form element matrix itself (for each block component)
825e4065a52SSebastian Grimberg         if (contract) {
8260459ebd3SSebastian Grimberg           CeedCall(CeedTensorContractApply(contract, 1, num_qpts_in * num_eval_modes_in[0], elem_size_in, elem_size_out, BTD_mat, CEED_NOTRANSPOSE,
8270459ebd3SSebastian Grimberg                                            false, B_mat_in, elem_mat));
828e4065a52SSebastian Grimberg         } else {
8299bc66399SJeremy L Thompson           Ceed ceed;
8309bc66399SJeremy L Thompson 
8319bc66399SJeremy L Thompson           CeedCall(CeedOperatorGetCeed(op, &ceed));
832e4065a52SSebastian Grimberg           CeedCall(CeedMatrixMatrixMultiply(ceed, BTD_mat, B_mat_in, elem_mat, elem_size_out, elem_size_in, num_qpts_in * num_eval_modes_in[0]));
8339bc66399SJeremy L Thompson           CeedCall(CeedDestroy(&ceed));
834e4065a52SSebastian Grimberg         }
835eaf62fffSJeremy L Thompson 
8367c1dbaffSSebastian Grimberg         // Transform the element matrix if required
837506b1a0cSSebastian Grimberg         if (elem_rstr_orients_out) {
838506b1a0cSSebastian Grimberg           const bool *elem_orients = &elem_rstr_orients_out[e * elem_size_out];
8391c66c397SJeremy L Thompson 
840506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
841506b1a0cSSebastian Grimberg             const double orient = elem_orients[i] ? -1.0 : 1.0;
842506b1a0cSSebastian Grimberg 
843506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
844506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] *= orient;
8457c1dbaffSSebastian Grimberg             }
8467c1dbaffSSebastian Grimberg           }
847506b1a0cSSebastian Grimberg         } else if (elem_rstr_curl_orients_out) {
848506b1a0cSSebastian Grimberg           const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_out[e * 3 * elem_size_out];
8491c66c397SJeremy L Thompson 
8507c1dbaffSSebastian Grimberg           // T^T*(B^T*D*B)
851506b1a0cSSebastian Grimberg           memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar));
852506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
853506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
854506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * i + 1] +
855506b1a0cSSebastian Grimberg                                                (i > 0 ? elem_mat_b[(i - 1) * elem_size_in + j] * elem_curl_orients[3 * i - 1] : 0.0) +
856506b1a0cSSebastian Grimberg                                                (i < elem_size_out - 1 ? elem_mat_b[(i + 1) * elem_size_in + j] * elem_curl_orients[3 * i + 3] : 0.0);
8577c1dbaffSSebastian Grimberg             }
8587c1dbaffSSebastian Grimberg           }
859506b1a0cSSebastian Grimberg         }
860506b1a0cSSebastian Grimberg         if (elem_rstr_orients_in) {
861506b1a0cSSebastian Grimberg           const bool *elem_orients = &elem_rstr_orients_in[e * elem_size_in];
862506b1a0cSSebastian Grimberg 
863506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
864506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
865506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] *= elem_orients[j] ? -1.0 : 1.0;
866506b1a0cSSebastian Grimberg             }
867506b1a0cSSebastian Grimberg           }
868506b1a0cSSebastian Grimberg         } else if (elem_rstr_curl_orients_in) {
869506b1a0cSSebastian Grimberg           const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_in[e * 3 * elem_size_in];
870506b1a0cSSebastian Grimberg 
871506b1a0cSSebastian Grimberg           // (B^T*D*B)*T
872506b1a0cSSebastian Grimberg           memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar));
873506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
874506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
875506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * j + 1] +
876506b1a0cSSebastian Grimberg                                                (j > 0 ? elem_mat_b[i * elem_size_in + j - 1] * elem_curl_orients[3 * j - 1] : 0.0) +
877506b1a0cSSebastian Grimberg                                                (j < elem_size_in - 1 ? elem_mat_b[i * elem_size_in + j + 1] * elem_curl_orients[3 * j + 3] : 0.0);
8787c1dbaffSSebastian Grimberg             }
8797c1dbaffSSebastian Grimberg           }
8807c1dbaffSSebastian Grimberg         }
8817c1dbaffSSebastian Grimberg 
8827c1dbaffSSebastian Grimberg         // Put element matrix in coordinate data structure
883506b1a0cSSebastian Grimberg         for (CeedInt i = 0; i < elem_size_out; i++) {
884506b1a0cSSebastian Grimberg           for (CeedInt j = 0; j < elem_size_in; j++) {
885506b1a0cSSebastian Grimberg             vals[offset + count] = elem_mat[i * elem_size_in + j];
886eaf62fffSJeremy L Thompson             count++;
887eaf62fffSJeremy L Thompson           }
888eaf62fffSJeremy L Thompson         }
889eaf62fffSJeremy L Thompson       }
890eaf62fffSJeremy L Thompson     }
891eaf62fffSJeremy L Thompson   }
8929bc66399SJeremy L Thompson   CeedCheck(count == local_num_entries, CeedOperatorReturnCeed(op), CEED_ERROR_MAJOR, "Error computing entries");
8932b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArray(values, &vals));
894eaf62fffSJeremy L Thompson 
895506b1a0cSSebastian Grimberg   // Cleanup
896123d890dSSebastian Grimberg   CeedCall(CeedFree(&BTD_mat));
897123d890dSSebastian Grimberg   CeedCall(CeedFree(&elem_mat));
898506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&elem_mat_b));
899506b1a0cSSebastian Grimberg   if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) {
900506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_in, &elem_rstr_orients_in));
901506b1a0cSSebastian Grimberg   } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) {
902506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_in, &elem_rstr_curl_orients_in));
903506b1a0cSSebastian Grimberg   }
904506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
905506b1a0cSSebastian Grimberg     if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) {
906506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_out, &elem_rstr_orients_out));
907506b1a0cSSebastian Grimberg     } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) {
908506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_out, &elem_rstr_curl_orients_out));
909506b1a0cSSebastian Grimberg     }
910506b1a0cSSebastian Grimberg   }
9112b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
9122b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
913681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in));
914681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out));
915eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
916eaf62fffSJeremy L Thompson }
917eaf62fffSJeremy L Thompson 
918eaf62fffSJeremy L Thompson /**
919ca94c3ddSJeremy L Thompson   @brief Count number of entries for assembled `CeedOperator`
920eaf62fffSJeremy L Thompson 
921ca94c3ddSJeremy L Thompson   @param[in]  op          `CeedOperator` to assemble
922eaf62fffSJeremy L Thompson   @param[out] num_entries Number of entries in assembled representation
923eaf62fffSJeremy L Thompson 
924eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
925eaf62fffSJeremy L Thompson 
926eaf62fffSJeremy L Thompson   @ref Utility
927eaf62fffSJeremy L Thompson **/
928ed094490SJeremy L Thompson static int CeedOperatorAssemblyCountEntriesSingle(CeedOperator op, CeedSize *num_entries) {
929b275c451SJeremy L Thompson   bool                is_composite;
930506b1a0cSSebastian Grimberg   CeedInt             num_elem_in, elem_size_in, num_comp_in, num_elem_out, elem_size_out, num_comp_out;
931506b1a0cSSebastian Grimberg   CeedElemRestriction rstr_in, rstr_out;
932eaf62fffSJeremy L Thompson 
933b275c451SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
9349bc66399SJeremy L Thompson   CeedCheck(!is_composite, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
935506b1a0cSSebastian Grimberg 
936506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &rstr_in, &rstr_out));
937506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(rstr_in, &num_elem_in));
938506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(rstr_in, &elem_size_in));
939506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(rstr_in, &num_comp_in));
940506b1a0cSSebastian Grimberg   if (rstr_in != rstr_out) {
941506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(rstr_out, &num_elem_out));
9429bc66399SJeremy L Thompson     CeedCheck(num_elem_in == num_elem_out, CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED,
9433f08121cSJeremy L Thompson               "Active input and output operator restrictions must have the same number of elements."
9443f08121cSJeremy L Thompson               " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.",
9453f08121cSJeremy L Thompson               num_elem_in, num_elem_out);
946506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(rstr_out, &elem_size_out));
947506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(rstr_out, &num_comp_out));
948506b1a0cSSebastian Grimberg   } else {
949506b1a0cSSebastian Grimberg     num_elem_out  = num_elem_in;
950506b1a0cSSebastian Grimberg     elem_size_out = elem_size_in;
951506b1a0cSSebastian Grimberg     num_comp_out  = num_comp_in;
952506b1a0cSSebastian Grimberg   }
953681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_in));
954681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_out));
955506b1a0cSSebastian Grimberg   *num_entries = (CeedSize)elem_size_in * num_comp_in * elem_size_out * num_comp_out * num_elem_in;
956eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
957eaf62fffSJeremy L Thompson }
958eaf62fffSJeremy L Thompson 
959eaf62fffSJeremy L Thompson /**
96056318ee4SZach Atkins   @brief Count number of entries for assembled `CeedOperator`
96156318ee4SZach Atkins 
96256318ee4SZach Atkins   @param[in]  op          `CeedOperator` to assemble
96356318ee4SZach Atkins   @param[out] num_entries Number of entries in assembled representation
96456318ee4SZach Atkins 
96556318ee4SZach Atkins   @return An error code: 0 - success, otherwise - failure
96656318ee4SZach Atkins 
96756318ee4SZach Atkins   @ref Utility
96856318ee4SZach Atkins **/
96956318ee4SZach Atkins int CeedOperatorLinearAssembleGetNumEntries(CeedOperator op, CeedSize *num_entries) {
97056318ee4SZach Atkins   bool is_composite;
97156318ee4SZach Atkins 
97256318ee4SZach Atkins   CeedCall(CeedOperatorCheckReady(op));
97356318ee4SZach Atkins   CeedCall(CeedOperatorIsComposite(op, &is_composite));
97456318ee4SZach Atkins 
97556318ee4SZach Atkins   if (is_composite) {
97656318ee4SZach Atkins     CeedInt       num_suboperators;
97756318ee4SZach Atkins     CeedOperator *sub_operators;
97856318ee4SZach Atkins 
97956318ee4SZach Atkins     CeedCall(CeedOperatorCompositeGetNumSub(op, &num_suboperators));
98056318ee4SZach Atkins     CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
98156318ee4SZach Atkins 
98256318ee4SZach Atkins     *num_entries = 0;
98356318ee4SZach Atkins     for (CeedInt k = 0; k < num_suboperators; ++k) {
98456318ee4SZach Atkins       CeedSize single_entries;
98556318ee4SZach Atkins 
98656318ee4SZach Atkins       CeedCall(CeedOperatorAssemblyCountEntriesSingle(sub_operators[k], &single_entries));
98756318ee4SZach Atkins       *num_entries += single_entries;
98856318ee4SZach Atkins     }
98956318ee4SZach Atkins   } else {
99056318ee4SZach Atkins     CeedCall(CeedOperatorAssemblyCountEntriesSingle(op, num_entries));
99156318ee4SZach Atkins   }
99256318ee4SZach Atkins   return CEED_ERROR_SUCCESS;
99356318ee4SZach Atkins }
99456318ee4SZach Atkins 
99556318ee4SZach Atkins /**
996ca94c3ddSJeremy L Thompson   @brief Common code for creating a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator`
997eaf62fffSJeremy L Thompson 
998ca94c3ddSJeremy L Thompson   @param[in]  op_fine      Fine grid `CeedOperator`
999ca94c3ddSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator`
1000ca94c3ddSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid `CeedElemRestriction`
1001ca94c3ddSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector `CeedBasis`
1002ca94c3ddSJeremy L Thompson   @param[in]  basis_c_to_f `CeedBasis` for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction operators
1003ca94c3ddSJeremy L Thompson   @param[out] op_coarse    Coarse grid `CeedOperator`
1004ca94c3ddSJeremy L Thompson   @param[out] op_prolong   Coarse to fine `CeedOperator`, or `NULL`
1005ca94c3ddSJeremy L Thompson   @param[out] op_restrict  Fine to coarse `CeedOperator`, or `NULL`
1006eaf62fffSJeremy L Thompson 
1007eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1008eaf62fffSJeremy L Thompson 
1009eaf62fffSJeremy L Thompson   @ref Developer
1010eaf62fffSJeremy L Thompson **/
1011ed094490SJeremy L Thompson static int CeedOperatorMultigridLevelCreateSingle_Core(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse,
1012ed094490SJeremy L Thompson                                                        CeedBasis basis_coarse, CeedBasis basis_c_to_f, CeedOperator *op_coarse,
1013ed094490SJeremy L Thompson                                                        CeedOperator *op_prolong, CeedOperator *op_restrict) {
10141c66c397SJeremy L Thompson   bool                is_composite;
1015eaf62fffSJeremy L Thompson   Ceed                ceed;
10161203703bSJeremy L Thompson   CeedInt             num_comp, num_input_fields, num_output_fields;
101785bb9dcfSJeremy L Thompson   CeedVector          mult_vec         = NULL;
10181c66c397SJeremy L Thompson   CeedElemRestriction rstr_p_mult_fine = NULL, rstr_fine = NULL;
10191203703bSJeremy L Thompson   CeedOperatorField  *input_fields, *output_fields;
10201c66c397SJeremy L Thompson 
10212b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
1022eaf62fffSJeremy L Thompson 
1023eaf62fffSJeremy L Thompson   // Check for composite operator
10242b730f8bSJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op_fine, &is_composite));
10256574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Automatic multigrid setup for composite operators not supported");
1026eaf62fffSJeremy L Thompson 
1027eaf62fffSJeremy L Thompson   // Coarse Grid
102899641342SJeremy L Thompson   {
102999641342SJeremy L Thompson     bool is_at_points;
103099641342SJeremy L Thompson 
103199641342SJeremy L Thompson     CeedCall(CeedOperatorIsAtPoints(op_fine, &is_at_points));
103299641342SJeremy L Thompson     if (is_at_points) {
103399641342SJeremy L Thompson       CeedVector          point_coords;
103499641342SJeremy L Thompson       CeedElemRestriction rstr_points;
103599641342SJeremy L Thompson 
103699641342SJeremy L Thompson       CeedCall(CeedOperatorCreateAtPoints(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse));
103799641342SJeremy L Thompson       CeedCall(CeedOperatorAtPointsGetPoints(op_fine, &rstr_points, &point_coords));
103899641342SJeremy L Thompson       CeedCall(CeedOperatorAtPointsSetPoints(*op_coarse, rstr_points, point_coords));
103999641342SJeremy L Thompson       CeedCall(CeedVectorDestroy(&point_coords));
104099641342SJeremy L Thompson       CeedCall(CeedElemRestrictionDestroy(&rstr_points));
104199641342SJeremy L Thompson     } else {
10422b730f8bSJeremy L Thompson       CeedCall(CeedOperatorCreate(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse));
104399641342SJeremy L Thompson     }
104499641342SJeremy L Thompson   }
10451203703bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op_fine, &num_input_fields, &input_fields, &num_output_fields, &output_fields));
1046eaf62fffSJeremy L Thompson   // -- Clone input fields
10471203703bSJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
10486f8994e9SJeremy L Thompson     const char         *field_name;
10491203703bSJeremy L Thompson     CeedVector          vec;
1050681d0ea7SJeremy L Thompson     CeedElemRestriction rstr  = NULL;
1051681d0ea7SJeremy L Thompson     CeedBasis           basis = NULL;
10521203703bSJeremy L Thompson 
10531203703bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetName(input_fields[i], &field_name));
10541203703bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(input_fields[i], &vec));
10551203703bSJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
1056681d0ea7SJeremy L Thompson       CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr));
1057681d0ea7SJeremy L Thompson       CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis));
1058681d0ea7SJeremy L Thompson       if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr_fine));
1059eaf62fffSJeremy L Thompson     } else {
10601203703bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr));
10611203703bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(input_fields[i], &basis));
1062eaf62fffSJeremy L Thompson     }
10631203703bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec));
1064681d0ea7SJeremy L Thompson     CeedCall(CeedVectorDestroy(&vec));
1065681d0ea7SJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr));
1066681d0ea7SJeremy L Thompson     CeedCall(CeedBasisDestroy(&basis));
1067eaf62fffSJeremy L Thompson   }
1068eaf62fffSJeremy L Thompson   // -- Clone output fields
10691203703bSJeremy L Thompson   for (CeedInt i = 0; i < num_output_fields; i++) {
10706f8994e9SJeremy L Thompson     const char         *field_name;
10711203703bSJeremy L Thompson     CeedVector          vec;
1072681d0ea7SJeremy L Thompson     CeedElemRestriction rstr  = NULL;
1073681d0ea7SJeremy L Thompson     CeedBasis           basis = NULL;
10741203703bSJeremy L Thompson 
10751203703bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetName(output_fields[i], &field_name));
10761203703bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(output_fields[i], &vec));
10771203703bSJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
1078681d0ea7SJeremy L Thompson       CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr));
1079681d0ea7SJeremy L Thompson       CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis));
1080681d0ea7SJeremy L Thompson       if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr_fine));
1081eaf62fffSJeremy L Thompson     } else {
10821203703bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr));
10831203703bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(output_fields[i], &basis));
1084eaf62fffSJeremy L Thompson     }
10851203703bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec));
1086681d0ea7SJeremy L Thompson     CeedCall(CeedVectorDestroy(&vec));
1087681d0ea7SJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr));
1088681d0ea7SJeremy L Thompson     CeedCall(CeedBasisDestroy(&basis));
1089eaf62fffSJeremy L Thompson   }
1090af99e877SJeremy L Thompson   // -- Clone QFunctionAssemblyData
10917d5185d7SSebastian Grimberg   {
10927d5185d7SSebastian Grimberg     CeedQFunctionAssemblyData fine_data;
10937d5185d7SSebastian Grimberg 
10947d5185d7SSebastian Grimberg     CeedCall(CeedOperatorGetQFunctionAssemblyData(op_fine, &fine_data));
10957d5185d7SSebastian Grimberg     CeedCall(CeedQFunctionAssemblyDataReferenceCopy(fine_data, &(*op_coarse)->qf_assembled));
10967d5185d7SSebastian Grimberg   }
1097eaf62fffSJeremy L Thompson 
1098eaf62fffSJeremy L Thompson   // Multiplicity vector
10997758292fSSebastian Grimberg   if (op_restrict || op_prolong) {
1100*32db0c4dSJeremy L Thompson     CeedInt             num_elem, num_comp, elem_size;
1101*32db0c4dSJeremy L Thompson     CeedVector          mult_l_vec, mult_e_vec;
11021c66c397SJeremy L Thompson     CeedRestrictionType rstr_type;
1103*32db0c4dSJeremy L Thompson     CeedElemRestriction rstr_p_mult_full;
110485bb9dcfSJeremy L Thompson 
11057c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionGetType(rstr_fine, &rstr_type));
11067c1dbaffSSebastian Grimberg     CeedCheck(rstr_type != CEED_RESTRICTION_CURL_ORIENTED, ceed, CEED_ERROR_UNSUPPORTED,
11077c1dbaffSSebastian Grimberg               "Element restrictions created with CeedElemRestrictionCreateCurlOriented are not supported");
11086574a04fSJeremy L Thompson     CeedCheck(p_mult_fine, ceed, CEED_ERROR_INCOMPATIBLE, "Prolongation or restriction operator creation requires fine grid multiplicity vector");
1109*32db0c4dSJeremy L Thompson 
1110*32db0c4dSJeremy L Thompson     // Create multiplicity multi-component l-vector
1111*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateUnsignedCopy(rstr_fine, &rstr_p_mult_full));
1112*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(rstr_fine, &mult_l_vec, &mult_e_vec));
11132b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_e_vec, 0.0));
1114*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_full, CEED_NOTRANSPOSE, p_mult_fine, mult_e_vec, CEED_REQUEST_IMMEDIATE));
1115*32db0c4dSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_l_vec, 0.0));
1116*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_full, CEED_TRANSPOSE, mult_e_vec, mult_l_vec, CEED_REQUEST_IMMEDIATE));
1117*32db0c4dSJeremy L Thompson     CeedCall(CeedVectorReciprocal(mult_l_vec));
1118*32db0c4dSJeremy L Thompson 
1119*32db0c4dSJeremy L Thompson     // Create multiplicity single component e-vector
1120*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionGetNumElements(rstr_p_mult_full, &num_elem));
1121*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionGetNumComponents(rstr_p_mult_full, &num_comp));
1122*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_p_mult_full, &elem_size));
1123*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateStrided(ceed, num_elem, elem_size, 1, num_elem * elem_size, CEED_STRIDES_BACKEND, &rstr_p_mult_fine));
1124*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(rstr_p_mult_fine, &mult_vec, NULL));
1125*32db0c4dSJeremy L Thompson     {
1126*32db0c4dSJeremy L Thompson       CeedQFunction qf_to_scalar;
1127*32db0c4dSJeremy L Thompson       CeedOperator  op_to_scalar;
1128*32db0c4dSJeremy L Thompson 
1129*32db0c4dSJeremy L Thompson       CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Identity to scalar", &qf_to_scalar));
1130*32db0c4dSJeremy L Thompson       CeedCall(CeedQFunctionAddInput(qf_to_scalar, "input", num_comp, CEED_EVAL_NONE));
1131*32db0c4dSJeremy L Thompson       CeedCall(CeedQFunctionAddOutput(qf_to_scalar, "output", 1, CEED_EVAL_NONE));
1132*32db0c4dSJeremy L Thompson 
1133*32db0c4dSJeremy L Thompson       CeedCall(CeedOperatorCreate(ceed, qf_to_scalar, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, &op_to_scalar));
1134*32db0c4dSJeremy L Thompson       CeedCall(CeedOperatorSetField(op_to_scalar, "input", rstr_p_mult_full, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
1135*32db0c4dSJeremy L Thompson       CeedCall(CeedOperatorSetField(op_to_scalar, "output", rstr_p_mult_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
1136*32db0c4dSJeremy L Thompson 
1137*32db0c4dSJeremy L Thompson       CeedCall(CeedOperatorApply(op_to_scalar, mult_l_vec, mult_vec, CEED_REQUEST_IMMEDIATE));
1138*32db0c4dSJeremy L Thompson 
1139*32db0c4dSJeremy L Thompson       // Clean-up
1140*32db0c4dSJeremy L Thompson       CeedCall(CeedQFunctionDestroy(&qf_to_scalar));
1141*32db0c4dSJeremy L Thompson       CeedCall(CeedOperatorDestroy(&op_to_scalar));
1142*32db0c4dSJeremy L Thompson     }
1143*32db0c4dSJeremy L Thompson     // Clean-up
11442b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&mult_e_vec));
1145*32db0c4dSJeremy L Thompson     CeedCall(CeedVectorDestroy(&mult_l_vec));
1146*32db0c4dSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_full));
114785bb9dcfSJeremy L Thompson   }
1148eaf62fffSJeremy L Thompson 
1149addd79feSZach Atkins   // Clone name
1150addd79feSZach Atkins   bool   has_name = op_fine->name;
1151addd79feSZach Atkins   size_t name_len = op_fine->name ? strlen(op_fine->name) : 0;
1152addd79feSZach Atkins   CeedCall(CeedOperatorSetName(*op_coarse, op_fine->name));
1153addd79feSZach Atkins 
11547758292fSSebastian Grimberg   // Check that coarse to fine basis is provided if prolong/restrict operators are requested
11557758292fSSebastian Grimberg   CeedCheck(basis_c_to_f || (!op_restrict && !op_prolong), ceed, CEED_ERROR_INCOMPATIBLE,
11566574a04fSJeremy L Thompson             "Prolongation or restriction operator creation requires coarse-to-fine basis");
115783d6adf3SZach Atkins 
115885bb9dcfSJeremy L Thompson   // Restriction/Prolongation Operators
11592b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis_coarse, &num_comp));
1160addd79feSZach Atkins 
1161addd79feSZach Atkins   // Restriction
11627758292fSSebastian Grimberg   if (op_restrict) {
1163eaf62fffSJeremy L Thompson     CeedInt             *num_comp_r_data;
116485bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_r;
11657758292fSSebastian Grimberg     CeedQFunction        qf_restrict;
116685bb9dcfSJeremy L Thompson 
1167*32db0c4dSJeremy L Thompson     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale (scalar)", &qf_restrict));
11682b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_r_data));
1169eaf62fffSJeremy L Thompson     num_comp_r_data[0] = num_comp;
11702b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_r));
11712b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_r, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_r_data), num_comp_r_data));
11727758292fSSebastian Grimberg     CeedCall(CeedQFunctionSetContext(qf_restrict, ctx_r));
11732b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_r));
11747758292fSSebastian Grimberg     CeedCall(CeedQFunctionAddInput(qf_restrict, "input", num_comp, CEED_EVAL_NONE));
1175*32db0c4dSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_restrict, "scale", 1, CEED_EVAL_NONE));
11767758292fSSebastian Grimberg     CeedCall(CeedQFunctionAddOutput(qf_restrict, "output", num_comp, CEED_EVAL_INTERP));
11777758292fSSebastian Grimberg     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_restrict, num_comp));
1178eaf62fffSJeremy L Thompson 
11797758292fSSebastian Grimberg     CeedCall(CeedOperatorCreate(ceed, qf_restrict, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_restrict));
11807758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "input", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
11817758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec));
11827758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "output", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
1183eaf62fffSJeremy L Thompson 
1184addd79feSZach Atkins     // Set name
1185addd79feSZach Atkins     char *restriction_name;
11861c66c397SJeremy L Thompson 
1187addd79feSZach Atkins     CeedCall(CeedCalloc(17 + name_len, &restriction_name));
1188addd79feSZach Atkins     sprintf(restriction_name, "restriction%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
11897758292fSSebastian Grimberg     CeedCall(CeedOperatorSetName(*op_restrict, restriction_name));
1190addd79feSZach Atkins     CeedCall(CeedFree(&restriction_name));
1191addd79feSZach Atkins 
1192addd79feSZach Atkins     // Check
11937758292fSSebastian Grimberg     CeedCall(CeedOperatorCheckReady(*op_restrict));
1194addd79feSZach Atkins 
1195addd79feSZach Atkins     // Cleanup
11967758292fSSebastian Grimberg     CeedCall(CeedQFunctionDestroy(&qf_restrict));
1197addd79feSZach Atkins   }
1198addd79feSZach Atkins 
1199eaf62fffSJeremy L Thompson   // Prolongation
1200addd79feSZach Atkins   if (op_prolong) {
1201eaf62fffSJeremy L Thompson     CeedInt             *num_comp_p_data;
120285bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_p;
12031c66c397SJeremy L Thompson     CeedQFunction        qf_prolong;
120485bb9dcfSJeremy L Thompson 
1205*32db0c4dSJeremy L Thompson     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale (scalar)", &qf_prolong));
12062b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_p_data));
1207eaf62fffSJeremy L Thompson     num_comp_p_data[0] = num_comp;
12082b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_p));
12092b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_p, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_p_data), num_comp_p_data));
12102b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(qf_prolong, ctx_p));
12112b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_p));
12122b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "input", num_comp, CEED_EVAL_INTERP));
1213*32db0c4dSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "scale", 1, CEED_EVAL_NONE));
12142b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(qf_prolong, "output", num_comp, CEED_EVAL_NONE));
12152b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_prolong, num_comp));
1216eaf62fffSJeremy L Thompson 
12172b730f8bSJeremy L Thompson     CeedCall(CeedOperatorCreate(ceed, qf_prolong, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_prolong));
12182b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "input", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
1219356036faSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec));
1220356036faSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "output", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
1221eaf62fffSJeremy L Thompson 
1222addd79feSZach Atkins     // Set name
1223ea6b5821SJeremy L Thompson     char *prolongation_name;
12241c66c397SJeremy L Thompson 
12252b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(18 + name_len, &prolongation_name));
12262b730f8bSJeremy L Thompson     sprintf(prolongation_name, "prolongation%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
12272b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetName(*op_prolong, prolongation_name));
12282b730f8bSJeremy L Thompson     CeedCall(CeedFree(&prolongation_name));
1229addd79feSZach Atkins 
1230addd79feSZach Atkins     // Check
1231addd79feSZach Atkins     CeedCall(CeedOperatorCheckReady(*op_prolong));
1232addd79feSZach Atkins 
1233addd79feSZach Atkins     // Cleanup
1234addd79feSZach Atkins     CeedCall(CeedQFunctionDestroy(&qf_prolong));
1235ea6b5821SJeremy L Thompson   }
1236ea6b5821SJeremy L Thompson 
123758e4b056SJeremy L Thompson   // Check
123858e4b056SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(*op_coarse));
123958e4b056SJeremy L Thompson 
1240eaf62fffSJeremy L Thompson   // Cleanup
12419bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
12422b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&mult_vec));
1243681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_fine));
1244c17ec2beSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_fine));
12452b730f8bSJeremy L Thompson   CeedCall(CeedBasisDestroy(&basis_c_to_f));
1246eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1247eaf62fffSJeremy L Thompson }
1248eaf62fffSJeremy L Thompson 
1249eaf62fffSJeremy L Thompson /**
1250eaf62fffSJeremy L Thompson   @brief Build 1D mass matrix and Laplacian with perturbation
1251eaf62fffSJeremy L Thompson 
1252eaf62fffSJeremy L Thompson   @param[in]  interp_1d   Interpolation matrix in one dimension
1253eaf62fffSJeremy L Thompson   @param[in]  grad_1d     Gradient matrix in one dimension
1254eaf62fffSJeremy L Thompson   @param[in]  q_weight_1d Quadrature weights in one dimension
1255eaf62fffSJeremy L Thompson   @param[in]  P_1d        Number of basis nodes in one dimension
1256eaf62fffSJeremy L Thompson   @param[in]  Q_1d        Number of quadrature points in one dimension
1257eaf62fffSJeremy L Thompson   @param[in]  dim         Dimension of basis
1258eaf62fffSJeremy L Thompson   @param[out] mass        Assembled mass matrix in one dimension
1259eaf62fffSJeremy L Thompson   @param[out] laplace     Assembled perturbed Laplacian in one dimension
1260eaf62fffSJeremy L Thompson 
1261eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1262eaf62fffSJeremy L Thompson 
1263eaf62fffSJeremy L Thompson   @ref Developer
1264eaf62fffSJeremy L Thompson **/
12652c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOff
12662c2ea1dbSJeremy L Thompson static int CeedBuildMassLaplace(const CeedScalar *interp_1d, const CeedScalar *grad_1d, const CeedScalar *q_weight_1d, CeedInt P_1d, CeedInt Q_1d,
12672c2ea1dbSJeremy L Thompson                                 CeedInt dim, CeedScalar *mass, CeedScalar *laplace) {
12682b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
1269eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
1270eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
12712b730f8bSJeremy L Thompson       for (CeedInt k = 0; k < Q_1d; k++) sum += interp_1d[k * P_1d + i] * q_weight_1d[k] * interp_1d[k * P_1d + j];
1272eaf62fffSJeremy L Thompson       mass[i + j * P_1d] = sum;
1273eaf62fffSJeremy L Thompson     }
12742b730f8bSJeremy L Thompson   }
1275eaf62fffSJeremy L Thompson   // -- Laplacian
12762b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
1277eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
1278eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
12791c66c397SJeremy L Thompson 
12802b730f8bSJeremy L Thompson       for (CeedInt k = 0; k < Q_1d; k++) sum += grad_1d[k * P_1d + i] * q_weight_1d[k] * grad_1d[k * P_1d + j];
1281eaf62fffSJeremy L Thompson       laplace[i + j * P_1d] = sum;
1282eaf62fffSJeremy L Thompson     }
12832b730f8bSJeremy L Thompson   }
1284eaf62fffSJeremy L Thompson   CeedScalar perturbation = dim > 2 ? 1e-6 : 1e-4;
12852b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) laplace[i + P_1d * i] += perturbation;
1286eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1287eaf62fffSJeremy L Thompson }
12882c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOn
1289eaf62fffSJeremy L Thompson 
1290eaf62fffSJeremy L Thompson /// @}
1291eaf62fffSJeremy L Thompson 
1292eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
1293480fae85SJeremy L Thompson /// CeedOperator Backend API
1294480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
1295480fae85SJeremy L Thompson /// @addtogroup CeedOperatorBackend
1296480fae85SJeremy L Thompson /// @{
1297480fae85SJeremy L Thompson 
1298480fae85SJeremy L Thompson /**
1299004e4986SSebastian Grimberg   @brief Select correct basis matrix pointer based on @ref CeedEvalMode
1300004e4986SSebastian Grimberg 
1301004e4986SSebastian Grimberg   @param[in]  basis     `CeedBasis` from which to get the basis matrix
1302004e4986SSebastian Grimberg   @param[in]  eval_mode Current basis evaluation mode
1303004e4986SSebastian Grimberg   @param[in]  identity  Pointer to identity matrix
1304004e4986SSebastian Grimberg   @param[out] basis_ptr `CeedBasis` pointer to set
1305004e4986SSebastian Grimberg 
1306004e4986SSebastian Grimberg   @ref Backend
1307004e4986SSebastian Grimberg **/
1308004e4986SSebastian Grimberg int CeedOperatorGetBasisPointer(CeedBasis basis, CeedEvalMode eval_mode, const CeedScalar *identity, const CeedScalar **basis_ptr) {
1309004e4986SSebastian Grimberg   switch (eval_mode) {
1310004e4986SSebastian Grimberg     case CEED_EVAL_NONE:
1311004e4986SSebastian Grimberg       *basis_ptr = identity;
1312004e4986SSebastian Grimberg       break;
1313004e4986SSebastian Grimberg     case CEED_EVAL_INTERP:
1314004e4986SSebastian Grimberg       CeedCall(CeedBasisGetInterp(basis, basis_ptr));
1315004e4986SSebastian Grimberg       break;
1316004e4986SSebastian Grimberg     case CEED_EVAL_GRAD:
1317004e4986SSebastian Grimberg       CeedCall(CeedBasisGetGrad(basis, basis_ptr));
1318004e4986SSebastian Grimberg       break;
1319004e4986SSebastian Grimberg     case CEED_EVAL_DIV:
1320004e4986SSebastian Grimberg       CeedCall(CeedBasisGetDiv(basis, basis_ptr));
1321004e4986SSebastian Grimberg       break;
1322004e4986SSebastian Grimberg     case CEED_EVAL_CURL:
1323004e4986SSebastian Grimberg       CeedCall(CeedBasisGetCurl(basis, basis_ptr));
1324004e4986SSebastian Grimberg       break;
1325004e4986SSebastian Grimberg     case CEED_EVAL_WEIGHT:
1326004e4986SSebastian Grimberg       break;  // Caught by QF Assembly
1327004e4986SSebastian Grimberg   }
1328004e4986SSebastian Grimberg   assert(*basis_ptr != NULL);
1329004e4986SSebastian Grimberg   return CEED_ERROR_SUCCESS;
1330004e4986SSebastian Grimberg }
1331004e4986SSebastian Grimberg 
1332004e4986SSebastian Grimberg /**
1333ca94c3ddSJeremy L Thompson   @brief Create point block restriction for active `CeedOperatorField`
1334506b1a0cSSebastian Grimberg 
1335ca94c3ddSJeremy L Thompson   @param[in]  rstr             Original `CeedElemRestriction` for active field
1336ca94c3ddSJeremy L Thompson   @param[out] point_block_rstr Address of the variable where the newly created `CeedElemRestriction` will be stored
1337506b1a0cSSebastian Grimberg 
1338506b1a0cSSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
1339506b1a0cSSebastian Grimberg 
1340506b1a0cSSebastian Grimberg   @ref Backend
1341506b1a0cSSebastian Grimberg **/
1342506b1a0cSSebastian Grimberg int CeedOperatorCreateActivePointBlockRestriction(CeedElemRestriction rstr, CeedElemRestriction *point_block_rstr) {
1343506b1a0cSSebastian Grimberg   Ceed           ceed;
1344506b1a0cSSebastian Grimberg   CeedInt        num_elem, num_comp, shift, elem_size, comp_stride, *point_block_offsets;
1345506b1a0cSSebastian Grimberg   CeedSize       l_size;
1346506b1a0cSSebastian Grimberg   const CeedInt *offsets;
1347506b1a0cSSebastian Grimberg 
1348506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetCeed(rstr, &ceed));
1349506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetOffsets(rstr, CEED_MEM_HOST, &offsets));
1350506b1a0cSSebastian Grimberg 
1351506b1a0cSSebastian Grimberg   // Expand offsets
1352506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
1353506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp));
1354506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size));
1355506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetCompStride(rstr, &comp_stride));
1356506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size));
1357506b1a0cSSebastian Grimberg   shift = num_comp;
1358506b1a0cSSebastian Grimberg   if (comp_stride != 1) shift *= num_comp;
1359506b1a0cSSebastian Grimberg   CeedCall(CeedCalloc(num_elem * elem_size, &point_block_offsets));
1360506b1a0cSSebastian Grimberg   for (CeedInt i = 0; i < num_elem * elem_size; i++) {
1361506b1a0cSSebastian Grimberg     point_block_offsets[i] = offsets[i] * shift;
1362506b1a0cSSebastian Grimberg   }
1363506b1a0cSSebastian Grimberg 
1364506b1a0cSSebastian Grimberg   // Create new restriction
1365506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionCreate(ceed, num_elem, elem_size, num_comp * num_comp, 1, l_size * num_comp, CEED_MEM_HOST, CEED_OWN_POINTER,
1366506b1a0cSSebastian Grimberg                                      point_block_offsets, point_block_rstr));
1367506b1a0cSSebastian Grimberg 
1368506b1a0cSSebastian Grimberg   // Cleanup
1369506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionRestoreOffsets(rstr, &offsets));
13709bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
1371506b1a0cSSebastian Grimberg   return CEED_ERROR_SUCCESS;
1372506b1a0cSSebastian Grimberg }
1373506b1a0cSSebastian Grimberg 
1374506b1a0cSSebastian Grimberg /**
13757d5185d7SSebastian Grimberg   @brief Get `CeedQFunctionAssemblyData`
13767d5185d7SSebastian Grimberg 
13777d5185d7SSebastian Grimberg   @param[in]  op   `CeedOperator` to assemble
13787d5185d7SSebastian Grimberg   @param[out] data `CeedQFunctionAssemblyData`
13797d5185d7SSebastian Grimberg 
13807d5185d7SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
13817d5185d7SSebastian Grimberg 
13827d5185d7SSebastian Grimberg   @ref Backend
13837d5185d7SSebastian Grimberg **/
13847d5185d7SSebastian Grimberg int CeedOperatorGetQFunctionAssemblyData(CeedOperator op, CeedQFunctionAssemblyData *data) {
13857d5185d7SSebastian Grimberg   if (!op->qf_assembled) {
13867d5185d7SSebastian Grimberg     CeedQFunctionAssemblyData data;
13877d5185d7SSebastian Grimberg 
1388b0f67a9cSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataCreate(CeedOperatorReturnCeed(op), &data));
13897d5185d7SSebastian Grimberg     op->qf_assembled = data;
13907d5185d7SSebastian Grimberg   }
13917d5185d7SSebastian Grimberg   *data = op->qf_assembled;
13927d5185d7SSebastian Grimberg   return CEED_ERROR_SUCCESS;
13937d5185d7SSebastian Grimberg }
13947d5185d7SSebastian Grimberg 
13957d5185d7SSebastian Grimberg /**
1396ca94c3ddSJeremy L Thompson   @brief Create object holding `CeedQFunction` assembly data for `CeedOperator`
1397480fae85SJeremy L Thompson 
1398ca94c3ddSJeremy L Thompson   @param[in]  ceed `Ceed` object used to create the `CeedQFunctionAssemblyData`
1399ca94c3ddSJeremy L Thompson   @param[out] data Address of the variable where the newly created `CeedQFunctionAssemblyData` will be stored
1400480fae85SJeremy L Thompson 
1401480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1402480fae85SJeremy L Thompson 
1403480fae85SJeremy L Thompson   @ref Backend
1404480fae85SJeremy L Thompson **/
1405ea61e9acSJeremy L Thompson int CeedQFunctionAssemblyDataCreate(Ceed ceed, CeedQFunctionAssemblyData *data) {
14062b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
1407480fae85SJeremy L Thompson   (*data)->ref_count = 1;
1408b0f67a9cSJeremy L Thompson   CeedCall(CeedReferenceCopy(ceed, &(*data)->ceed));
1409480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1410480fae85SJeremy L Thompson }
1411480fae85SJeremy L Thompson 
1412480fae85SJeremy L Thompson /**
1413ca94c3ddSJeremy L Thompson   @brief Increment the reference counter for a `CeedQFunctionAssemblyData`
1414480fae85SJeremy L Thompson 
1415ca94c3ddSJeremy L Thompson   @param[in,out] data `CeedQFunctionAssemblyData` to increment the reference counter
1416480fae85SJeremy L Thompson 
1417480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1418480fae85SJeremy L Thompson 
1419480fae85SJeremy L Thompson   @ref Backend
1420480fae85SJeremy L Thompson **/
1421480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataReference(CeedQFunctionAssemblyData data) {
1422480fae85SJeremy L Thompson   data->ref_count++;
1423480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1424480fae85SJeremy L Thompson }
1425480fae85SJeremy L Thompson 
1426480fae85SJeremy L Thompson /**
1427ca94c3ddSJeremy L Thompson   @brief Set re-use of `CeedQFunctionAssemblyData`
14288b919e6bSJeremy L Thompson 
1429ca94c3ddSJeremy L Thompson   @param[in,out] data       `CeedQFunctionAssemblyData` to mark for reuse
1430ea61e9acSJeremy L Thompson   @param[in]     reuse_data Boolean flag indicating data re-use
14318b919e6bSJeremy L Thompson 
14328b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
14338b919e6bSJeremy L Thompson 
14348b919e6bSJeremy L Thompson   @ref Backend
14358b919e6bSJeremy L Thompson **/
14362b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetReuse(CeedQFunctionAssemblyData data, bool reuse_data) {
1437beecbf24SJeremy L Thompson   data->reuse_data        = reuse_data;
1438beecbf24SJeremy L Thompson   data->needs_data_update = true;
1439beecbf24SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1440beecbf24SJeremy L Thompson }
1441beecbf24SJeremy L Thompson 
1442beecbf24SJeremy L Thompson /**
1443ca94c3ddSJeremy L Thompson   @brief Mark `CeedQFunctionAssemblyData` as stale
1444beecbf24SJeremy L Thompson 
1445ca94c3ddSJeremy L Thompson   @param[in,out] data              `CeedQFunctionAssemblyData` to mark as stale
1446ea61e9acSJeremy L Thompson   @param[in]     needs_data_update Boolean flag indicating if update is needed or completed
1447beecbf24SJeremy L Thompson 
1448beecbf24SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1449beecbf24SJeremy L Thompson 
1450beecbf24SJeremy L Thompson   @ref Backend
1451beecbf24SJeremy L Thompson **/
14522b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetUpdateNeeded(CeedQFunctionAssemblyData data, bool needs_data_update) {
1453beecbf24SJeremy L Thompson   data->needs_data_update = needs_data_update;
14548b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
14558b919e6bSJeremy L Thompson }
14568b919e6bSJeremy L Thompson 
14578b919e6bSJeremy L Thompson /**
1458ca94c3ddSJeremy L Thompson   @brief Determine if `CeedQFunctionAssemblyData` needs update
14598b919e6bSJeremy L Thompson 
1460ca94c3ddSJeremy L Thompson   @param[in]  data             `CeedQFunctionAssemblyData` to mark as stale
14618b919e6bSJeremy L Thompson   @param[out] is_update_needed Boolean flag indicating if re-assembly is required
14628b919e6bSJeremy L Thompson 
14638b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
14648b919e6bSJeremy L Thompson 
14658b919e6bSJeremy L Thompson   @ref Backend
14668b919e6bSJeremy L Thompson **/
14672b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsUpdateNeeded(CeedQFunctionAssemblyData data, bool *is_update_needed) {
1468beecbf24SJeremy L Thompson   *is_update_needed = !data->reuse_data || data->needs_data_update;
14698b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
14708b919e6bSJeremy L Thompson }
14718b919e6bSJeremy L Thompson 
14728b919e6bSJeremy L Thompson /**
1473ca94c3ddSJeremy L Thompson   @brief Copy the pointer to a `CeedQFunctionAssemblyData`.
14744385fb7fSSebastian Grimberg 
1475ca94c3ddSJeremy L Thompson   Both pointers should be destroyed with @ref CeedQFunctionAssemblyDataDestroy().
1476512bb800SJeremy L Thompson 
1477ca94c3ddSJeremy L Thompson   Note: If the value of ` *data_copy` passed to this function is non-`NULL` , then it is assumed that ` *data_copy` is a pointer to a `CeedQFunctionAssemblyData`.
1478ca94c3ddSJeremy L Thompson         This `CeedQFunctionAssemblyData` will be destroyed if ` *data_copy` is the only reference to this `CeedQFunctionAssemblyData`.
1479480fae85SJeremy L Thompson 
1480ca94c3ddSJeremy L Thompson   @param[in]     data      `CeedQFunctionAssemblyData` to copy reference to
1481ea61e9acSJeremy L Thompson   @param[in,out] data_copy Variable to store copied reference
1482480fae85SJeremy L Thompson 
1483480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1484480fae85SJeremy L Thompson 
1485480fae85SJeremy L Thompson   @ref Backend
1486480fae85SJeremy L Thompson **/
14872b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataReferenceCopy(CeedQFunctionAssemblyData data, CeedQFunctionAssemblyData *data_copy) {
14882b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataReference(data));
14892b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataDestroy(data_copy));
1490480fae85SJeremy L Thompson   *data_copy = data;
1491480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1492480fae85SJeremy L Thompson }
1493480fae85SJeremy L Thompson 
1494480fae85SJeremy L Thompson /**
1495ca94c3ddSJeremy L Thompson   @brief Get setup status for internal objects for `CeedQFunctionAssemblyData`
1496480fae85SJeremy L Thompson 
1497ca94c3ddSJeremy L Thompson   @param[in]  data     `CeedQFunctionAssemblyData` to retrieve status
1498480fae85SJeremy L Thompson   @param[out] is_setup Boolean flag for setup status
1499480fae85SJeremy L Thompson 
1500480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1501480fae85SJeremy L Thompson 
1502480fae85SJeremy L Thompson   @ref Backend
1503480fae85SJeremy L Thompson **/
15042b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsSetup(CeedQFunctionAssemblyData data, bool *is_setup) {
1505480fae85SJeremy L Thompson   *is_setup = data->is_setup;
1506480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1507480fae85SJeremy L Thompson }
1508480fae85SJeremy L Thompson 
1509480fae85SJeremy L Thompson /**
1510ca94c3ddSJeremy L Thompson   @brief Set internal objects for `CeedQFunctionAssemblyData`
1511480fae85SJeremy L Thompson 
1512ca94c3ddSJeremy L Thompson   @param[in,out] data `CeedQFunctionAssemblyData` to set objects
1513ca94c3ddSJeremy L Thompson   @param[in]     vec  `CeedVector` to store assembled `CeedQFunction` at quadrature points
1514ca94c3ddSJeremy L Thompson   @param[in]     rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
1515480fae85SJeremy L Thompson 
1516480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1517480fae85SJeremy L Thompson 
1518480fae85SJeremy L Thompson   @ref Backend
1519480fae85SJeremy L Thompson **/
15202b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetObjects(CeedQFunctionAssemblyData data, CeedVector vec, CeedElemRestriction rstr) {
15212b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(vec, &data->vec));
15222b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(rstr, &data->rstr));
1523480fae85SJeremy L Thompson 
1524480fae85SJeremy L Thompson   data->is_setup = true;
1525480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1526480fae85SJeremy L Thompson }
1527480fae85SJeremy L Thompson 
15284dd1a9d2SSebastian Grimberg /**
1529ca94c3ddSJeremy L Thompson   @brief Get internal objects for `CeedQFunctionAssemblyData`
15304dd1a9d2SSebastian Grimberg 
1531ca94c3ddSJeremy L Thompson   @param[in,out] data `CeedQFunctionAssemblyData` to set objects
1532ca94c3ddSJeremy L Thompson   @param[out]    vec  `CeedVector` to store assembled `CeedQFunction` at quadrature points
1533ca94c3ddSJeremy L Thompson   @param[out]    rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
15344dd1a9d2SSebastian Grimberg 
15354dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
15364dd1a9d2SSebastian Grimberg 
15374dd1a9d2SSebastian Grimberg   @ref Backend
15384dd1a9d2SSebastian Grimberg **/
15392b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataGetObjects(CeedQFunctionAssemblyData data, CeedVector *vec, CeedElemRestriction *rstr) {
15406574a04fSJeremy L Thompson   CeedCheck(data->is_setup, data->ceed, CEED_ERROR_INCOMPLETE, "Internal objects not set; must call CeedQFunctionAssemblyDataSetObjects first.");
1541480fae85SJeremy L Thompson 
15422b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(data->vec, vec));
15432b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(data->rstr, rstr));
1544480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1545480fae85SJeremy L Thompson }
1546480fae85SJeremy L Thompson 
1547480fae85SJeremy L Thompson /**
1548ca94c3ddSJeremy L Thompson   @brief Destroy `CeedQFunctionAssemblyData`
1549480fae85SJeremy L Thompson 
1550ca94c3ddSJeremy L Thompson   @param[in,out] data  `CeedQFunctionAssemblyData` to destroy
1551480fae85SJeremy L Thompson 
1552480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1553480fae85SJeremy L Thompson 
1554480fae85SJeremy L Thompson   @ref Backend
1555480fae85SJeremy L Thompson **/
1556480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataDestroy(CeedQFunctionAssemblyData *data) {
1557ad6481ceSJeremy L Thompson   if (!*data || --(*data)->ref_count > 0) {
1558ad6481ceSJeremy L Thompson     *data = NULL;
1559ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1560ad6481ceSJeremy L Thompson   }
15612b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
15622b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&(*data)->vec));
15632b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&(*data)->rstr));
1564480fae85SJeremy L Thompson 
15652b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1566480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1567480fae85SJeremy L Thompson }
1568480fae85SJeremy L Thompson 
1569ed9e99e6SJeremy L Thompson /**
1570ca94c3ddSJeremy L Thompson   @brief Get `CeedOperatorAssemblyData`
1571ed9e99e6SJeremy L Thompson 
1572ca94c3ddSJeremy L Thompson   @param[in]  op   `CeedOperator` to assemble
15737d5185d7SSebastian Grimberg   @param[out] data `CeedOperatorAssemblyData`
1574ed9e99e6SJeremy L Thompson 
1575ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1576ed9e99e6SJeremy L Thompson 
1577ed9e99e6SJeremy L Thompson   @ref Backend
1578ed9e99e6SJeremy L Thompson **/
15792b730f8bSJeremy L Thompson int CeedOperatorGetOperatorAssemblyData(CeedOperator op, CeedOperatorAssemblyData *data) {
1580ed9e99e6SJeremy L Thompson   if (!op->op_assembled) {
1581ed9e99e6SJeremy L Thompson     CeedOperatorAssemblyData data;
1582ed9e99e6SJeremy L Thompson 
1583b0f67a9cSJeremy L Thompson     CeedCall(CeedOperatorAssemblyDataCreate(CeedOperatorReturnCeed(op), op, &data));
1584ed9e99e6SJeremy L Thompson     op->op_assembled = data;
1585ed9e99e6SJeremy L Thompson   }
1586ed9e99e6SJeremy L Thompson   *data = op->op_assembled;
1587ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1588ed9e99e6SJeremy L Thompson }
1589ed9e99e6SJeremy L Thompson 
1590ed9e99e6SJeremy L Thompson /**
1591ca94c3ddSJeremy L Thompson   @brief Create object holding `CeedOperator` assembly data.
1592ba746a46SJeremy L Thompson 
1593ca94c3ddSJeremy L Thompson   The `CeedOperatorAssemblyData` holds an array with references to every active `CeedBasis` used in the `CeedOperator`.
1594ca94c3ddSJeremy L Thompson   An array with references to the corresponding active `CeedElemRestriction` is also stored.
1595ca94c3ddSJeremy L Thompson   For each active `CeedBasis, the `CeedOperatorAssemblyData` holds an array of all input and output @ref CeedEvalMode for this `CeedBasis`.
1596ca94c3ddSJeremy L Thompson   The `CeedOperatorAssemblyData` holds an array of offsets for indexing into the assembled `CeedQFunction` arrays to the row representing each @ref CeedEvalMode.
1597ca94c3ddSJeremy L Thompson   The number of input columns across all active bases for the assembled `CeedQFunction` is also stored.
1598ca94c3ddSJeremy L Thompson   Lastly, the `CeedOperatorAssembly` data holds assembled matrices representing the full action of the `CeedBasis` for all @ref CeedEvalMode.
1599ed9e99e6SJeremy L Thompson 
1600ca94c3ddSJeremy L Thompson   @param[in]  ceed `Ceed` object used to create the `CeedOperatorAssemblyData`
1601ca94c3ddSJeremy L Thompson   @param[in]  op   `CeedOperator` to be assembled
1602ca94c3ddSJeremy L Thompson   @param[out] data Address of the variable where the newly created `CeedOperatorAssemblyData` will be stored
1603ed9e99e6SJeremy L Thompson 
1604ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1605ed9e99e6SJeremy L Thompson 
1606ed9e99e6SJeremy L Thompson   @ref Backend
1607ed9e99e6SJeremy L Thompson **/
16082b730f8bSJeremy L Thompson int CeedOperatorAssemblyDataCreate(Ceed ceed, CeedOperator op, CeedOperatorAssemblyData *data) {
1609506b1a0cSSebastian Grimberg   CeedInt             num_active_bases_in = 0, num_active_bases_out = 0, offset = 0;
1610506b1a0cSSebastian Grimberg   CeedInt             num_input_fields, *num_eval_modes_in = NULL, num_output_fields, *num_eval_modes_out = NULL;
16111c66c397SJeremy L Thompson   CeedSize          **eval_mode_offsets_in = NULL, **eval_mode_offsets_out = NULL;
16121c66c397SJeremy L Thompson   CeedEvalMode      **eval_modes_in = NULL, **eval_modes_out = NULL;
16131c66c397SJeremy L Thompson   CeedQFunctionField *qf_fields;
16141c66c397SJeremy L Thompson   CeedQFunction       qf;
16151c66c397SJeremy L Thompson   CeedOperatorField  *op_fields;
161601f0e615SJames Wright   bool                is_composite;
161701f0e615SJames Wright 
161801f0e615SJames Wright   CeedCall(CeedOperatorIsComposite(op, &is_composite));
161901f0e615SJames Wright   CeedCheck(!is_composite, ceed, CEED_ERROR_INCOMPATIBLE, "Can only create CeedOperator assembly data for non-composite operators.");
1620437c7c90SJeremy L Thompson 
1621437c7c90SJeremy L Thompson   // Allocate
16222b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
1623b0f67a9cSJeremy L Thompson   CeedCall(CeedReferenceCopy(ceed, &(*data)->ceed));
1624ed9e99e6SJeremy L Thompson 
1625ed9e99e6SJeremy L Thompson   // Build OperatorAssembly data
16262b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
1627ed9e99e6SJeremy L Thompson 
1628ed9e99e6SJeremy L Thompson   // Determine active input basis
1629004e4986SSebastian Grimberg   CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &qf_fields, NULL, NULL));
1630004e4986SSebastian Grimberg   CeedCall(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL));
1631ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
1632ed9e99e6SJeremy L Thompson     CeedVector vec;
16331c66c397SJeremy L Thompson 
16342b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1635ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
16367c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
16371c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
16381c66c397SJeremy L Thompson       CeedBasis    basis_in = NULL;
16391c66c397SJeremy L Thompson 
16402b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_in));
16412b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1642352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_in, &num_comp));
1643352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_in, eval_mode, &q_comp));
1644506b1a0cSSebastian Grimberg       for (CeedInt i = 0; i < num_active_bases_in; i++) {
1645506b1a0cSSebastian Grimberg         if ((*data)->active_bases_in[i] == basis_in) index = i;
1646437c7c90SJeremy L Thompson       }
1647437c7c90SJeremy L Thompson       if (index == -1) {
1648437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_in;
16491c66c397SJeremy L Thompson 
1650506b1a0cSSebastian Grimberg         index = num_active_bases_in;
1651506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_bases_in));
1652506b1a0cSSebastian Grimberg         (*data)->active_bases_in[num_active_bases_in] = NULL;
1653506b1a0cSSebastian Grimberg         CeedCall(CeedBasisReferenceCopy(basis_in, &(*data)->active_bases_in[num_active_bases_in]));
1654506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_elem_rstrs_in));
1655506b1a0cSSebastian Grimberg         (*data)->active_elem_rstrs_in[num_active_bases_in] = NULL;
1656437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_in));
1657506b1a0cSSebastian Grimberg         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_in, &(*data)->active_elem_rstrs_in[num_active_bases_in]));
1658681d0ea7SJeremy L Thompson         CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in));
1659506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &num_eval_modes_in));
1660437c7c90SJeremy L Thompson         num_eval_modes_in[index] = 0;
1661506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_modes_in));
1662437c7c90SJeremy L Thompson         eval_modes_in[index] = NULL;
1663506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_mode_offsets_in));
1664437c7c90SJeremy L Thompson         eval_mode_offsets_in[index] = NULL;
1665506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->assembled_bases_in));
1666437c7c90SJeremy L Thompson         (*data)->assembled_bases_in[index] = NULL;
1667506b1a0cSSebastian Grimberg         num_active_bases_in++;
1668437c7c90SJeremy L Thompson       }
1669352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1670352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1671352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_modes_in[index]));
1672352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_mode_offsets_in[index]));
1673352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1674437c7c90SJeremy L Thompson           eval_modes_in[index][num_eval_modes_in[index] + d]        = eval_mode;
1675437c7c90SJeremy L Thompson           eval_mode_offsets_in[index][num_eval_modes_in[index] + d] = offset;
1676352a5e7cSSebastian Grimberg           offset += num_comp;
1677ed9e99e6SJeremy L Thompson         }
1678352a5e7cSSebastian Grimberg         num_eval_modes_in[index] += q_comp;
1679ed9e99e6SJeremy L Thompson       }
1680681d0ea7SJeremy L Thompson       CeedCall(CeedBasisDestroy(&basis_in));
1681ed9e99e6SJeremy L Thompson     }
1682681d0ea7SJeremy L Thompson     CeedCall(CeedVectorDestroy(&vec));
1683ed9e99e6SJeremy L Thompson   }
1684ed9e99e6SJeremy L Thompson 
1685ed9e99e6SJeremy L Thompson   // Determine active output basis
16862b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, NULL, &num_output_fields, &qf_fields));
16872b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields));
1688437c7c90SJeremy L Thompson   offset = 0;
1689ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_output_fields; i++) {
1690ed9e99e6SJeremy L Thompson     CeedVector vec;
16911c66c397SJeremy L Thompson 
16922b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1693ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
16947c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
16951c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
16961c66c397SJeremy L Thompson       CeedBasis    basis_out = NULL;
16971c66c397SJeremy L Thompson 
1698437c7c90SJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_out));
16992b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1700352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_out, &num_comp));
1701352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_out, eval_mode, &q_comp));
1702506b1a0cSSebastian Grimberg       for (CeedInt i = 0; i < num_active_bases_out; i++) {
1703506b1a0cSSebastian Grimberg         if ((*data)->active_bases_out[i] == basis_out) index = i;
1704437c7c90SJeremy L Thompson       }
1705437c7c90SJeremy L Thompson       if (index == -1) {
1706437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_out;
17071c66c397SJeremy L Thompson 
1708506b1a0cSSebastian Grimberg         index = num_active_bases_out;
1709506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_bases_out));
1710506b1a0cSSebastian Grimberg         (*data)->active_bases_out[num_active_bases_out] = NULL;
1711506b1a0cSSebastian Grimberg         CeedCall(CeedBasisReferenceCopy(basis_out, &(*data)->active_bases_out[num_active_bases_out]));
1712506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_elem_rstrs_out));
1713506b1a0cSSebastian Grimberg         (*data)->active_elem_rstrs_out[num_active_bases_out] = NULL;
1714437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_out));
1715506b1a0cSSebastian Grimberg         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_out, &(*data)->active_elem_rstrs_out[num_active_bases_out]));
1716681d0ea7SJeremy L Thompson         CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out));
1717506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &num_eval_modes_out));
1718437c7c90SJeremy L Thompson         num_eval_modes_out[index] = 0;
1719506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_modes_out));
1720437c7c90SJeremy L Thompson         eval_modes_out[index] = NULL;
1721506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_mode_offsets_out));
1722437c7c90SJeremy L Thompson         eval_mode_offsets_out[index] = NULL;
1723506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->assembled_bases_out));
1724437c7c90SJeremy L Thompson         (*data)->assembled_bases_out[index] = NULL;
1725506b1a0cSSebastian Grimberg         num_active_bases_out++;
1726437c7c90SJeremy L Thompson       }
1727352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1728352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1729352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_modes_out[index]));
1730352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_mode_offsets_out[index]));
1731352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1732437c7c90SJeremy L Thompson           eval_modes_out[index][num_eval_modes_out[index] + d]        = eval_mode;
1733437c7c90SJeremy L Thompson           eval_mode_offsets_out[index][num_eval_modes_out[index] + d] = offset;
1734352a5e7cSSebastian Grimberg           offset += num_comp;
1735ed9e99e6SJeremy L Thompson         }
1736352a5e7cSSebastian Grimberg         num_eval_modes_out[index] += q_comp;
1737ed9e99e6SJeremy L Thompson       }
1738681d0ea7SJeremy L Thompson       CeedCall(CeedBasisDestroy(&basis_out));
1739ed9e99e6SJeremy L Thompson     }
1740681d0ea7SJeremy L Thompson     CeedCall(CeedVectorDestroy(&vec));
1741ed9e99e6SJeremy L Thompson   }
1742c11e12f4SJeremy L Thompson   CeedCall(CeedQFunctionDestroy(&qf));
1743506b1a0cSSebastian Grimberg   (*data)->num_active_bases_in   = num_active_bases_in;
174427789c4aSJed Brown   (*data)->num_eval_modes_in     = num_eval_modes_in;
174527789c4aSJed Brown   (*data)->eval_modes_in         = eval_modes_in;
174627789c4aSJed Brown   (*data)->eval_mode_offsets_in  = eval_mode_offsets_in;
1747506b1a0cSSebastian Grimberg   (*data)->num_active_bases_out  = num_active_bases_out;
1748437c7c90SJeremy L Thompson   (*data)->num_eval_modes_out    = num_eval_modes_out;
1749437c7c90SJeremy L Thompson   (*data)->eval_modes_out        = eval_modes_out;
1750437c7c90SJeremy L Thompson   (*data)->eval_mode_offsets_out = eval_mode_offsets_out;
1751506b1a0cSSebastian Grimberg   (*data)->num_output_components = offset;
1752ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1753ed9e99e6SJeremy L Thompson }
1754ed9e99e6SJeremy L Thompson 
1755ed9e99e6SJeremy L Thompson /**
1756ca94c3ddSJeremy L Thompson   @brief Get `CeedOperator` @ref CeedEvalMode for assembly.
1757ba746a46SJeremy L Thompson 
1758ca94c3ddSJeremy L Thompson   Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object.
1759ed9e99e6SJeremy L Thompson 
1760ca94c3ddSJeremy L Thompson   @param[in]  data                  `CeedOperatorAssemblyData`
1761506b1a0cSSebastian Grimberg   @param[out] num_active_bases_in   Total number of active bases for input
1762ca94c3ddSJeremy L Thompson   @param[out] num_eval_modes_in     Pointer to hold array of numbers of input @ref CeedEvalMode, or `NULL`.
1763ca94c3ddSJeremy L Thompson                                       `eval_modes_in[0]` holds an array of eval modes for the first active `CeedBasis`.
1764ca94c3ddSJeremy L Thompson   @param[out] eval_modes_in         Pointer to hold arrays of input @ref CeedEvalMode, or `NULL`
1765ca94c3ddSJeremy L Thompson   @param[out] eval_mode_offsets_in  Pointer to hold arrays of input offsets at each quadrature point
1766506b1a0cSSebastian Grimberg   @param[out] num_active_bases_out  Total number of active bases for output
1767ca94c3ddSJeremy L Thompson   @param[out] num_eval_modes_out    Pointer to hold array of numbers of output @ref CeedEvalMode, or `NULL`
1768ca94c3ddSJeremy L Thompson   @param[out] eval_modes_out        Pointer to hold arrays of output @ref CeedEvalMode, or `NULL`
1769437c7c90SJeremy L Thompson   @param[out] eval_mode_offsets_out Pointer to hold arrays of output offsets at each quadrature point
1770ca94c3ddSJeremy L Thompson   @param[out] num_output_components The number of columns in the assembled `CeedQFunction` matrix for each quadrature point, including contributions of all active bases
1771ed9e99e6SJeremy L Thompson 
1772ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1773ed9e99e6SJeremy L Thompson 
1774ed9e99e6SJeremy L Thompson   @ref Backend
1775ed9e99e6SJeremy L Thompson **/
1776506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetEvalModes(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedInt **num_eval_modes_in,
1777506b1a0cSSebastian Grimberg                                          const CeedEvalMode ***eval_modes_in, CeedSize ***eval_mode_offsets_in, CeedInt *num_active_bases_out,
1778506b1a0cSSebastian Grimberg                                          CeedInt **num_eval_modes_out, const CeedEvalMode ***eval_modes_out, CeedSize ***eval_mode_offsets_out,
1779506b1a0cSSebastian Grimberg                                          CeedSize *num_output_components) {
1780506b1a0cSSebastian Grimberg   if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in;
1781437c7c90SJeremy L Thompson   if (num_eval_modes_in) *num_eval_modes_in = data->num_eval_modes_in;
1782437c7c90SJeremy L Thompson   if (eval_modes_in) *eval_modes_in = (const CeedEvalMode **)data->eval_modes_in;
1783437c7c90SJeremy L Thompson   if (eval_mode_offsets_in) *eval_mode_offsets_in = data->eval_mode_offsets_in;
1784506b1a0cSSebastian Grimberg   if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out;
1785437c7c90SJeremy L Thompson   if (num_eval_modes_out) *num_eval_modes_out = data->num_eval_modes_out;
1786437c7c90SJeremy L Thompson   if (eval_modes_out) *eval_modes_out = (const CeedEvalMode **)data->eval_modes_out;
1787437c7c90SJeremy L Thompson   if (eval_mode_offsets_out) *eval_mode_offsets_out = data->eval_mode_offsets_out;
1788437c7c90SJeremy L Thompson   if (num_output_components) *num_output_components = data->num_output_components;
1789ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1790ed9e99e6SJeremy L Thompson }
1791ed9e99e6SJeremy L Thompson 
1792ed9e99e6SJeremy L Thompson /**
1793ca94c3ddSJeremy L Thompson   @brief Get `CeedOperator` `CeedBasis` data for assembly.
1794ba746a46SJeremy L Thompson 
1795ca94c3ddSJeremy L Thompson   Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object.
1796ed9e99e6SJeremy L Thompson 
1797ca94c3ddSJeremy L Thompson   @param[in]  data                 `CeedOperatorAssemblyData`
1798ca94c3ddSJeremy L Thompson   @param[out] num_active_bases_in  Number of active input bases, or `NULL`
1799ca94c3ddSJeremy L Thompson   @param[out] active_bases_in      Pointer to hold active input `CeedBasis`, or `NULL`
1800ca94c3ddSJeremy L Thompson   @param[out] assembled_bases_in   Pointer to hold assembled active input `B` , or `NULL`
1801ca94c3ddSJeremy L Thompson   @param[out] num_active_bases_out Number of active output bases, or `NULL`
1802ca94c3ddSJeremy L Thompson   @param[out] active_bases_out     Pointer to hold active output `CeedBasis`, or `NULL`
1803ca94c3ddSJeremy L Thompson   @param[out] assembled_bases_out  Pointer to hold assembled active output `B` , or `NULL`
1804ed9e99e6SJeremy L Thompson 
1805ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1806ed9e99e6SJeremy L Thompson 
1807ed9e99e6SJeremy L Thompson   @ref Backend
1808ed9e99e6SJeremy L Thompson **/
1809506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetBases(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedBasis **active_bases_in,
1810506b1a0cSSebastian Grimberg                                      const CeedScalar ***assembled_bases_in, CeedInt *num_active_bases_out, CeedBasis **active_bases_out,
1811506b1a0cSSebastian Grimberg                                      const CeedScalar ***assembled_bases_out) {
1812ed9e99e6SJeremy L Thompson   // Assemble B_in, B_out if needed
1813437c7c90SJeremy L Thompson   if (assembled_bases_in && !data->assembled_bases_in[0]) {
1814437c7c90SJeremy L Thompson     CeedInt num_qpts;
1815437c7c90SJeremy L Thompson 
1816506b1a0cSSebastian Grimberg     if (data->active_bases_in[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[0], &num_qpts));
1817506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_in[0], &num_qpts));
1818506b1a0cSSebastian Grimberg     for (CeedInt b = 0; b < data->num_active_bases_in; b++) {
18191c66c397SJeremy L Thompson       bool        has_eval_none = false;
1820352a5e7cSSebastian Grimberg       CeedInt     num_nodes;
1821437c7c90SJeremy L Thompson       CeedScalar *B_in = NULL, *identity = NULL;
1822ed9e99e6SJeremy L Thompson 
1823506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[b], &num_nodes));
1824352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_in[b], &B_in));
1825ed9e99e6SJeremy L Thompson 
1826437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_in[b]; i++) {
1827437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_in[b][i] == CEED_EVAL_NONE);
1828ed9e99e6SJeremy L Thompson       }
1829ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1830352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1831352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1832352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1833ed9e99e6SJeremy L Thompson         }
1834ed9e99e6SJeremy L Thompson       }
1835ed9e99e6SJeremy L Thompson 
1836ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1837352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1838352a5e7cSSebastian Grimberg           CeedInt      d_in              = 0, q_comp_in;
1839352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE;
18401c66c397SJeremy L Thompson 
1841437c7c90SJeremy L Thompson           for (CeedInt e_in = 0; e_in < data->num_eval_modes_in[b]; e_in++) {
1842437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_in[b] * q;
1843437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
18441c66c397SJeremy L Thompson 
1845506b1a0cSSebastian Grimberg             CeedCall(CeedOperatorGetBasisPointer(data->active_bases_in[b], data->eval_modes_in[b][e_in], identity, &B));
1846506b1a0cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_in[b], data->eval_modes_in[b][e_in], &q_comp_in));
1847352a5e7cSSebastian Grimberg             if (q_comp_in > 1) {
1848352a5e7cSSebastian Grimberg               if (e_in == 0 || data->eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0;
1849352a5e7cSSebastian Grimberg               else B = &B[(++d_in) * num_qpts * num_nodes];
1850352a5e7cSSebastian Grimberg             }
1851352a5e7cSSebastian Grimberg             eval_mode_in_prev                 = data->eval_modes_in[b][e_in];
1852352a5e7cSSebastian Grimberg             B_in[(qq + e_in) * num_nodes + n] = B[q * num_nodes + n];
1853ed9e99e6SJeremy L Thompson           }
1854ed9e99e6SJeremy L Thompson         }
1855ed9e99e6SJeremy L Thompson       }
18567c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1857437c7c90SJeremy L Thompson       data->assembled_bases_in[b] = B_in;
1858437c7c90SJeremy L Thompson     }
1859ed9e99e6SJeremy L Thompson   }
1860ed9e99e6SJeremy L Thompson 
1861437c7c90SJeremy L Thompson   if (assembled_bases_out && !data->assembled_bases_out[0]) {
1862437c7c90SJeremy L Thompson     CeedInt num_qpts;
1863437c7c90SJeremy L Thompson 
1864506b1a0cSSebastian Grimberg     if (data->active_bases_out[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[0], &num_qpts));
1865506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_out[0], &num_qpts));
1866506b1a0cSSebastian Grimberg     for (CeedInt b = 0; b < data->num_active_bases_out; b++) {
1867ed9e99e6SJeremy L Thompson       bool        has_eval_none = false;
18681c66c397SJeremy L Thompson       CeedInt     num_nodes;
1869437c7c90SJeremy L Thompson       CeedScalar *B_out = NULL, *identity = NULL;
1870ed9e99e6SJeremy L Thompson 
1871506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[b], &num_nodes));
1872352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_out[b], &B_out));
1873ed9e99e6SJeremy L Thompson 
1874437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_out[b]; i++) {
1875437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_out[b][i] == CEED_EVAL_NONE);
1876ed9e99e6SJeremy L Thompson       }
1877ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1878352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1879352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1880352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1881ed9e99e6SJeremy L Thompson         }
1882ed9e99e6SJeremy L Thompson       }
1883ed9e99e6SJeremy L Thompson 
1884ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1885352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1886352a5e7cSSebastian Grimberg           CeedInt      d_out              = 0, q_comp_out;
1887352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
18881c66c397SJeremy L Thompson 
1889437c7c90SJeremy L Thompson           for (CeedInt e_out = 0; e_out < data->num_eval_modes_out[b]; e_out++) {
1890437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_out[b] * q;
1891437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
18921c66c397SJeremy L Thompson 
1893506b1a0cSSebastian Grimberg             CeedCall(CeedOperatorGetBasisPointer(data->active_bases_out[b], data->eval_modes_out[b][e_out], identity, &B));
1894506b1a0cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_out[b], data->eval_modes_out[b][e_out], &q_comp_out));
1895352a5e7cSSebastian Grimberg             if (q_comp_out > 1) {
1896352a5e7cSSebastian Grimberg               if (e_out == 0 || data->eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0;
1897352a5e7cSSebastian Grimberg               else B = &B[(++d_out) * num_qpts * num_nodes];
1898352a5e7cSSebastian Grimberg             }
1899352a5e7cSSebastian Grimberg             eval_mode_out_prev                  = data->eval_modes_out[b][e_out];
1900352a5e7cSSebastian Grimberg             B_out[(qq + e_out) * num_nodes + n] = B[q * num_nodes + n];
1901ed9e99e6SJeremy L Thompson           }
1902ed9e99e6SJeremy L Thompson         }
1903ed9e99e6SJeremy L Thompson       }
19047c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1905437c7c90SJeremy L Thompson       data->assembled_bases_out[b] = B_out;
1906437c7c90SJeremy L Thompson     }
1907ed9e99e6SJeremy L Thompson   }
1908ed9e99e6SJeremy L Thompson 
1909437c7c90SJeremy L Thompson   // Pass out assembled data
1910506b1a0cSSebastian Grimberg   if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in;
1911506b1a0cSSebastian Grimberg   if (active_bases_in) *active_bases_in = data->active_bases_in;
1912437c7c90SJeremy L Thompson   if (assembled_bases_in) *assembled_bases_in = (const CeedScalar **)data->assembled_bases_in;
1913506b1a0cSSebastian Grimberg   if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out;
1914506b1a0cSSebastian Grimberg   if (active_bases_out) *active_bases_out = data->active_bases_out;
1915437c7c90SJeremy L Thompson   if (assembled_bases_out) *assembled_bases_out = (const CeedScalar **)data->assembled_bases_out;
1916437c7c90SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1917437c7c90SJeremy L Thompson }
1918437c7c90SJeremy L Thompson 
1919437c7c90SJeremy L Thompson /**
1920ca94c3ddSJeremy L Thompson   @brief Get `CeedOperator` `CeedBasis` data for assembly.
1921ba746a46SJeremy L Thompson 
1922ca94c3ddSJeremy L Thompson   Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object.
1923437c7c90SJeremy L Thompson 
1924ca94c3ddSJeremy L Thompson   @param[in]  data                      `CeedOperatorAssemblyData`
1925ca94c3ddSJeremy L Thompson   @param[out] num_active_elem_rstrs_in  Number of active input element restrictions, or `NULL`
1926ca94c3ddSJeremy L Thompson   @param[out] active_elem_rstrs_in      Pointer to hold active input `CeedElemRestriction`, or `NULL`
1927ca94c3ddSJeremy L Thompson   @param[out] num_active_elem_rstrs_out Number of active output element restrictions, or `NULL`
1928ca94c3ddSJeremy L Thompson   @param[out] active_elem_rstrs_out     Pointer to hold active output `CeedElemRestriction`, or `NULL`
1929437c7c90SJeremy L Thompson 
1930437c7c90SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1931437c7c90SJeremy L Thompson 
1932437c7c90SJeremy L Thompson   @ref Backend
1933437c7c90SJeremy L Thompson **/
1934506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetElemRestrictions(CeedOperatorAssemblyData data, CeedInt *num_active_elem_rstrs_in,
1935506b1a0cSSebastian Grimberg                                                 CeedElemRestriction **active_elem_rstrs_in, CeedInt *num_active_elem_rstrs_out,
1936506b1a0cSSebastian Grimberg                                                 CeedElemRestriction **active_elem_rstrs_out) {
1937506b1a0cSSebastian Grimberg   if (num_active_elem_rstrs_in) *num_active_elem_rstrs_in = data->num_active_bases_in;
1938506b1a0cSSebastian Grimberg   if (active_elem_rstrs_in) *active_elem_rstrs_in = data->active_elem_rstrs_in;
1939506b1a0cSSebastian Grimberg   if (num_active_elem_rstrs_out) *num_active_elem_rstrs_out = data->num_active_bases_out;
1940506b1a0cSSebastian Grimberg   if (active_elem_rstrs_out) *active_elem_rstrs_out = data->active_elem_rstrs_out;
1941ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1942ed9e99e6SJeremy L Thompson }
1943ed9e99e6SJeremy L Thompson 
1944ed9e99e6SJeremy L Thompson /**
1945ca94c3ddSJeremy L Thompson   @brief Destroy `CeedOperatorAssemblyData`
1946ed9e99e6SJeremy L Thompson 
1947ca94c3ddSJeremy L Thompson   @param[in,out] data `CeedOperatorAssemblyData` to destroy
1948ed9e99e6SJeremy L Thompson 
1949ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1950ed9e99e6SJeremy L Thompson 
1951ed9e99e6SJeremy L Thompson   @ref Backend
1952ed9e99e6SJeremy L Thompson **/
1953ed9e99e6SJeremy L Thompson int CeedOperatorAssemblyDataDestroy(CeedOperatorAssemblyData *data) {
1954ad6481ceSJeremy L Thompson   if (!*data) {
1955ad6481ceSJeremy L Thompson     *data = NULL;
1956ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1957ad6481ceSJeremy L Thompson   }
19582b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
1959506b1a0cSSebastian Grimberg   for (CeedInt b = 0; b < (*data)->num_active_bases_in; b++) {
1960506b1a0cSSebastian Grimberg     CeedCall(CeedBasisDestroy(&(*data)->active_bases_in[b]));
1961506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_in[b]));
1962437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_modes_in[b]));
1963437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_mode_offsets_in[b]));
1964437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_in[b]));
1965506b1a0cSSebastian Grimberg   }
1966506b1a0cSSebastian Grimberg   for (CeedInt b = 0; b < (*data)->num_active_bases_out; b++) {
1967506b1a0cSSebastian Grimberg     CeedCall(CeedBasisDestroy(&(*data)->active_bases_out[b]));
1968506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_out[b]));
1969506b1a0cSSebastian Grimberg     CeedCall(CeedFree(&(*data)->eval_modes_out[b]));
1970506b1a0cSSebastian Grimberg     CeedCall(CeedFree(&(*data)->eval_mode_offsets_out[b]));
1971437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_out[b]));
1972437c7c90SJeremy L Thompson   }
1973506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_bases_in));
1974506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_bases_out));
1975506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_elem_rstrs_in));
1976506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_elem_rstrs_out));
1977437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_in));
1978437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_out));
1979437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_in));
1980437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_out));
1981437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_in));
1982437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_out));
1983437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_in));
1984437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_out));
1985ed9e99e6SJeremy L Thompson 
19862b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1987ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1988ed9e99e6SJeremy L Thompson }
1989ed9e99e6SJeremy L Thompson 
19904dd1a9d2SSebastian Grimberg /**
1991ca94c3ddSJeremy L Thompson   @brief Retrieve fallback `CeedOperator` with a reference `Ceed` for advanced `CeedOperator` functionality
19924dd1a9d2SSebastian Grimberg 
1993ca94c3ddSJeremy L Thompson   @param[in]  op          `CeedOperator` to retrieve fallback for
1994ca94c3ddSJeremy L Thompson   @param[out] op_fallback Fallback `CeedOperator`
19954dd1a9d2SSebastian Grimberg 
19964dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
19974dd1a9d2SSebastian Grimberg 
19984dd1a9d2SSebastian Grimberg   @ref Backend
19994dd1a9d2SSebastian Grimberg **/
20004dd1a9d2SSebastian Grimberg int CeedOperatorGetFallback(CeedOperator op, CeedOperator *op_fallback) {
20014dd1a9d2SSebastian Grimberg   // Create if needed
20024dd1a9d2SSebastian Grimberg   if (!op->op_fallback) CeedCall(CeedOperatorCreateFallback(op));
20034dd1a9d2SSebastian Grimberg   if (op->op_fallback) {
20044dd1a9d2SSebastian Grimberg     bool is_debug;
20051203703bSJeremy L Thompson     Ceed ceed;
20064dd1a9d2SSebastian Grimberg 
20074dd1a9d2SSebastian Grimberg     CeedCall(CeedOperatorGetCeed(op, &ceed));
20081203703bSJeremy L Thompson     CeedCall(CeedIsDebug(ceed, &is_debug));
20091203703bSJeremy L Thompson     if (is_debug) {
20101203703bSJeremy L Thompson       Ceed        ceed_fallback;
2011120566fcSJeremy L Thompson       const char *resource, *resource_fallback, *op_name;
20121203703bSJeremy L Thompson 
20134dd1a9d2SSebastian Grimberg       CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback));
20144dd1a9d2SSebastian Grimberg       CeedCall(CeedGetResource(ceed, &resource));
20154dd1a9d2SSebastian Grimberg       CeedCall(CeedGetResource(ceed_fallback, &resource_fallback));
2016120566fcSJeremy L Thompson       CeedCall(CeedOperatorGetName(op, &op_name));
20174dd1a9d2SSebastian Grimberg 
20184dd1a9d2SSebastian Grimberg       CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "---------- CeedOperator Fallback ----------\n");
2019ca38d01dSJeremy L Thompson       CeedDebug(ceed, "Falling back from Operator with backend %s at address %p to Operator with backend %s at address %p for CeedOperator \"%s\"\n",
2020ca38d01dSJeremy L Thompson                 resource, op, resource_fallback, op->op_fallback, op_name);
20219bc66399SJeremy L Thompson       CeedCall(CeedDestroy(&ceed_fallback));
20224dd1a9d2SSebastian Grimberg     }
20239bc66399SJeremy L Thompson     CeedCall(CeedDestroy(&ceed));
20244dd1a9d2SSebastian Grimberg   }
20254dd1a9d2SSebastian Grimberg   *op_fallback = op->op_fallback;
20264dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
20274dd1a9d2SSebastian Grimberg }
20284dd1a9d2SSebastian Grimberg 
20294dd1a9d2SSebastian Grimberg /**
2030ca94c3ddSJeremy L Thompson   @brief Get the parent `CeedOperator` for a fallback `CeedOperator`
20314dd1a9d2SSebastian Grimberg 
2032ca94c3ddSJeremy L Thompson   @param[in]  op     `CeedOperator` context
2033ca94c3ddSJeremy L Thompson   @param[out] parent Variable to store parent `CeedOperator` context
20344dd1a9d2SSebastian Grimberg 
20354dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
20364dd1a9d2SSebastian Grimberg 
20374dd1a9d2SSebastian Grimberg   @ref Backend
20384dd1a9d2SSebastian Grimberg **/
20394dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParent(CeedOperator op, CeedOperator *parent) {
20404dd1a9d2SSebastian Grimberg   *parent = op->op_fallback_parent ? op->op_fallback_parent : NULL;
20414dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
20424dd1a9d2SSebastian Grimberg }
20434dd1a9d2SSebastian Grimberg 
20444dd1a9d2SSebastian Grimberg /**
2045ca94c3ddSJeremy L Thompson   @brief Get the `Ceed` context of the parent `CeedOperator` for a fallback `CeedOperator`
20464dd1a9d2SSebastian Grimberg 
2047ca94c3ddSJeremy L Thompson   @param[in]  op     `CeedOperator` context
2048ca94c3ddSJeremy L Thompson   @param[out] parent Variable to store parent `Ceed` context
20494dd1a9d2SSebastian Grimberg 
20504dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
20514dd1a9d2SSebastian Grimberg 
20524dd1a9d2SSebastian Grimberg   @ref Backend
20534dd1a9d2SSebastian Grimberg **/
20544dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParentCeed(CeedOperator op, Ceed *parent) {
20559bc66399SJeremy L Thompson   *parent = NULL;
2056b0f67a9cSJeremy L Thompson   if (op->op_fallback_parent) CeedCall(CeedReferenceCopy(CeedOperatorReturnCeed(op->op_fallback_parent), parent));
20579bc66399SJeremy L Thompson   else CeedCall(CeedReferenceCopy(CeedOperatorReturnCeed(op), parent));
20584dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
20594dd1a9d2SSebastian Grimberg }
20604dd1a9d2SSebastian Grimberg 
2061480fae85SJeremy L Thompson /// @}
2062480fae85SJeremy L Thompson 
2063480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
2064eaf62fffSJeremy L Thompson /// CeedOperator Public API
2065eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
2066eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorUser
2067eaf62fffSJeremy L Thompson /// @{
2068eaf62fffSJeremy L Thompson 
2069eaf62fffSJeremy L Thompson /**
2070ca94c3ddSJeremy L Thompson   @brief Assemble a linear `CeedQFunction` associated with a `CeedOperator`.
2071eaf62fffSJeremy L Thompson 
2072ca94c3ddSJeremy L Thompson   This returns a `CeedVector` containing a matrix at each quadrature point providing the action of the `CeedQFunction` associated with the `CeedOperator`.
2073ca94c3ddSJeremy L Thompson   The vector `assembled` is of shape `[num_elements, num_input_fields, num_output_fields, num_quad_points]` and contains column-major matrices representing the action of the `CeedQFunction` for a corresponding quadrature point on an element.
2074859c15bbSJames Wright 
2075ca94c3ddSJeremy L Thompson   Inputs and outputs are in the order provided by the user when adding `CeedOperator` fields.
2076ca94c3ddSJeremy L Thompson   For example, a `CeedQFunction` with inputs `u` and `gradu` and outputs `gradv` and `v` , provided in that order, would result in an assembled `CeedQFunction` that consists of `(1 + dim) x (dim + 1)` matrices at each quadrature point acting on the input ` [u, du_0, du_1]` and producing the output `[dv_0, dv_1, v]`.
2077eaf62fffSJeremy L Thompson 
2078ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2079f04ea552SJeremy L Thompson 
2080ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2081ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points
2082ca94c3ddSJeremy L Thompson   @param[out] rstr      `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
2083ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2084eaf62fffSJeremy L Thompson 
2085eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2086eaf62fffSJeremy L Thompson 
2087eaf62fffSJeremy L Thompson   @ref User
2088eaf62fffSJeremy L Thompson **/
20892b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunction(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
20902b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2091eaf62fffSJeremy L Thompson 
2092eaf62fffSJeremy L Thompson   if (op->LinearAssembleQFunction) {
2093d04bbc78SJeremy L Thompson     // Backend version
20942b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleQFunction(op, assembled, rstr, request));
2095eaf62fffSJeremy L Thompson   } else {
2096d04bbc78SJeremy L Thompson     // Operator fallback
2097d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2098d04bbc78SJeremy L Thompson 
2099ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleQFunction\n");
21002b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
21016574a04fSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunction(op_fallback, assembled, rstr, request));
21029bc66399SJeremy L Thompson     else return CeedError(CeedOperatorReturnCeed(op), CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunction");
210370a7ffb3SJeremy L Thompson   }
2104eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2105eaf62fffSJeremy L Thompson }
210670a7ffb3SJeremy L Thompson 
210770a7ffb3SJeremy L Thompson /**
2108ca94c3ddSJeremy L Thompson   @brief Assemble `CeedQFunction` and store result internally.
21094385fb7fSSebastian Grimberg 
2110ea61e9acSJeremy L Thompson   Return copied references of stored data to the caller.
2111ea61e9acSJeremy L Thompson   Caller is responsible for ownership and destruction of the copied references.
2112ca94c3ddSJeremy L Thompson   See also @ref CeedOperatorLinearAssembleQFunction().
211370a7ffb3SJeremy L Thompson 
2114ca94c3ddSJeremy L Thompson   Note: If the value of `assembled` or `rstr` passed to this function are non-`NULL` , then it is assumed that they hold valid pointers.
2115c5f45aeaSJeremy L Thompson         These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object.
2116c5f45aeaSJeremy L Thompson 
2117ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2118ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points
2119ca94c3ddSJeremy L Thompson   @param[out] rstr      `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction`
2120ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
212170a7ffb3SJeremy L Thompson 
212270a7ffb3SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
212370a7ffb3SJeremy L Thompson 
212470a7ffb3SJeremy L Thompson   @ref User
212570a7ffb3SJeremy L Thompson **/
21262b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdate(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
21270816752eSJeremy L Thompson   return CeedOperatorLinearAssembleQFunctionBuildOrUpdate_Core(op, true, assembled, rstr, request);
2128eaf62fffSJeremy L Thompson }
2129eaf62fffSJeremy L Thompson 
2130eaf62fffSJeremy L Thompson /**
2131ca94c3ddSJeremy L Thompson   @brief Assemble the diagonal of a square linear `CeedOperator`
2132eaf62fffSJeremy L Thompson 
2133ca94c3ddSJeremy L Thompson   This overwrites a `CeedVector` with the diagonal of a linear `CeedOperator`.
2134eaf62fffSJeremy L Thompson 
2135ca94c3ddSJeremy L Thompson   Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported.
2136eaf62fffSJeremy L Thompson 
2137ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2138f04ea552SJeremy L Thompson 
2139ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2140ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal
2141ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2142eaf62fffSJeremy L Thompson 
2143eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2144eaf62fffSJeremy L Thompson 
2145eaf62fffSJeremy L Thompson   @ref User
2146eaf62fffSJeremy L Thompson **/
21472b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2148f3d47e36SJeremy L Thompson   bool     is_composite;
21491c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
21501c66c397SJeremy L Thompson 
21512b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2152f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2153eaf62fffSJeremy L Thompson 
21542b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
21559bc66399SJeremy L Thompson   CeedCheck(input_size == output_size, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION, "Operator must be square");
2156c9366a6bSJeremy L Thompson 
2157f3d47e36SJeremy L Thompson   // Early exit for empty operator
2158f3d47e36SJeremy L Thompson   if (!is_composite) {
2159f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2160f3d47e36SJeremy L Thompson 
2161f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2162f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2163f3d47e36SJeremy L Thompson   }
2164f3d47e36SJeremy L Thompson 
2165eaf62fffSJeremy L Thompson   if (op->LinearAssembleDiagonal) {
2166d04bbc78SJeremy L Thompson     // Backend version
21672b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleDiagonal(op, assembled, request));
2168eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2169eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddDiagonal) {
2170d04bbc78SJeremy L Thompson     // Backend version with zeroing first
21712b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
21722b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
2173eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
21740183ed61SJeremy L Thompson   } else if (is_composite) {
21750183ed61SJeremy L Thompson     // Default to summing contributions of suboperators
21760183ed61SJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
2177ed094490SJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddDiagonalComposite(op, request, false, assembled));
21780183ed61SJeremy L Thompson     return CEED_ERROR_SUCCESS;
2179eaf62fffSJeremy L Thompson   } else {
2180d04bbc78SJeremy L Thompson     // Operator fallback
2181d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2182d04bbc78SJeremy L Thompson 
2183ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleDiagonal\n");
21842b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2185d04bbc78SJeremy L Thompson     if (op_fallback) {
21862b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleDiagonal(op_fallback, assembled, request));
2187eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2188eaf62fffSJeremy L Thompson     }
2189eaf62fffSJeremy L Thompson   }
2190eaf62fffSJeremy L Thompson   // Default interface implementation
21912b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
21922b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddDiagonal(op, assembled, request));
2193eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2194eaf62fffSJeremy L Thompson }
2195eaf62fffSJeremy L Thompson 
2196eaf62fffSJeremy L Thompson /**
2197ca94c3ddSJeremy L Thompson   @brief Assemble the diagonal of a square linear `CeedOperator`.
2198eaf62fffSJeremy L Thompson 
2199ca94c3ddSJeremy L Thompson   This sums into a `CeedVector` the diagonal of a linear `CeedOperator`.
2200eaf62fffSJeremy L Thompson 
2201ca94c3ddSJeremy L Thompson   Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported.
2202eaf62fffSJeremy L Thompson 
2203ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2204f04ea552SJeremy L Thompson 
2205ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2206ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal
2207ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2208eaf62fffSJeremy L Thompson 
2209eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2210eaf62fffSJeremy L Thompson 
2211eaf62fffSJeremy L Thompson   @ref User
2212eaf62fffSJeremy L Thompson **/
22132b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2214f3d47e36SJeremy L Thompson   bool     is_composite;
22151c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
22161c66c397SJeremy L Thompson 
22172b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2218f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2219eaf62fffSJeremy L Thompson 
22202b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
22219bc66399SJeremy L Thompson   CeedCheck(input_size == output_size, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION, "Operator must be square");
2222c9366a6bSJeremy L Thompson 
2223f3d47e36SJeremy L Thompson   // Early exit for empty operator
2224f3d47e36SJeremy L Thompson   if (!is_composite) {
2225f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2226f3d47e36SJeremy L Thompson 
2227f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2228f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2229f3d47e36SJeremy L Thompson   }
2230f3d47e36SJeremy L Thompson 
2231eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddDiagonal) {
2232d04bbc78SJeremy L Thompson     // Backend version
22332b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
2234eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
22350183ed61SJeremy L Thompson   } else if (is_composite) {
22360183ed61SJeremy L Thompson     // Default to summing contributions of suboperators
2237ed094490SJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddDiagonalComposite(op, request, false, assembled));
223854d16554SHugh Carson     return CEED_ERROR_SUCCESS;
2239eaf62fffSJeremy L Thompson   } else {
2240d04bbc78SJeremy L Thompson     // Operator fallback
2241d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2242d04bbc78SJeremy L Thompson 
2243ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleAddDiagonal\n");
22442b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2245d04bbc78SJeremy L Thompson     if (op_fallback) {
22462b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddDiagonal(op_fallback, assembled, request));
2247eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2248eaf62fffSJeremy L Thompson     }
2249eaf62fffSJeremy L Thompson   }
2250eaf62fffSJeremy L Thompson   // Default interface implementation
2251ed094490SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddDiagonalSingle(op, request, false, assembled));
2252d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
2253eaf62fffSJeremy L Thompson }
2254eaf62fffSJeremy L Thompson 
2255eaf62fffSJeremy L Thompson /**
2256ca94c3ddSJeremy L Thompson    @brief Fully assemble the point-block diagonal pattern of a linear `CeedOperator`.
225701f0e615SJames Wright 
2258ca94c3ddSJeremy L Thompson    Expected to be used in conjunction with @ref CeedOperatorLinearAssemblePointBlockDiagonal().
225901f0e615SJames Wright 
2260ca94c3ddSJeremy L Thompson    The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`.
2261ca94c3ddSJeremy L Thompson    Note that the `(i, j)` pairs are unique.
2262ca94c3ddSJeremy L Thompson    This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemblePointBlockDiagonal() provides the values in the same ordering.
226301f0e615SJames Wright 
226401f0e615SJames Wright    This will generally be slow unless your operator is low-order.
226501f0e615SJames Wright 
2266ca94c3ddSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
226701f0e615SJames Wright 
2268ca94c3ddSJeremy L Thompson    @param[in]  op          `CeedOperator` to assemble
226901f0e615SJames Wright    @param[out] num_entries Number of entries in coordinate nonzero pattern
227001f0e615SJames Wright    @param[out] rows        Row number for each entry
227101f0e615SJames Wright    @param[out] cols        Column number for each entry
227201f0e615SJames Wright 
227301f0e615SJames Wright    @ref User
227401f0e615SJames Wright **/
227501f0e615SJames Wright int CeedOperatorLinearAssemblePointBlockDiagonalSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) {
227601f0e615SJames Wright   bool          is_composite;
227701f0e615SJames Wright   CeedInt       num_active_components, num_sub_operators;
227801f0e615SJames Wright   CeedOperator *sub_operators;
227901f0e615SJames Wright 
228001f0e615SJames Wright   CeedCall(CeedOperatorIsComposite(op, &is_composite));
228101f0e615SJames Wright 
228201f0e615SJames Wright   CeedSize input_size = 0, output_size = 0;
228301f0e615SJames Wright   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
22849bc66399SJeremy L Thompson   CeedCheck(input_size == output_size, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION, "Operator must be square");
228501f0e615SJames Wright 
228601f0e615SJames Wright   if (is_composite) {
2287ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetNumSub(op, &num_sub_operators));
2288ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
228901f0e615SJames Wright   } else {
229001f0e615SJames Wright     sub_operators     = &op;
229101f0e615SJames Wright     num_sub_operators = 1;
229201f0e615SJames Wright   }
229301f0e615SJames Wright 
2294506b1a0cSSebastian Grimberg   // Verify operator can be assembled correctly
2295506b1a0cSSebastian Grimberg   {
229601f0e615SJames Wright     CeedOperatorAssemblyData data;
2297506b1a0cSSebastian Grimberg     CeedInt                  num_active_elem_rstrs, comp_stride;
229801f0e615SJames Wright     CeedElemRestriction     *active_elem_rstrs;
229901f0e615SJames Wright 
230001f0e615SJames Wright     // Get initial values to check against
230101f0e615SJames Wright     CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[0], &data));
2302506b1a0cSSebastian Grimberg     CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL));
230301f0e615SJames Wright     CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[0], &comp_stride));
230401f0e615SJames Wright     CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[0], &num_active_components));
230501f0e615SJames Wright 
2306506b1a0cSSebastian Grimberg     // Verify that all active element restrictions have same component stride and number of components
230701f0e615SJames Wright     for (CeedInt k = 0; k < num_sub_operators; k++) {
230801f0e615SJames Wright       CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[k], &data));
2309506b1a0cSSebastian Grimberg       CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL));
231001f0e615SJames Wright       for (CeedInt i = 0; i < num_active_elem_rstrs; i++) {
2311506b1a0cSSebastian Grimberg         CeedInt comp_stride_sub, num_active_components_sub;
2312506b1a0cSSebastian Grimberg 
231301f0e615SJames Wright         CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[i], &comp_stride_sub));
23149bc66399SJeremy L Thompson         CeedCheck(comp_stride == comp_stride_sub, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION,
231501f0e615SJames Wright                   "Active element restrictions must have the same component stride: %d vs %d", comp_stride, comp_stride_sub);
231601f0e615SJames Wright         CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[i], &num_active_components_sub));
23179bc66399SJeremy L Thompson         CeedCheck(num_active_components == num_active_components_sub, CeedOperatorReturnCeed(op), CEED_ERROR_INCOMPATIBLE,
23183f08121cSJeremy L Thompson                   "All suboperators must have the same number of output components."
23193f08121cSJeremy L Thompson                   " Previous: %" CeedInt_FMT " Current: %" CeedInt_FMT,
23203f08121cSJeremy L Thompson                   num_active_components, num_active_components_sub);
232101f0e615SJames Wright       }
232201f0e615SJames Wright     }
232301f0e615SJames Wright   }
232401f0e615SJames Wright   *num_entries = input_size * num_active_components;
232501f0e615SJames Wright   CeedCall(CeedCalloc(*num_entries, rows));
232601f0e615SJames Wright   CeedCall(CeedCalloc(*num_entries, cols));
232701f0e615SJames Wright 
232801f0e615SJames Wright   for (CeedInt o = 0; o < num_sub_operators; o++) {
2329506b1a0cSSebastian Grimberg     CeedElemRestriction active_elem_rstr, point_block_active_elem_rstr;
233001f0e615SJames Wright     CeedInt             comp_stride, num_elem, elem_size;
2331506b1a0cSSebastian Grimberg     const CeedInt      *offsets, *point_block_offsets;
233201f0e615SJames Wright 
233301f0e615SJames Wright     CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[o], &active_elem_rstr));
233401f0e615SJames Wright     CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstr, &comp_stride));
233501f0e615SJames Wright     CeedCall(CeedElemRestrictionGetNumElements(active_elem_rstr, &num_elem));
233601f0e615SJames Wright     CeedCall(CeedElemRestrictionGetElementSize(active_elem_rstr, &elem_size));
233701f0e615SJames Wright     CeedCall(CeedElemRestrictionGetOffsets(active_elem_rstr, CEED_MEM_HOST, &offsets));
233801f0e615SJames Wright 
2339506b1a0cSSebastian Grimberg     CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstr, &point_block_active_elem_rstr));
2340506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetOffsets(point_block_active_elem_rstr, CEED_MEM_HOST, &point_block_offsets));
234101f0e615SJames Wright 
234201f0e615SJames Wright     for (CeedSize i = 0; i < num_elem * elem_size; i++) {
234301f0e615SJames Wright       for (CeedInt c_out = 0; c_out < num_active_components; c_out++) {
234401f0e615SJames Wright         for (CeedInt c_in = 0; c_in < num_active_components; c_in++) {
2345506b1a0cSSebastian Grimberg           (*rows)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_out * comp_stride;
2346506b1a0cSSebastian Grimberg           (*cols)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_in * comp_stride;
234701f0e615SJames Wright         }
234801f0e615SJames Wright       }
234901f0e615SJames Wright     }
235001f0e615SJames Wright 
235101f0e615SJames Wright     CeedCall(CeedElemRestrictionRestoreOffsets(active_elem_rstr, &offsets));
2352506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreOffsets(point_block_active_elem_rstr, &point_block_offsets));
2353681d0ea7SJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&active_elem_rstr));
2354506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&point_block_active_elem_rstr));
235501f0e615SJames Wright   }
235601f0e615SJames Wright   return CEED_ERROR_SUCCESS;
235701f0e615SJames Wright }
235801f0e615SJames Wright 
235901f0e615SJames Wright /**
2360ca94c3ddSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear `CeedOperator`.
2361eaf62fffSJeremy L Thompson 
2362ca94c3ddSJeremy L Thompson   This overwrites a `CeedVector` with the point block diagonal of a linear `CeedOperator`.
2363eaf62fffSJeremy L Thompson 
2364ca94c3ddSJeremy L Thompson   Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported.
2365eaf62fffSJeremy L Thompson 
2366ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2367f04ea552SJeremy L Thompson 
2368ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2369ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled `CeedOperator` point block diagonal, provided in row-major form with an `num_comp * num_comp` block at each node.
2370ca94c3ddSJeremy L Thompson                           The dimensions of this vector are derived from the active vector for the `CeedOperator`.
2371ca94c3ddSJeremy L Thompson                           The array has shape `[nodes, component out, component in]`.
2372ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2373eaf62fffSJeremy L Thompson 
2374eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2375eaf62fffSJeremy L Thompson 
2376eaf62fffSJeremy L Thompson   @ref User
2377eaf62fffSJeremy L Thompson **/
23782b730f8bSJeremy L Thompson int CeedOperatorLinearAssemblePointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2379f3d47e36SJeremy L Thompson   bool     is_composite;
23801c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
23811c66c397SJeremy L Thompson 
23822b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2383f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2384eaf62fffSJeremy L Thompson 
23852b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
23869bc66399SJeremy L Thompson   CeedCheck(input_size == output_size, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION, "Operator must be square");
2387c9366a6bSJeremy L Thompson 
2388f3d47e36SJeremy L Thompson   // Early exit for empty operator
2389f3d47e36SJeremy L Thompson   if (!is_composite) {
2390f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2391f3d47e36SJeremy L Thompson 
2392f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2393f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2394f3d47e36SJeremy L Thompson   }
2395f3d47e36SJeremy L Thompson 
2396eaf62fffSJeremy L Thompson   if (op->LinearAssemblePointBlockDiagonal) {
2397d04bbc78SJeremy L Thompson     // Backend version
23982b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemblePointBlockDiagonal(op, assembled, request));
2399eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2400eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddPointBlockDiagonal) {
2401d04bbc78SJeremy L Thompson     // Backend version with zeroing first
24022b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
24032b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
2404eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2405eaf62fffSJeremy L Thompson   } else {
2406d04bbc78SJeremy L Thompson     // Operator fallback
2407d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2408d04bbc78SJeremy L Thompson 
2409ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssemblePointBlockDiagonal\n");
24102b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2411d04bbc78SJeremy L Thompson     if (op_fallback) {
24122b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemblePointBlockDiagonal(op_fallback, assembled, request));
2413eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2414eaf62fffSJeremy L Thompson     }
2415eaf62fffSJeremy L Thompson   }
2416eaf62fffSJeremy L Thompson   // Default interface implementation
24172b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
24182b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
2419eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2420eaf62fffSJeremy L Thompson }
2421eaf62fffSJeremy L Thompson 
2422eaf62fffSJeremy L Thompson /**
2423ca94c3ddSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear `CeedOperator`.
2424eaf62fffSJeremy L Thompson 
2425ca94c3ddSJeremy L Thompson   This sums into a `CeedVector` with the point block diagonal of a linear `CeedOperator`.
2426eaf62fffSJeremy L Thompson 
2427ca94c3ddSJeremy L Thompson   Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported.
2428eaf62fffSJeremy L Thompson 
2429ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2430f04ea552SJeremy L Thompson 
2431ca94c3ddSJeremy L Thompson   @param[in]  op        `CeedOperator` to assemble `CeedQFunction`
2432ca94c3ddSJeremy L Thompson   @param[out] assembled `CeedVector` to store assembled CeedOperator point block diagonal, provided in row-major form with an `num_comp * num_comp` block at each node.
2433ca94c3ddSJeremy L Thompson                           The dimensions of this vector are derived from the active vector for the `CeedOperator`.
2434ca94c3ddSJeremy L Thompson                           The array has shape `[nodes, component out, component in]`.
2435ca94c3ddSJeremy L Thompson   @param[in]  request   Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2436eaf62fffSJeremy L Thompson 
2437eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2438eaf62fffSJeremy L Thompson 
2439eaf62fffSJeremy L Thompson   @ref User
2440eaf62fffSJeremy L Thompson **/
24412b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddPointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2442f3d47e36SJeremy L Thompson   bool     is_composite;
24431c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
24441c66c397SJeremy L Thompson 
24452b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2446f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2447eaf62fffSJeremy L Thompson 
24482b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
24499bc66399SJeremy L Thompson   CeedCheck(input_size == output_size, CeedOperatorReturnCeed(op), CEED_ERROR_DIMENSION, "Operator must be square");
2450c9366a6bSJeremy L Thompson 
2451f3d47e36SJeremy L Thompson   // Early exit for empty operator
2452f3d47e36SJeremy L Thompson   if (!is_composite) {
2453f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2454f3d47e36SJeremy L Thompson 
2455f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2456f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2457f3d47e36SJeremy L Thompson   }
2458f3d47e36SJeremy L Thompson 
2459eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddPointBlockDiagonal) {
2460d04bbc78SJeremy L Thompson     // Backend version
24612b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddPointBlockDiagonal(op, assembled, request));
2462eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2463eaf62fffSJeremy L Thompson   } else {
2464d04bbc78SJeremy L Thompson     // Operator fallback
2465d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2466d04bbc78SJeremy L Thompson 
2467ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleAddPointBlockDiagonal\n");
24682b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2469d04bbc78SJeremy L Thompson     if (op_fallback) {
24702b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op_fallback, assembled, request));
2471eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2472eaf62fffSJeremy L Thompson     }
2473eaf62fffSJeremy L Thompson   }
2474ea61e9acSJeremy L Thompson   // Default interface implementation
2475eaf62fffSJeremy L Thompson   if (is_composite) {
2476ed094490SJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddDiagonalComposite(op, request, true, assembled));
2477eaf62fffSJeremy L Thompson   } else {
2478ed094490SJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddDiagonalSingle(op, request, true, assembled));
2479eaf62fffSJeremy L Thompson   }
2480d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
2481eaf62fffSJeremy L Thompson }
2482eaf62fffSJeremy L Thompson 
2483eaf62fffSJeremy L Thompson /**
2484ca94c3ddSJeremy L Thompson    @brief Fully assemble the nonzero pattern of a linear `CeedOperator`.
2485eaf62fffSJeremy L Thompson 
2486ca94c3ddSJeremy L Thompson    Expected to be used in conjunction with @ref CeedOperatorLinearAssemble().
2487eaf62fffSJeremy L Thompson 
2488ca94c3ddSJeremy L Thompson    The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`.
2489ca94c3ddSJeremy L Thompson    Note that the `(i, j)` pairs are not unique and may repeat.
2490ca94c3ddSJeremy L Thompson    This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemble() provides the values in the same ordering.
2491eaf62fffSJeremy L Thompson 
2492eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
2493eaf62fffSJeremy L Thompson 
2494ca94c3ddSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2495f04ea552SJeremy L Thompson 
2496ca94c3ddSJeremy L Thompson    @param[in]  op          `CeedOperator` to assemble
2497eaf62fffSJeremy L Thompson    @param[out] num_entries Number of entries in coordinate nonzero pattern
2498eaf62fffSJeremy L Thompson    @param[out] rows        Row number for each entry
2499eaf62fffSJeremy L Thompson    @param[out] cols        Column number for each entry
2500eaf62fffSJeremy L Thompson 
2501eaf62fffSJeremy L Thompson    @ref User
2502eaf62fffSJeremy L Thompson **/
25032b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) {
25041c66c397SJeremy L Thompson   bool          is_composite;
25051c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
2506b94338b9SJed Brown   CeedSize      single_entries;
2507eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
25081c66c397SJeremy L Thompson 
25092b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2510f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2511eaf62fffSJeremy L Thompson 
2512eaf62fffSJeremy L Thompson   if (op->LinearAssembleSymbolic) {
2513d04bbc78SJeremy L Thompson     // Backend version
25142b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSymbolic(op, num_entries, rows, cols));
2515eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2516eaf62fffSJeremy L Thompson   } else {
2517d04bbc78SJeremy L Thompson     // Operator fallback
2518d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2519d04bbc78SJeremy L Thompson 
2520ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssembleSymbolic\n");
25212b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2522d04bbc78SJeremy L Thompson     if (op_fallback) {
25232b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleSymbolic(op_fallback, num_entries, rows, cols));
2524eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2525eaf62fffSJeremy L Thompson     }
2526eaf62fffSJeremy L Thompson   }
2527eaf62fffSJeremy L Thompson 
2528eaf62fffSJeremy L Thompson   // Default interface implementation
2529eaf62fffSJeremy L Thompson 
2530506b1a0cSSebastian Grimberg   // Count entries and allocate rows, cols arrays
253156318ee4SZach Atkins   CeedCall(CeedOperatorLinearAssembleGetNumEntries(op, num_entries));
25322b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, rows));
25332b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, cols));
2534eaf62fffSJeremy L Thompson 
2535506b1a0cSSebastian Grimberg   // Assemble nonzero locations
2536eaf62fffSJeremy L Thompson   if (is_composite) {
2537ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetNumSub(op, &num_suboperators));
2538ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
253992ae7e47SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; ++k) {
2540ed094490SJeremy L Thompson       CeedCall(CeedOperatorAssembleSymbolicSingle(sub_operators[k], offset, *rows, *cols));
2541ed094490SJeremy L Thompson       CeedCall(CeedOperatorAssemblyCountEntriesSingle(sub_operators[k], &single_entries));
2542eaf62fffSJeremy L Thompson       offset += single_entries;
2543eaf62fffSJeremy L Thompson     }
2544eaf62fffSJeremy L Thompson   } else {
2545ed094490SJeremy L Thompson     CeedCall(CeedOperatorAssembleSymbolicSingle(op, offset, *rows, *cols));
2546eaf62fffSJeremy L Thompson   }
2547eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2548eaf62fffSJeremy L Thompson }
2549eaf62fffSJeremy L Thompson 
2550eaf62fffSJeremy L Thompson /**
2551eaf62fffSJeremy L Thompson    @brief Fully assemble the nonzero entries of a linear operator.
2552eaf62fffSJeremy L Thompson 
2553ca94c3ddSJeremy L Thompson    Expected to be used in conjunction with @ref CeedOperatorLinearAssembleSymbolic().
2554eaf62fffSJeremy L Thompson 
2555ca94c3ddSJeremy L Thompson    The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`.
2556ca94c3ddSJeremy L Thompson    Note that the `(i, j)` pairs are not unique and may repeat.
2557ca94c3ddSJeremy L Thompson    This function returns the values of the nonzero entries to be added, their `(i, j)` locations are provided by @ref CeedOperatorLinearAssembleSymbolic().
2558eaf62fffSJeremy L Thompson 
2559eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
2560eaf62fffSJeremy L Thompson 
2561ca94c3ddSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2562f04ea552SJeremy L Thompson 
2563ca94c3ddSJeremy L Thompson    @param[in]  op     `CeedOperator` to assemble
2564eaf62fffSJeremy L Thompson    @param[out] values Values to assemble into matrix
2565eaf62fffSJeremy L Thompson 
2566eaf62fffSJeremy L Thompson    @ref User
2567eaf62fffSJeremy L Thompson **/
2568eaf62fffSJeremy L Thompson int CeedOperatorLinearAssemble(CeedOperator op, CeedVector values) {
2569a34b87f3SZach Atkins   bool          is_composite;
25701c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
2571b94338b9SJed Brown   CeedSize      single_entries = 0;
2572eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
25731c66c397SJeremy L Thompson 
25742b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2575f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2576f3d47e36SJeremy L Thompson 
2577f3d47e36SJeremy L Thompson   // Early exit for empty operator
2578f3d47e36SJeremy L Thompson   if (!is_composite) {
2579f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2580f3d47e36SJeremy L Thompson 
2581f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2582f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2583f3d47e36SJeremy L Thompson   }
2584eaf62fffSJeremy L Thompson 
2585eaf62fffSJeremy L Thompson   if (op->LinearAssemble) {
2586d04bbc78SJeremy L Thompson     // Backend version
25872b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemble(op, values));
2588eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2589a34b87f3SZach Atkins   } else if (is_composite) {
2590915834c9SZach Atkins     // Default to summing contributions of suboperators
2591915834c9SZach Atkins     CeedCall(CeedVectorSetValue(values, 0.0));
2592ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetNumSub(op, &num_suboperators));
2593ed094490SJeremy L Thompson     CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
2594915834c9SZach Atkins     for (CeedInt k = 0; k < num_suboperators; k++) {
2595ed094490SJeremy L Thompson       CeedCall(CeedOperatorAssembleSingle(sub_operators[k], offset, values));
2596ed094490SJeremy L Thompson       CeedCall(CeedOperatorAssemblyCountEntriesSingle(sub_operators[k], &single_entries));
2597915834c9SZach Atkins       offset += single_entries;
2598915834c9SZach Atkins     }
2599a34b87f3SZach Atkins     return CEED_ERROR_SUCCESS;
2600a34b87f3SZach Atkins   } else if (op->LinearAssembleSingle) {
2601a34b87f3SZach Atkins     CeedCall(CeedVectorSetValue(values, 0.0));
2602ed094490SJeremy L Thompson     CeedCall(CeedOperatorAssembleSingle(op, offset, values));
2603915834c9SZach Atkins     return CEED_ERROR_SUCCESS;
2604eaf62fffSJeremy L Thompson   } else {
2605d04bbc78SJeremy L Thompson     // Operator fallback
2606d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2607d04bbc78SJeremy L Thompson 
2608ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorLinearAssemble\n");
26092b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2610d04bbc78SJeremy L Thompson     if (op_fallback) {
26112b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemble(op_fallback, values));
2612eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2613eaf62fffSJeremy L Thompson     }
2614eaf62fffSJeremy L Thompson   }
2615eaf62fffSJeremy L Thompson 
2616a34b87f3SZach Atkins   // Default to interface version if non-composite and no fallback
261728ec399dSJeremy L Thompson   CeedCall(CeedVectorSetValue(values, 0.0));
2618ed094490SJeremy L Thompson   CeedCall(CeedOperatorAssembleSingle(op, offset, values));
2619eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2620eaf62fffSJeremy L Thompson }
2621eaf62fffSJeremy L Thompson 
2622eaf62fffSJeremy L Thompson /**
2623ca94c3ddSJeremy L Thompson   @brief Get the multiplicity of nodes across sub-operators in a composite `CeedOperator`.
262475f0d5a4SJeremy L Thompson 
2625ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
262675f0d5a4SJeremy L Thompson 
2627ca94c3ddSJeremy L Thompson   @param[in]  op               Composite `CeedOperator`
2628ca94c3ddSJeremy L Thompson   @param[in]  num_skip_indices Number of sub-operators to skip
2629ca94c3ddSJeremy L Thompson   @param[in]  skip_indices     Array of indices of sub-operators to skip
2630ca94c3ddSJeremy L Thompson   @param[out] mult             Vector to store multiplicity (of size `l_size` )
263175f0d5a4SJeremy L Thompson 
263275f0d5a4SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
263375f0d5a4SJeremy L Thompson 
263475f0d5a4SJeremy L Thompson   @ref User
263575f0d5a4SJeremy L Thompson **/
2636ed094490SJeremy L Thompson int CeedOperatorCompositeGetMultiplicity(CeedOperator op, CeedInt num_skip_indices, CeedInt *skip_indices, CeedVector mult) {
263775f0d5a4SJeremy L Thompson   Ceed                ceed;
2638b275c451SJeremy L Thompson   CeedInt             num_suboperators;
263975f0d5a4SJeremy L Thompson   CeedSize            l_vec_len;
264075f0d5a4SJeremy L Thompson   CeedScalar         *mult_array;
264175f0d5a4SJeremy L Thompson   CeedVector          ones_l_vec;
26427c1dbaffSSebastian Grimberg   CeedElemRestriction elem_rstr, mult_elem_rstr;
2643b275c451SJeremy L Thompson   CeedOperator       *sub_operators;
264475f0d5a4SJeremy L Thompson 
26451c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
26461c66c397SJeremy L Thompson 
264775f0d5a4SJeremy L Thompson   // Zero mult vector
264875f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(mult, 0.0));
264975f0d5a4SJeremy L Thompson 
265075f0d5a4SJeremy L Thompson   // Get suboperators
2651ed094490SJeremy L Thompson   CeedCall(CeedOperatorCompositeGetNumSub(op, &num_suboperators));
2652b275c451SJeremy L Thompson   if (num_suboperators == 0) return CEED_ERROR_SUCCESS;
2653ed094490SJeremy L Thompson   CeedCall(CeedOperatorCompositeGetSubList(op, &sub_operators));
265475f0d5a4SJeremy L Thompson 
265575f0d5a4SJeremy L Thompson   // Work vector
265675f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetLength(mult, &l_vec_len));
26579bc66399SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
265875f0d5a4SJeremy L Thompson   CeedCall(CeedVectorCreate(ceed, l_vec_len, &ones_l_vec));
26599bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
266075f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(ones_l_vec, 1.0));
266175f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetArray(mult, CEED_MEM_HOST, &mult_array));
266275f0d5a4SJeremy L Thompson 
266375f0d5a4SJeremy L Thompson   // Compute multiplicity across suboperators
2664b275c451SJeremy L Thompson   for (CeedInt i = 0; i < num_suboperators; i++) {
266575f0d5a4SJeremy L Thompson     const CeedScalar *sub_mult_array;
266675f0d5a4SJeremy L Thompson     CeedVector        sub_mult_l_vec, ones_e_vec;
266775f0d5a4SJeremy L Thompson 
266875f0d5a4SJeremy L Thompson     // -- Check for suboperator to skip
266975f0d5a4SJeremy L Thompson     for (CeedInt j = 0; j < num_skip_indices; j++) {
267075f0d5a4SJeremy L Thompson       if (skip_indices[j] == i) continue;
267175f0d5a4SJeremy L Thompson     }
267275f0d5a4SJeremy L Thompson 
267375f0d5a4SJeremy L Thompson     // -- Sub operator multiplicity
2674437c7c90SJeremy L Thompson     CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[i], &elem_rstr));
26757c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr, &mult_elem_rstr));
2676681d0ea7SJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&elem_rstr));
26777c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateVector(mult_elem_rstr, &sub_mult_l_vec, &ones_e_vec));
267875f0d5a4SJeremy L Thompson     CeedCall(CeedVectorSetValue(sub_mult_l_vec, 0.0));
26797c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_NOTRANSPOSE, ones_l_vec, ones_e_vec, CEED_REQUEST_IMMEDIATE));
26807c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_TRANSPOSE, ones_e_vec, sub_mult_l_vec, CEED_REQUEST_IMMEDIATE));
268175f0d5a4SJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(sub_mult_l_vec, CEED_MEM_HOST, &sub_mult_array));
268275f0d5a4SJeremy L Thompson     // ---- Flag every node present in the current suboperator
2683c81f2b9dSJames Wright     for (CeedSize j = 0; j < l_vec_len; j++) {
268475f0d5a4SJeremy L Thompson       if (sub_mult_array[j] > 0.0) mult_array[j] += 1.0;
268575f0d5a4SJeremy L Thompson     }
268675f0d5a4SJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(sub_mult_l_vec, &sub_mult_array));
268775f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&sub_mult_l_vec));
268875f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&ones_e_vec));
26897c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&mult_elem_rstr));
269075f0d5a4SJeremy L Thompson   }
269175f0d5a4SJeremy L Thompson   CeedCall(CeedVectorRestoreArray(mult, &mult_array));
2692811d0ccfSJeremy L Thompson   CeedCall(CeedVectorDestroy(&ones_l_vec));
269375f0d5a4SJeremy L Thompson   return CEED_ERROR_SUCCESS;
269475f0d5a4SJeremy L Thompson }
269575f0d5a4SJeremy L Thompson 
269675f0d5a4SJeremy L Thompson /**
2697ca94c3ddSJeremy L Thompson   @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator`, creating the prolongation basis from the fine and coarse grid interpolation.
2698eaf62fffSJeremy L Thompson 
2699ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable.
2700f04ea552SJeremy L Thompson 
2701ca94c3ddSJeremy L Thompson   @param[in]  op_fine      Fine grid `CeedOperator`
2702ca94c3ddSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator`
2703ca94c3ddSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid `CeedElemRestriction`
2704ca94c3ddSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector `CeedBasis`
2705ca94c3ddSJeremy L Thompson   @param[out] op_coarse    Coarse grid `CeedOperator`
2706ca94c3ddSJeremy L Thompson   @param[out] op_prolong   Coarse to fine `CeedOperator`, or `NULL`
2707ca94c3ddSJeremy L Thompson   @param[out] op_restrict  Fine to coarse `CeedOperator`, or `NULL`
2708eaf62fffSJeremy L Thompson 
2709eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2710eaf62fffSJeremy L Thompson 
2711eaf62fffSJeremy L Thompson   @ref User
2712eaf62fffSJeremy L Thompson **/
27132b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreate(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
27147758292fSSebastian Grimberg                                      CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) {
27151c66c397SJeremy L Thompson   CeedBasis basis_c_to_f = NULL;
27161c66c397SJeremy L Thompson 
27172b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
2718eaf62fffSJeremy L Thompson 
271983d6adf3SZach Atkins   // Build prolongation matrix, if required
27207758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
272183d6adf3SZach Atkins     CeedBasis basis_fine;
27221c66c397SJeremy L Thompson 
27232b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
27242b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateProjection(basis_coarse, basis_fine, &basis_c_to_f));
2725681d0ea7SJeremy L Thompson     CeedCall(CeedBasisDestroy(&basis_fine));
272683d6adf3SZach Atkins   }
2727eaf62fffSJeremy L Thompson 
2728f113e5dcSJeremy L Thompson   // Core code
27291a8516d0SJames Wright   CeedCall(CeedOperatorMultigridLevelCreateSingle_Core(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong,
27301a8516d0SJames Wright                                                        op_restrict));
2731eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2732eaf62fffSJeremy L Thompson }
2733eaf62fffSJeremy L Thompson 
2734eaf62fffSJeremy L Thompson /**
2735ca94c3ddSJeremy L Thompson   @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a tensor basis for the active basis.
2736eaf62fffSJeremy L Thompson 
2737ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable.
2738f04ea552SJeremy L Thompson 
2739ca94c3ddSJeremy L Thompson   @param[in]  op_fine       Fine grid `CeedOperator`
2740ca94c3ddSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator`
2741ca94c3ddSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid `CeedElemRestriction`
2742ca94c3ddSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector `CeedBasis`
2743ca94c3ddSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator`
2744ca94c3ddSJeremy L Thompson   @param[out] op_coarse     Coarse grid `CeedOperator`
2745ca94c3ddSJeremy L Thompson   @param[out] op_prolong    Coarse to fine `CeedOperator`, or `NULL`
2746ca94c3ddSJeremy L Thompson   @param[out] op_restrict   Fine to coarse `CeedOperator`, or `NULL`
2747eaf62fffSJeremy L Thompson 
2748eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2749eaf62fffSJeremy L Thompson 
2750eaf62fffSJeremy L Thompson   @ref User
2751eaf62fffSJeremy L Thompson **/
27522b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateTensorH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
27532b730f8bSJeremy L Thompson                                              const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
27547758292fSSebastian Grimberg                                              CeedOperator *op_restrict) {
2755eaf62fffSJeremy L Thompson   Ceed      ceed;
27561c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
27571c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
27581c66c397SJeremy L Thompson 
27591c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
27602b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2761eaf62fffSJeremy L Thompson 
2762eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
27632b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
27642b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
27652b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
27663f08121cSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION,
27673f08121cSJeremy L Thompson             "Bases must have compatible quadrature spaces."
27683f08121cSJeremy L Thompson             " Fine grid: %" CeedInt_FMT " points, Coarse grid: %" CeedInt_FMT " points",
27693f08121cSJeremy L Thompson             Q_f, Q_c);
2770eaf62fffSJeremy L Thompson 
277183d6adf3SZach Atkins   // Create coarse to fine basis, if required
27727758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
27731c66c397SJeremy L Thompson     CeedInt     dim, num_comp, num_nodes_c, P_1d_f, P_1d_c;
27741c66c397SJeremy L Thompson     CeedScalar *q_ref, *q_weight, *grad;
27751c66c397SJeremy L Thompson 
277683d6adf3SZach Atkins     // Check if interpolation matrix is provided
27776574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
27786574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
27792b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
27802b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
27812b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes1D(basis_fine, &P_1d_f));
2782681d0ea7SJeremy L Thompson     CeedCall(CeedBasisDestroy(&basis_fine));
27832b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
27842b730f8bSJeremy L Thompson     P_1d_c = dim == 1 ? num_nodes_c : dim == 2 ? sqrt(num_nodes_c) : cbrt(num_nodes_c);
27852b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_ref));
27862b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_weight));
27872b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f * P_1d_c * dim, &grad));
27882b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateTensorH1(ceed, dim, num_comp, P_1d_c, P_1d_f, interp_c_to_f, grad, q_ref, q_weight, &basis_c_to_f));
27892b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
27902b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
27912b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
279283d6adf3SZach Atkins   }
2793eaf62fffSJeremy L Thompson 
2794eaf62fffSJeremy L Thompson   // Core code
27951a8516d0SJames Wright   CeedCall(CeedOperatorMultigridLevelCreateSingle_Core(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong,
27961a8516d0SJames Wright                                                        op_restrict));
27979bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
2798eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2799eaf62fffSJeremy L Thompson }
2800eaf62fffSJeremy L Thompson 
2801eaf62fffSJeremy L Thompson /**
2802ca94c3ddSJeremy L Thompson   @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a non-tensor basis for the active vector
2803eaf62fffSJeremy L Thompson 
2804ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable.
2805f04ea552SJeremy L Thompson 
2806ca94c3ddSJeremy L Thompson   @param[in]  op_fine       Fine grid `CeedOperator`
2807ca94c3ddSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator`
2808ca94c3ddSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid `CeedElemRestriction`
2809ca94c3ddSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector `CeedBasis`
2810ca94c3ddSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator`
2811ca94c3ddSJeremy L Thompson   @param[out] op_coarse     Coarse grid `CeedOperator`
2812ca94c3ddSJeremy L Thompson   @param[out] op_prolong    Coarse to fine `CeedOperator`, or `NULL`
2813ca94c3ddSJeremy L Thompson   @param[out] op_restrict   Fine to coarse `CeedOperator`, or `NULL`
2814eaf62fffSJeremy L Thompson 
2815eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2816eaf62fffSJeremy L Thompson 
2817eaf62fffSJeremy L Thompson   @ref User
2818eaf62fffSJeremy L Thompson **/
28192b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
28207758292fSSebastian Grimberg                                        const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
28217758292fSSebastian Grimberg                                        CeedOperator *op_restrict) {
2822eaf62fffSJeremy L Thompson   Ceed      ceed;
28231c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
28241c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
28251c66c397SJeremy L Thompson 
28261c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
28272b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2828eaf62fffSJeremy L Thompson 
2829eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
28302b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
28312b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
28322b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
28336574a04fSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces");
2834eaf62fffSJeremy L Thompson 
2835eaf62fffSJeremy L Thompson   // Coarse to fine basis
28367758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
28371c66c397SJeremy L Thompson     CeedInt          dim, num_comp, num_nodes_c, num_nodes_f;
28381c66c397SJeremy L Thompson     CeedScalar      *q_ref, *q_weight, *grad;
28391c66c397SJeremy L Thompson     CeedElemTopology topo;
28401c66c397SJeremy L Thompson 
284183d6adf3SZach Atkins     // Check if interpolation matrix is provided
28426574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
28436574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
28442b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetTopology(basis_fine, &topo));
28452b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
28462b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
28472b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes(basis_fine, &num_nodes_f));
2848681d0ea7SJeremy L Thompson     CeedCall(CeedBasisDestroy(&basis_fine));
28492b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
28502b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * dim, &q_ref));
28512b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f, &q_weight));
28522b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * num_nodes_c * dim, &grad));
28532b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateH1(ceed, topo, num_comp, num_nodes_c, num_nodes_f, interp_c_to_f, grad, q_ref, q_weight, &basis_c_to_f));
28542b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
28552b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
28562b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
285783d6adf3SZach Atkins   }
2858eaf62fffSJeremy L Thompson 
2859eaf62fffSJeremy L Thompson   // Core code
28601a8516d0SJames Wright   CeedCall(CeedOperatorMultigridLevelCreateSingle_Core(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong,
28611a8516d0SJames Wright                                                        op_restrict));
28629bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
2863eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2864eaf62fffSJeremy L Thompson }
2865eaf62fffSJeremy L Thompson 
2866eaf62fffSJeremy L Thompson /**
2867ca94c3ddSJeremy L Thompson   @brief Build a FDM based approximate inverse for each element for a `CeedOperator`.
2868eaf62fffSJeremy L Thompson 
2869ca94c3ddSJeremy L Thompson   This returns a `CeedOperator` and `CeedVector` to apply a Fast Diagonalization Method based approximate inverse.
2870859c15bbSJames Wright   This function obtains the simultaneous diagonalization for the 1D mass and Laplacian operators, \f$M = V^T V, K = V^T S V\f$.
2871ca94c3ddSJeremy L Thompson   The assembled `CeedQFunction` is used to modify the eigenvalues from simultaneous diagonalization and obtain an approximate inverse of the form \f$V^T \hat S V\f$.
2872ca94c3ddSJeremy L Thompson   The `CeedOperator` must be linear and non-composite.
2873ca94c3ddSJeremy L Thompson   The associated `CeedQFunction` must therefore also be linear.
2874eaf62fffSJeremy L Thompson 
2875ca94c3ddSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable.
2876f04ea552SJeremy L Thompson 
2877ca94c3ddSJeremy L Thompson   @param[in]  op      `CeedOperator` to create element inverses
2878ca94c3ddSJeremy L Thompson   @param[out] fdm_inv `CeedOperator` to apply the action of a FDM based inverse for each element
2879ca94c3ddSJeremy L Thompson   @param[in]  request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2880eaf62fffSJeremy L Thompson 
2881eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2882eaf62fffSJeremy L Thompson 
2883480fae85SJeremy L Thompson   @ref User
2884eaf62fffSJeremy L Thompson **/
28852b730f8bSJeremy L Thompson int CeedOperatorCreateFDMElementInverse(CeedOperator op, CeedOperator *fdm_inv, CeedRequest *request) {
28861c66c397SJeremy L Thompson   Ceed                 ceed, ceed_parent;
28871c66c397SJeremy L Thompson   bool                 interp = false, grad = false, is_tensor_basis = true;
28881c66c397SJeremy L Thompson   CeedInt              num_input_fields, P_1d, Q_1d, num_nodes, num_qpts, dim, num_comp = 1, num_elem = 1;
28891c66c397SJeremy L Thompson   CeedScalar          *mass, *laplace, *x, *fdm_interp, *lambda, *elem_avg;
28901c66c397SJeremy L Thompson   const CeedScalar    *interp_1d, *grad_1d, *q_weight_1d;
28911c66c397SJeremy L Thompson   CeedVector           q_data;
28921c66c397SJeremy L Thompson   CeedElemRestriction  rstr  = NULL, rstr_qd_i;
28931c66c397SJeremy L Thompson   CeedBasis            basis = NULL, fdm_basis;
28941c66c397SJeremy L Thompson   CeedQFunctionContext ctx_fdm;
28951c66c397SJeremy L Thompson   CeedQFunctionField  *qf_fields;
28961c66c397SJeremy L Thompson   CeedQFunction        qf, qf_fdm;
28971c66c397SJeremy L Thompson   CeedOperatorField   *op_fields;
28981c66c397SJeremy L Thompson 
28992b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2900eaf62fffSJeremy L Thompson 
2901eaf62fffSJeremy L Thompson   if (op->CreateFDMElementInverse) {
2902d04bbc78SJeremy L Thompson     // Backend version
29032b730f8bSJeremy L Thompson     CeedCall(op->CreateFDMElementInverse(op, fdm_inv, request));
2904eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2905eaf62fffSJeremy L Thompson   } else {
2906d04bbc78SJeremy L Thompson     // Operator fallback
2907d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2908d04bbc78SJeremy L Thompson 
2909ca38d01dSJeremy L Thompson     CeedDebug(CeedOperatorReturnCeed(op), "\nFalling back for CeedOperatorCreateFDMElementInverse\n");
29102b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2911d04bbc78SJeremy L Thompson     if (op_fallback) {
29122b730f8bSJeremy L Thompson       CeedCall(CeedOperatorCreateFDMElementInverse(op_fallback, fdm_inv, request));
2913eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2914eaf62fffSJeremy L Thompson     }
2915eaf62fffSJeremy L Thompson   }
2916eaf62fffSJeremy L Thompson 
2917d04bbc78SJeremy L Thompson   // Default interface implementation
29182b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
2919bb229da9SJeremy L Thompson   CeedCall(CeedOperatorGetFallbackParentCeed(op, &ceed_parent));
29202b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
2921eaf62fffSJeremy L Thompson 
2922eaf62fffSJeremy L Thompson   // Determine active input basis
29232b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, &num_input_fields, &op_fields, NULL, NULL));
29242b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL));
2925eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
2926eaf62fffSJeremy L Thompson     CeedVector vec;
29271c66c397SJeremy L Thompson 
29282b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
2929eaf62fffSJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
2930eaf62fffSJeremy L Thompson       CeedEvalMode eval_mode;
29311c66c397SJeremy L Thompson 
29322b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
2933eaf62fffSJeremy L Thompson       interp = interp || eval_mode == CEED_EVAL_INTERP;
2934eaf62fffSJeremy L Thompson       grad   = grad || eval_mode == CEED_EVAL_GRAD;
2935681d0ea7SJeremy L Thompson       if (!basis) CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis));
2936681d0ea7SJeremy L Thompson       if (!rstr) CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &rstr));
2937eaf62fffSJeremy L Thompson     }
2938681d0ea7SJeremy L Thompson     CeedCall(CeedVectorDestroy(&vec));
2939eaf62fffSJeremy L Thompson   }
29406574a04fSJeremy L Thompson   CeedCheck(basis, ceed, CEED_ERROR_BACKEND, "No active field set");
29412b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumNodes1D(basis, &P_1d));
2942352a5e7cSSebastian Grimberg   CeedCall(CeedBasisGetNumNodes(basis, &num_nodes));
29432b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints1D(basis, &Q_1d));
29442b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis, &num_qpts));
29452b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetDimension(basis, &dim));
29462b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis, &num_comp));
29472b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
2948eaf62fffSJeremy L Thompson 
2949eaf62fffSJeremy L Thompson   // Build and diagonalize 1D Mass and Laplacian
29506574a04fSJeremy L Thompson   CeedCall(CeedBasisIsTensor(basis, &is_tensor_basis));
29516574a04fSJeremy L Thompson   CeedCheck(is_tensor_basis, ceed, CEED_ERROR_BACKEND, "FDMElementInverse only supported for tensor bases");
29522b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &mass));
29532b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &laplace));
29542b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &x));
29552b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &fdm_interp));
29562b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d, &lambda));
2957eaf62fffSJeremy L Thompson   // -- Build matrices
29582b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetInterp1D(basis, &interp_1d));
29592b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetGrad1D(basis, &grad_1d));
29602b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetQWeights(basis, &q_weight_1d));
29612b730f8bSJeremy L Thompson   CeedCall(CeedBuildMassLaplace(interp_1d, grad_1d, q_weight_1d, P_1d, Q_1d, dim, mass, laplace));
2962eaf62fffSJeremy L Thompson 
2963eaf62fffSJeremy L Thompson   // -- Diagonalize
29642b730f8bSJeremy L Thompson   CeedCall(CeedSimultaneousDiagonalization(ceed, laplace, mass, x, lambda, P_1d));
29652b730f8bSJeremy L Thompson   CeedCall(CeedFree(&mass));
29662b730f8bSJeremy L Thompson   CeedCall(CeedFree(&laplace));
29672b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
29682b730f8bSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) fdm_interp[i + j * P_1d] = x[j + i * P_1d];
29692b730f8bSJeremy L Thompson   }
29702b730f8bSJeremy L Thompson   CeedCall(CeedFree(&x));
2971eaf62fffSJeremy L Thompson 
29721c66c397SJeremy L Thompson   {
29731c66c397SJeremy L Thompson     CeedInt             layout[3], num_modes = (interp ? 1 : 0) + (grad ? dim : 0);
29741c66c397SJeremy L Thompson     CeedScalar          max_norm = 0;
29751c66c397SJeremy L Thompson     const CeedScalar   *assembled_array, *q_weight_array;
29761c66c397SJeremy L Thompson     CeedVector          assembled = NULL, q_weight;
2977c5f45aeaSJeremy L Thompson     CeedElemRestriction rstr_qf   = NULL;
29781c66c397SJeremy L Thompson 
29791c66c397SJeremy L Thompson     // Assemble QFunction
29802b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled, &rstr_qf, request));
298156c48462SJeremy L Thompson     CeedCall(CeedElemRestrictionGetELayout(rstr_qf, layout));
29822b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr_qf));
29832b730f8bSJeremy L Thompson     CeedCall(CeedVectorNorm(assembled, CEED_NORM_MAX, &max_norm));
2984eaf62fffSJeremy L Thompson 
2985eaf62fffSJeremy L Thompson     // Calculate element averages
29862b730f8bSJeremy L Thompson     CeedCall(CeedVectorCreate(ceed_parent, num_qpts, &q_weight));
29872b730f8bSJeremy L Thompson     CeedCall(CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_weight));
29882b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(assembled, CEED_MEM_HOST, &assembled_array));
29892b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(q_weight, CEED_MEM_HOST, &q_weight_array));
29902b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_elem, &elem_avg));
2991eaf62fffSJeremy L Thompson     const CeedScalar qf_value_bound = max_norm * 100 * CEED_EPSILON;
29921c66c397SJeremy L Thompson 
2993eaf62fffSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
2994eaf62fffSJeremy L Thompson       CeedInt count = 0;
29951c66c397SJeremy L Thompson 
29962b730f8bSJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
29972b730f8bSJeremy L Thompson         for (CeedInt i = 0; i < num_comp * num_comp * num_modes * num_modes; i++) {
29982b730f8bSJeremy L Thompson           if (fabs(assembled_array[q * layout[0] + i * layout[1] + e * layout[2]]) > qf_value_bound) {
29992b730f8bSJeremy L Thompson             elem_avg[e] += assembled_array[q * layout[0] + i * layout[1] + e * layout[2]] / q_weight_array[q];
3000eaf62fffSJeremy L Thompson             count++;
3001eaf62fffSJeremy L Thompson           }
30022b730f8bSJeremy L Thompson         }
30032b730f8bSJeremy L Thompson       }
3004eaf62fffSJeremy L Thompson       if (count) {
3005eaf62fffSJeremy L Thompson         elem_avg[e] /= count;
3006eaf62fffSJeremy L Thompson       } else {
3007eaf62fffSJeremy L Thompson         elem_avg[e] = 1.0;
3008eaf62fffSJeremy L Thompson       }
3009eaf62fffSJeremy L Thompson     }
30102b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(assembled, &assembled_array));
30112b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled));
30122b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(q_weight, &q_weight_array));
30132b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&q_weight));
30141c66c397SJeremy L Thompson   }
3015eaf62fffSJeremy L Thompson 
3016eaf62fffSJeremy L Thompson   // Build FDM diagonal
30171c66c397SJeremy L Thompson   {
3018eaf62fffSJeremy L Thompson     CeedScalar *q_data_array, *fdm_diagonal;
30191c66c397SJeremy L Thompson 
3020352a5e7cSSebastian Grimberg     CeedCall(CeedCalloc(num_comp * num_nodes, &fdm_diagonal));
3021352a5e7cSSebastian Grimberg     const CeedScalar fdm_diagonal_bound = num_nodes * CEED_EPSILON;
30222b730f8bSJeremy L Thompson     for (CeedInt c = 0; c < num_comp; c++) {
3023352a5e7cSSebastian Grimberg       for (CeedInt n = 0; n < num_nodes; n++) {
3024352a5e7cSSebastian Grimberg         if (interp) fdm_diagonal[c * num_nodes + n] = 1.0;
30252b730f8bSJeremy L Thompson         if (grad) {
3026eaf62fffSJeremy L Thompson           for (CeedInt d = 0; d < dim; d++) {
3027eaf62fffSJeremy L Thompson             CeedInt i = (n / CeedIntPow(P_1d, d)) % P_1d;
3028352a5e7cSSebastian Grimberg             fdm_diagonal[c * num_nodes + n] += lambda[i];
3029eaf62fffSJeremy L Thompson           }
3030eaf62fffSJeremy L Thompson         }
3031352a5e7cSSebastian Grimberg         if (fabs(fdm_diagonal[c * num_nodes + n]) < fdm_diagonal_bound) fdm_diagonal[c * num_nodes + n] = fdm_diagonal_bound;
30322b730f8bSJeremy L Thompson       }
30332b730f8bSJeremy L Thompson     }
3034352a5e7cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed_parent, num_elem * num_comp * num_nodes, &q_data));
30352b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(q_data, 0.0));
30362b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayWrite(q_data, CEED_MEM_HOST, &q_data_array));
30372b730f8bSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
30382b730f8bSJeremy L Thompson       for (CeedInt c = 0; c < num_comp; c++) {
30396c10af5dSJeremy L Thompson         for (CeedInt n = 0; n < num_nodes; n++) {
30401c66c397SJeremy L Thompson           q_data_array[(e * num_comp + c) * num_nodes + n] = 1. / (elem_avg[e] * fdm_diagonal[c * num_nodes + n]);
30412b730f8bSJeremy L Thompson         }
30422b730f8bSJeremy L Thompson       }
30436c10af5dSJeremy L Thompson     }
30442b730f8bSJeremy L Thompson     CeedCall(CeedFree(&elem_avg));
30452b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_diagonal));
30462b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(q_data, &q_data_array));
30471c66c397SJeremy L Thompson   }
3048eaf62fffSJeremy L Thompson 
3049eaf62fffSJeremy L Thompson   // Setup FDM operator
3050eaf62fffSJeremy L Thompson   // -- Basis
30511c66c397SJeremy L Thompson   {
3052eaf62fffSJeremy L Thompson     CeedScalar *grad_dummy, *q_ref_dummy, *q_weight_dummy;
30531c66c397SJeremy L Thompson 
30542b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d * P_1d, &grad_dummy));
30552b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_ref_dummy));
30562b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_weight_dummy));
30572b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateTensorH1(ceed_parent, dim, num_comp, P_1d, P_1d, fdm_interp, grad_dummy, q_ref_dummy, q_weight_dummy, &fdm_basis));
30582b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_interp));
30592b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad_dummy));
30602b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref_dummy));
30612b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight_dummy));
30622b730f8bSJeremy L Thompson     CeedCall(CeedFree(&lambda));
30631c66c397SJeremy L Thompson   }
3064eaf62fffSJeremy L Thompson 
3065eaf62fffSJeremy L Thompson   // -- Restriction
30661c66c397SJeremy L Thompson   {
3067352a5e7cSSebastian Grimberg     CeedInt strides[3] = {1, num_nodes, num_nodes * num_comp};
30680a5597ceSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateStrided(ceed_parent, num_elem, num_nodes, num_comp,
30690a5597ceSJeremy L Thompson                                               (CeedSize)num_elem * (CeedSize)num_comp * (CeedSize)num_nodes, strides, &rstr_qd_i));
30701c66c397SJeremy L Thompson   }
30711c66c397SJeremy L Thompson 
3072eaf62fffSJeremy L Thompson   // -- QFunction
30732b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionCreateInteriorByName(ceed_parent, "Scale", &qf_fdm));
30742b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "input", num_comp, CEED_EVAL_INTERP));
30752b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "scale", num_comp, CEED_EVAL_NONE));
30762b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddOutput(qf_fdm, "output", num_comp, CEED_EVAL_INTERP));
30772b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_fdm, num_comp));
30781c66c397SJeremy L Thompson 
3079eaf62fffSJeremy L Thompson   // -- QFunction context
30801c66c397SJeremy L Thompson   {
3081eaf62fffSJeremy L Thompson     CeedInt *num_comp_data;
30821c66c397SJeremy L Thompson 
30832b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_data));
3084eaf62fffSJeremy L Thompson     num_comp_data[0] = num_comp;
30852b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_fdm));
30862b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_fdm, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_data), num_comp_data));
30871c66c397SJeremy L Thompson   }
30882b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetContext(qf_fdm, ctx_fdm));
30892b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionContextDestroy(&ctx_fdm));
30901c66c397SJeremy L Thompson 
3091eaf62fffSJeremy L Thompson   // -- Operator
30922b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCreate(ceed_parent, qf_fdm, NULL, NULL, fdm_inv));
30932b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "input", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
3094356036faSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "scale", rstr_qd_i, CEED_BASIS_NONE, q_data));
30952b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "output", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
3096eaf62fffSJeremy L Thompson 
3097eaf62fffSJeremy L Thompson   // Cleanup
30989bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed));
30999bc66399SJeremy L Thompson   CeedCall(CeedDestroy(&ceed_parent));
31002b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&q_data));
3101681d0ea7SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr));
31022b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_qd_i));
3103681d0ea7SJeremy L Thompson   CeedCall(CeedBasisDestroy(&basis));
3104681d0ea7SJeremy L Thompson   CeedCall(CeedBasisDestroy(&fdm_basis));
3105c11e12f4SJeremy L Thompson   CeedCall(CeedQFunctionDestroy(&qf));
31062b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionDestroy(&qf_fdm));
3107eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
3108eaf62fffSJeremy L Thompson }
3109eaf62fffSJeremy L Thompson 
3110eaf62fffSJeremy L Thompson /// @}
3111