xref: /libCEED/rust/libceed-sys/c-src/interface/ceed-preconditioning.c (revision 1c66c397a67401e1a222857807e6e5b7c45b88c0) !
13d8e8822SJeremy L Thompson // Copyright (c) 2017-2022, 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 /**
27ea61e9acSJeremy L Thompson   @brief Duplicate a CeedQFunction with a reference Ceed to fallback for advanced CeedOperator functionality
289e77b9c8SJeremy L Thompson 
2901ea9c81SJed Brown   @param[in]  fallback_ceed Ceed on which to create fallback CeedQFunction
309e77b9c8SJeremy L Thompson   @param[in]  qf            CeedQFunction to create fallback for
3101ea9c81SJed Brown   @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) {
38*1c66c397SJeremy L Thompson   char *source_path_with_name = NULL;
39*1c66c397SJeremy L Thompson 
409e77b9c8SJeremy L Thompson   // Check if NULL qf passed in
419e77b9c8SJeremy L Thompson   if (!qf) return CEED_ERROR_SUCCESS;
429e77b9c8SJeremy L Thompson 
43d04bbc78SJeremy L Thompson   CeedDebug256(qf->ceed, 1, "---------- CeedOperator Fallback ----------\n");
4413f886e9SJeremy L Thompson   CeedDebug(qf->ceed, "Creating fallback CeedQFunction\n");
45d04bbc78SJeremy L Thompson 
469e77b9c8SJeremy L Thompson   if (qf->source_path) {
472b730f8bSJeremy L Thompson     size_t path_len = strlen(qf->source_path), name_len = strlen(qf->kernel_name);
482b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(path_len + name_len + 2, &source_path_with_name));
499e77b9c8SJeremy L Thompson     memcpy(source_path_with_name, qf->source_path, path_len);
509e77b9c8SJeremy L Thompson     memcpy(&source_path_with_name[path_len], ":", 1);
519e77b9c8SJeremy L Thompson     memcpy(&source_path_with_name[path_len + 1], qf->kernel_name, name_len);
529e77b9c8SJeremy L Thompson   } else {
532b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &source_path_with_name));
549e77b9c8SJeremy L Thompson   }
559e77b9c8SJeremy L Thompson 
562b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionCreateInterior(fallback_ceed, qf->vec_length, qf->function, source_path_with_name, qf_fallback));
579e77b9c8SJeremy L Thompson   {
589e77b9c8SJeremy L Thompson     CeedQFunctionContext ctx;
599e77b9c8SJeremy L Thompson 
602b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionGetContext(qf, &ctx));
612b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(*qf_fallback, ctx));
629e77b9c8SJeremy L Thompson   }
639e77b9c8SJeremy L Thompson   for (CeedInt i = 0; i < qf->num_input_fields; i++) {
642b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(*qf_fallback, qf->input_fields[i]->field_name, qf->input_fields[i]->size, qf->input_fields[i]->eval_mode));
659e77b9c8SJeremy L Thompson   }
669e77b9c8SJeremy L Thompson   for (CeedInt i = 0; i < qf->num_output_fields; i++) {
672b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(*qf_fallback, qf->output_fields[i]->field_name, qf->output_fields[i]->size, qf->output_fields[i]->eval_mode));
689e77b9c8SJeremy L Thompson   }
692b730f8bSJeremy L Thompson   CeedCall(CeedFree(&source_path_with_name));
709e77b9c8SJeremy L Thompson   return CEED_ERROR_SUCCESS;
719e77b9c8SJeremy L Thompson }
729e77b9c8SJeremy L Thompson 
739e77b9c8SJeremy L Thompson /**
74ea61e9acSJeremy L Thompson   @brief Duplicate a CeedOperator with a reference Ceed to fallback for advanced CeedOperator functionality
75eaf62fffSJeremy L Thompson 
76ea61e9acSJeremy L Thompson   @param[in,out] op CeedOperator to create fallback for
77eaf62fffSJeremy L Thompson 
78eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
79eaf62fffSJeremy L Thompson 
80eaf62fffSJeremy L Thompson   @ref Developer
81eaf62fffSJeremy L Thompson **/
82d04bbc78SJeremy L Thompson static int CeedOperatorCreateFallback(CeedOperator op) {
839e77b9c8SJeremy L Thompson   Ceed         ceed_fallback;
84*1c66c397SJeremy L Thompson   bool         is_composite;
85*1c66c397SJeremy L Thompson   CeedOperator op_fallback;
86eaf62fffSJeremy L Thompson 
87805fe78eSJeremy L Thompson   // Check not already created
88805fe78eSJeremy L Thompson   if (op->op_fallback) return CEED_ERROR_SUCCESS;
89805fe78eSJeremy L Thompson 
90eaf62fffSJeremy L Thompson   // Fallback Ceed
912b730f8bSJeremy L Thompson   CeedCall(CeedGetOperatorFallbackCeed(op->ceed, &ceed_fallback));
92d04bbc78SJeremy L Thompson   if (!ceed_fallback) return CEED_ERROR_SUCCESS;
93d04bbc78SJeremy L Thompson 
94d04bbc78SJeremy L Thompson   CeedDebug256(op->ceed, 1, "---------- CeedOperator Fallback ----------\n");
9513f886e9SJeremy L Thompson   CeedDebug(op->ceed, "Creating fallback CeedOperator\n");
96eaf62fffSJeremy L Thompson 
97eaf62fffSJeremy L Thompson   // Clone Op
98b275c451SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
99b275c451SJeremy L Thompson   if (is_composite) {
100b275c451SJeremy L Thompson     CeedInt       num_suboperators;
101b275c451SJeremy L Thompson     CeedOperator *sub_operators;
102b275c451SJeremy L Thompson 
1032b730f8bSJeremy L Thompson     CeedCall(CeedCompositeOperatorCreate(ceed_fallback, &op_fallback));
104b275c451SJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
105b275c451SJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
106b275c451SJeremy L Thompson     for (CeedInt i = 0; i < num_suboperators; i++) {
107d04bbc78SJeremy L Thompson       CeedOperator op_sub_fallback;
108d04bbc78SJeremy L Thompson 
109b275c451SJeremy L Thompson       CeedCall(CeedOperatorGetFallback(sub_operators[i], &op_sub_fallback));
1102b730f8bSJeremy L Thompson       CeedCall(CeedCompositeOperatorAddSub(op_fallback, op_sub_fallback));
111805fe78eSJeremy L Thompson     }
112805fe78eSJeremy L Thompson   } else {
1139e77b9c8SJeremy L Thompson     CeedQFunction qf_fallback = NULL, dqf_fallback = NULL, dqfT_fallback = NULL;
114*1c66c397SJeremy L Thompson 
1152b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->qf, &qf_fallback));
1162b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqf, &dqf_fallback));
1172b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqfT, &dqfT_fallback));
1182b730f8bSJeremy L Thompson     CeedCall(CeedOperatorCreate(ceed_fallback, qf_fallback, dqf_fallback, dqfT_fallback, &op_fallback));
119805fe78eSJeremy L Thompson     for (CeedInt i = 0; i < op->qf->num_input_fields; i++) {
120437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(op_fallback, op->input_fields[i]->field_name, op->input_fields[i]->elem_rstr, op->input_fields[i]->basis,
1212b730f8bSJeremy L Thompson                                     op->input_fields[i]->vec));
122805fe78eSJeremy L Thompson     }
123805fe78eSJeremy L Thompson     for (CeedInt i = 0; i < op->qf->num_output_fields; i++) {
124437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(op_fallback, op->output_fields[i]->field_name, op->output_fields[i]->elem_rstr, op->output_fields[i]->basis,
1252b730f8bSJeremy L Thompson                                     op->output_fields[i]->vec));
126805fe78eSJeremy L Thompson     }
1272b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataReferenceCopy(op->qf_assembled, &op_fallback->qf_assembled));
128febe2972SJeremy L Thompson     if (op_fallback->num_qpts == 0) CeedCall(CeedOperatorSetNumQuadraturePoints(op_fallback, op->num_qpts));
1299e77b9c8SJeremy L Thompson     // Cleanup
1302b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&qf_fallback));
1312b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqf_fallback));
1322b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqfT_fallback));
133805fe78eSJeremy L Thompson   }
1342b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetName(op_fallback, op->name));
1352b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fallback));
136b05f7e9fSJeremy L Thompson   // Note: No ref-counting here so we don't get caught in a reference loop.
137b05f7e9fSJeremy L Thompson   //       The op holds the only reference to op_fallback and is responsible for deleting itself and op_fallback.
138805fe78eSJeremy L Thompson   op->op_fallback                 = op_fallback;
139b05f7e9fSJeremy L Thompson   op_fallback->op_fallback_parent = op;
140eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
141eaf62fffSJeremy L Thompson }
142eaf62fffSJeremy L Thompson 
143eaf62fffSJeremy L Thompson /**
144ea61e9acSJeremy L Thompson   @brief Retrieve fallback CeedOperator with a reference Ceed for advanced CeedOperator functionality
145d04bbc78SJeremy L Thompson 
146d04bbc78SJeremy L Thompson   @param[in]  op          CeedOperator to retrieve fallback for
147d04bbc78SJeremy L Thompson   @param[out] op_fallback Fallback CeedOperator
148d04bbc78SJeremy L Thompson 
149d04bbc78SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
150d04bbc78SJeremy L Thompson 
151d04bbc78SJeremy L Thompson   @ref Developer
152d04bbc78SJeremy L Thompson **/
153d04bbc78SJeremy L Thompson int CeedOperatorGetFallback(CeedOperator op, CeedOperator *op_fallback) {
154d04bbc78SJeremy L Thompson   // Create if needed
155*1c66c397SJeremy L Thompson   if (!op->op_fallback) CeedCall(CeedOperatorCreateFallback(op));
156d04bbc78SJeremy L Thompson   if (op->op_fallback) {
157d04bbc78SJeremy L Thompson     bool is_debug;
158d04bbc78SJeremy L Thompson 
1592b730f8bSJeremy L Thompson     CeedCall(CeedIsDebug(op->ceed, &is_debug));
160d04bbc78SJeremy L Thompson     if (is_debug) {
161b275c451SJeremy L Thompson       Ceed        ceed, ceed_fallback;
162d04bbc78SJeremy L Thompson       const char *resource, *resource_fallback;
163d04bbc78SJeremy L Thompson 
164b275c451SJeremy L Thompson       CeedCall(CeedOperatorGetCeed(op, &ceed));
165b275c451SJeremy L Thompson       CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback));
166b275c451SJeremy L Thompson       CeedCall(CeedGetResource(ceed, &resource));
1672b730f8bSJeremy L Thompson       CeedCall(CeedGetResource(ceed_fallback, &resource_fallback));
168d04bbc78SJeremy L Thompson 
16923d4529eSJeremy L Thompson       CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "---------- CeedOperator Fallback ----------\n");
170b275c451SJeremy L Thompson       CeedDebug(ceed, "Falling back from %s operator at address %ld to %s operator at address %ld\n", resource, op, resource_fallback,
1712b730f8bSJeremy L Thompson                 op->op_fallback);
172d04bbc78SJeremy L Thompson     }
173d04bbc78SJeremy L Thompson   }
174d04bbc78SJeremy L Thompson   *op_fallback = op->op_fallback;
175d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
176d04bbc78SJeremy L Thompson }
177d04bbc78SJeremy L Thompson 
178d04bbc78SJeremy L Thompson /**
179eaf62fffSJeremy L Thompson   @brief Select correct basis matrix pointer based on CeedEvalMode
180eaf62fffSJeremy L Thompson 
181352a5e7cSSebastian Grimberg   @param[in]  basis     CeedBasis from which to get the basis matrix
182eaf62fffSJeremy L Thompson   @param[in]  eval_mode Current basis evaluation mode
183eaf62fffSJeremy L Thompson   @param[in]  identity  Pointer to identity matrix
184eaf62fffSJeremy L Thompson   @param[out] basis_ptr Basis pointer to set
185eaf62fffSJeremy L Thompson 
186eaf62fffSJeremy L Thompson   @ref Developer
187eaf62fffSJeremy L Thompson **/
188352a5e7cSSebastian Grimberg static inline int CeedOperatorGetBasisPointer(CeedBasis basis, CeedEvalMode eval_mode, const CeedScalar *identity, const CeedScalar **basis_ptr) {
189eaf62fffSJeremy L Thompson   switch (eval_mode) {
190eaf62fffSJeremy L Thompson     case CEED_EVAL_NONE:
191eaf62fffSJeremy L Thompson       *basis_ptr = identity;
192eaf62fffSJeremy L Thompson       break;
193eaf62fffSJeremy L Thompson     case CEED_EVAL_INTERP:
194352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetInterp(basis, basis_ptr));
195eaf62fffSJeremy L Thompson       break;
196eaf62fffSJeremy L Thompson     case CEED_EVAL_GRAD:
197352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetGrad(basis, basis_ptr));
198352a5e7cSSebastian Grimberg       break;
199352a5e7cSSebastian Grimberg     case CEED_EVAL_DIV:
200352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetDiv(basis, basis_ptr));
201352a5e7cSSebastian Grimberg       break;
202352a5e7cSSebastian Grimberg     case CEED_EVAL_CURL:
203352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetCurl(basis, basis_ptr));
204eaf62fffSJeremy L Thompson       break;
205eaf62fffSJeremy L Thompson     case CEED_EVAL_WEIGHT:
206eaf62fffSJeremy L Thompson       break;  // Caught by QF Assembly
207eaf62fffSJeremy L Thompson   }
208ed9e99e6SJeremy L Thompson   assert(*basis_ptr != NULL);
209352a5e7cSSebastian Grimberg   return CEED_ERROR_SUCCESS;
210eaf62fffSJeremy L Thompson }
211eaf62fffSJeremy L Thompson 
212eaf62fffSJeremy L Thompson /**
213eaf62fffSJeremy L Thompson   @brief Create point block restriction for active operator field
214eaf62fffSJeremy L Thompson 
215eaf62fffSJeremy L Thompson   @param[in]  rstr            Original CeedElemRestriction for active field
216ea61e9acSJeremy L Thompson   @param[out] pointblock_rstr Address of the variable where the newly created CeedElemRestriction will be stored
217eaf62fffSJeremy L Thompson 
218eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
219eaf62fffSJeremy L Thompson 
220eaf62fffSJeremy L Thompson   @ref Developer
221eaf62fffSJeremy L Thompson **/
2222b730f8bSJeremy L Thompson static int CeedOperatorCreateActivePointBlockRestriction(CeedElemRestriction rstr, CeedElemRestriction *pointblock_rstr) {
223eaf62fffSJeremy L Thompson   Ceed           ceed;
224*1c66c397SJeremy L Thompson   CeedInt        num_elem, num_comp, shift, elem_size, comp_stride, *pointblock_offsets;
225*1c66c397SJeremy L Thompson   CeedSize       l_size;
226eaf62fffSJeremy L Thompson   const CeedInt *offsets;
227*1c66c397SJeremy L Thompson 
228*1c66c397SJeremy L Thompson   CeedCall(CeedElemRestrictionGetCeed(rstr, &ceed));
2292b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetOffsets(rstr, CEED_MEM_HOST, &offsets));
230eaf62fffSJeremy L Thompson 
231eaf62fffSJeremy L Thompson   // Expand offsets
2322b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
2332b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp));
2342b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size));
2352b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetCompStride(rstr, &comp_stride));
2362b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size));
237*1c66c397SJeremy L Thompson   shift = num_comp;
2382b730f8bSJeremy L Thompson   if (comp_stride != 1) shift *= num_comp;
2392b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(num_elem * elem_size, &pointblock_offsets));
240eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_elem * elem_size; i++) {
241eaf62fffSJeremy L Thompson     pointblock_offsets[i] = offsets[i] * shift;
242eaf62fffSJeremy L Thompson   }
243eaf62fffSJeremy L Thompson 
244eaf62fffSJeremy L Thompson   // Create new restriction
2452b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionCreate(ceed, num_elem, elem_size, num_comp * num_comp, 1, l_size * num_comp, CEED_MEM_HOST, CEED_OWN_POINTER,
2462b730f8bSJeremy L Thompson                                      pointblock_offsets, pointblock_rstr));
247eaf62fffSJeremy L Thompson 
248eaf62fffSJeremy L Thompson   // Cleanup
2492b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionRestoreOffsets(rstr, &offsets));
250eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
251eaf62fffSJeremy L Thompson }
252eaf62fffSJeremy L Thompson 
253eaf62fffSJeremy L Thompson /**
254eaf62fffSJeremy L Thompson   @brief Core logic for assembling operator diagonal or point block diagonal
255eaf62fffSJeremy L Thompson 
256eaf62fffSJeremy L Thompson   @param[in]  op            CeedOperator to assemble point block diagonal
257ea61e9acSJeremy L Thompson   @param[in]  request       Address of CeedRequest for non-blocking completion, else CEED_REQUEST_IMMEDIATE
258eaf62fffSJeremy L Thompson   @param[in]  is_pointblock Boolean flag to assemble diagonal or point block diagonal
259eaf62fffSJeremy L Thompson   @param[out] assembled     CeedVector to store assembled diagonal
260eaf62fffSJeremy L Thompson 
261eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
262eaf62fffSJeremy L Thompson 
263eaf62fffSJeremy L Thompson   @ref Developer
264eaf62fffSJeremy L Thompson **/
2652b730f8bSJeremy L Thompson static inline int CeedSingleOperatorAssembleAddDiagonal_Core(CeedOperator op, CeedRequest *request, const bool is_pointblock, CeedVector assembled) {
266eaf62fffSJeremy L Thompson   Ceed                ceed;
267*1c66c397SJeremy L Thompson   CeedInt             num_input_fields, num_output_fields;
268*1c66c397SJeremy L Thompson   CeedInt             layout[3];
269437c7c90SJeremy L Thompson   const CeedScalar   *assembled_qf_array;
270c5f45aeaSJeremy L Thompson   CeedVector          assembled_qf        = NULL;
271c5f45aeaSJeremy L Thompson   CeedElemRestriction assembled_elem_rstr = NULL;
272*1c66c397SJeremy L Thompson   CeedQFunction       qf;
273437c7c90SJeremy L Thompson 
274*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
275*1c66c397SJeremy L Thompson 
276*1c66c397SJeremy L Thompson   // Assemble QFunction
277437c7c90SJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
278437c7c90SJeremy L Thompson   CeedCall(CeedQFunctionGetNumArgs(qf, &num_input_fields, &num_output_fields));
279437c7c90SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, request));
280437c7c90SJeremy L Thompson   CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, &layout));
281437c7c90SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr));
282437c7c90SJeremy L Thompson   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
283eaf62fffSJeremy L Thompson 
284ed9e99e6SJeremy L Thompson   // Get assembly data
285437c7c90SJeremy L Thompson   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
286437c7c90SJeremy L Thompson   CeedInt                 *num_eval_modes_in, *num_eval_modes_out, num_active_bases;
287437c7c90SJeremy L Thompson   CeedSize               **eval_mode_offsets_in, **eval_mode_offsets_out, num_output_components;
288437c7c90SJeremy L Thompson   CeedElemRestriction     *active_elem_rstrs;
289*1c66c397SJeremy L Thompson   CeedBasis               *active_bases;
290*1c66c397SJeremy L Thompson   CeedOperatorAssemblyData data;
291*1c66c397SJeremy L Thompson 
292437c7c90SJeremy L Thompson   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
293437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases, &num_eval_modes_in, &eval_modes_in, &eval_mode_offsets_in,
294437c7c90SJeremy L Thompson                                                 &num_eval_modes_out, &eval_modes_out, &eval_mode_offsets_out, &num_output_components));
295437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases, NULL, NULL));
296437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, NULL, &active_elem_rstrs));
297437c7c90SJeremy L Thompson 
298437c7c90SJeremy L Thompson   // Loop over all active bases
299437c7c90SJeremy L Thompson   for (CeedInt b = 0; b < num_active_bases; b++) {
300*1c66c397SJeremy L Thompson     bool                has_eval_none = false;
301*1c66c397SJeremy L Thompson     CeedInt             num_elem, num_nodes, num_qpts, num_components;
302*1c66c397SJeremy L Thompson     CeedScalar         *elem_diag_array, *identity = NULL;
303*1c66c397SJeremy L Thompson     CeedVector          elem_diag;
3047c1dbaffSSebastian Grimberg     CeedElemRestriction diag_elem_rstr;
305*1c66c397SJeremy L Thompson 
306*1c66c397SJeremy L Thompson     // Assemble point block diagonal restriction, if needed
307eaf62fffSJeremy L Thompson     if (is_pointblock) {
3087c1dbaffSSebastian Grimberg       CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstrs[b], &diag_elem_rstr));
3097c1dbaffSSebastian Grimberg     } else {
3107c1dbaffSSebastian Grimberg       CeedCall(CeedElemRestrictionCreateUnsignedCopy(active_elem_rstrs[b], &diag_elem_rstr));
311eaf62fffSJeremy L Thompson     }
312eaf62fffSJeremy L Thompson 
313eaf62fffSJeremy L Thompson     // Create diagonal vector
314437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(diag_elem_rstr, NULL, &elem_diag));
315eaf62fffSJeremy L Thompson 
316eaf62fffSJeremy L Thompson     // Assemble element operator diagonals
3172b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(elem_diag, 0.0));
3182b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArray(elem_diag, CEED_MEM_HOST, &elem_diag_array));
319437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionGetNumElements(diag_elem_rstr, &num_elem));
320437c7c90SJeremy L Thompson     CeedCall(CeedBasisGetNumNodes(active_bases[b], &num_nodes));
321437c7c90SJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(active_bases[b], &num_components));
322437c7c90SJeremy L Thompson     CeedCall(CeedBasisGetNumQuadraturePoints(active_bases[b], &num_qpts));
323ed9e99e6SJeremy L Thompson 
324352a5e7cSSebastian Grimberg     // Construct identity matrix for basis if required
325437c7c90SJeremy L Thompson     for (CeedInt i = 0; i < num_eval_modes_in[b]; i++) {
326437c7c90SJeremy L Thompson       has_eval_none = has_eval_none || (eval_modes_in[b][i] == CEED_EVAL_NONE);
327ed9e99e6SJeremy L Thompson     }
328437c7c90SJeremy L Thompson     for (CeedInt i = 0; i < num_eval_modes_out[b]; i++) {
329437c7c90SJeremy L Thompson       has_eval_none = has_eval_none || (eval_modes_out[b][i] == CEED_EVAL_NONE);
330ed9e99e6SJeremy L Thompson     }
331ed9e99e6SJeremy L Thompson     if (has_eval_none) {
3322b730f8bSJeremy L Thompson       CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
3332b730f8bSJeremy L Thompson       for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) identity[i * num_nodes + i] = 1.0;
334eaf62fffSJeremy L Thompson     }
335352a5e7cSSebastian Grimberg 
336eaf62fffSJeremy L Thompson     // Compute the diagonal of B^T D B
337eaf62fffSJeremy L Thompson     // Each element
338b94338b9SJed Brown     for (CeedSize e = 0; e < num_elem; e++) {
339eaf62fffSJeremy L Thompson       // Each basis eval mode pair
340352a5e7cSSebastian Grimberg       CeedInt      d_out              = 0, q_comp_out;
341352a5e7cSSebastian Grimberg       CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
342*1c66c397SJeremy L Thompson 
343437c7c90SJeremy L Thompson       for (CeedInt e_out = 0; e_out < num_eval_modes_out[b]; e_out++) {
344*1c66c397SJeremy L Thompson         CeedInt           d_in              = 0, q_comp_in;
345437c7c90SJeremy L Thompson         const CeedScalar *B_t               = NULL;
346*1c66c397SJeremy L Thompson         CeedEvalMode      eval_mode_in_prev = CEED_EVAL_NONE;
347*1c66c397SJeremy L Thompson 
348352a5e7cSSebastian Grimberg         CeedOperatorGetBasisPointer(active_bases[b], eval_modes_out[b][e_out], identity, &B_t);
349352a5e7cSSebastian Grimberg         CeedCall(CeedBasisGetNumQuadratureComponents(active_bases[b], eval_modes_out[b][e_out], &q_comp_out));
350352a5e7cSSebastian Grimberg         if (q_comp_out > 1) {
351352a5e7cSSebastian Grimberg           if (e_out == 0 || eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0;
352352a5e7cSSebastian Grimberg           else B_t = &B_t[(++d_out) * num_qpts * num_nodes];
353352a5e7cSSebastian Grimberg         }
354352a5e7cSSebastian Grimberg         eval_mode_out_prev = eval_modes_out[b][e_out];
355352a5e7cSSebastian Grimberg 
356437c7c90SJeremy L Thompson         for (CeedInt e_in = 0; e_in < num_eval_modes_in[b]; e_in++) {
357437c7c90SJeremy L Thompson           const CeedScalar *B = NULL;
358*1c66c397SJeremy L Thompson 
359352a5e7cSSebastian Grimberg           CeedOperatorGetBasisPointer(active_bases[b], eval_modes_in[b][e_in], identity, &B);
360352a5e7cSSebastian Grimberg           CeedCall(CeedBasisGetNumQuadratureComponents(active_bases[b], eval_modes_in[b][e_in], &q_comp_in));
361352a5e7cSSebastian Grimberg           if (q_comp_in > 1) {
362352a5e7cSSebastian Grimberg             if (e_in == 0 || eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0;
363352a5e7cSSebastian Grimberg             else B = &B[(++d_in) * num_qpts * num_nodes];
364352a5e7cSSebastian Grimberg           }
365352a5e7cSSebastian Grimberg           eval_mode_in_prev = eval_modes_in[b][e_in];
366352a5e7cSSebastian Grimberg 
367eaf62fffSJeremy L Thompson           // Each component
368437c7c90SJeremy L Thompson           for (CeedInt c_out = 0; c_out < num_components; c_out++) {
369437c7c90SJeremy L Thompson             // Each qpt/node pair
3702b730f8bSJeremy L Thompson             for (CeedInt q = 0; q < num_qpts; q++) {
371eaf62fffSJeremy L Thompson               if (is_pointblock) {
372eaf62fffSJeremy L Thompson                 // Point Block Diagonal
373437c7c90SJeremy L Thompson                 for (CeedInt c_in = 0; c_in < num_components; c_in++) {
374b94338b9SJed Brown                   const CeedSize c_offset = (eval_mode_offsets_in[b][e_in] + c_in) * num_output_components + eval_mode_offsets_out[b][e_out] + c_out;
375437c7c90SJeremy L Thompson                   const CeedScalar qf_value = assembled_qf_array[q * layout[0] + c_offset * layout[1] + e * layout[2]];
376*1c66c397SJeremy L Thompson 
3772b730f8bSJeremy L Thompson                   for (CeedInt n = 0; n < num_nodes; n++) {
378437c7c90SJeremy L Thompson                     elem_diag_array[((e * num_components + c_out) * num_components + c_in) * num_nodes + n] +=
379437c7c90SJeremy L Thompson                         B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
380eaf62fffSJeremy L Thompson                   }
3812b730f8bSJeremy L Thompson                 }
382eaf62fffSJeremy L Thompson               } else {
383eaf62fffSJeremy L Thompson                 // Diagonal Only
384437c7c90SJeremy L Thompson                 const CeedInt    c_offset = (eval_mode_offsets_in[b][e_in] + c_out) * num_output_components + eval_mode_offsets_out[b][e_out] + c_out;
385437c7c90SJeremy L Thompson                 const CeedScalar qf_value = assembled_qf_array[q * layout[0] + c_offset * layout[1] + e * layout[2]];
386*1c66c397SJeremy L Thompson 
3872b730f8bSJeremy L Thompson                 for (CeedInt n = 0; n < num_nodes; n++) {
388437c7c90SJeremy L Thompson                   elem_diag_array[(e * num_components + c_out) * num_nodes + n] += B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
389eaf62fffSJeremy L Thompson                 }
390eaf62fffSJeremy L Thompson               }
391eaf62fffSJeremy L Thompson             }
392eaf62fffSJeremy L Thompson           }
3932b730f8bSJeremy L Thompson         }
3942b730f8bSJeremy L Thompson       }
3952b730f8bSJeremy L Thompson     }
3962b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(elem_diag, &elem_diag_array));
397eaf62fffSJeremy L Thompson 
398eaf62fffSJeremy L Thompson     // Assemble local operator diagonal
3997c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(diag_elem_rstr, CEED_TRANSPOSE, elem_diag, assembled, request));
400eaf62fffSJeremy L Thompson 
401eaf62fffSJeremy L Thompson     // Cleanup
4027c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&diag_elem_rstr));
4032b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&elem_diag));
4042b730f8bSJeremy L Thompson     CeedCall(CeedFree(&identity));
405437c7c90SJeremy L Thompson   }
406437c7c90SJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
407437c7c90SJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
408eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
409eaf62fffSJeremy L Thompson }
410eaf62fffSJeremy L Thompson 
411eaf62fffSJeremy L Thompson /**
412eaf62fffSJeremy L Thompson   @brief Core logic for assembling composite operator diagonal
413eaf62fffSJeremy L Thompson 
414eaf62fffSJeremy L Thompson   @param[in]  op            CeedOperator to assemble point block diagonal
415ea61e9acSJeremy L Thompson   @param[in]  request       Address of CeedRequest for non-blocking completion, else CEED_REQUEST_IMMEDIATE
416eaf62fffSJeremy L Thompson   @param[in]  is_pointblock Boolean flag to assemble diagonal or point block diagonal
417eaf62fffSJeremy 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 **/
4232b730f8bSJeremy L Thompson static inline int CeedCompositeOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_pointblock,
424eaf62fffSJeremy L Thompson                                                                  CeedVector assembled) {
425eaf62fffSJeremy L Thompson   CeedInt       num_sub;
426eaf62fffSJeremy L Thompson   CeedOperator *suboperators;
427*1c66c397SJeremy L Thompson 
428c6ebc35dSJeremy L Thompson   CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub));
429c6ebc35dSJeremy L Thompson   CeedCall(CeedCompositeOperatorGetSubList(op, &suboperators));
430eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_sub; i++) {
4316aa95790SJeremy L Thompson     if (is_pointblock) {
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 /**
441eaf62fffSJeremy L Thompson   @brief Build nonzero pattern for non-composite operator
442eaf62fffSJeremy L Thompson 
443eaf62fffSJeremy L Thompson   Users should generally use CeedOperatorLinearAssembleSymbolic()
444eaf62fffSJeremy L Thompson 
445eaf62fffSJeremy 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 **/
4542b730f8bSJeremy L Thompson static int CeedSingleOperatorAssembleSymbolic(CeedOperator op, CeedInt offset, CeedInt *rows, CeedInt *cols) {
455f3d47e36SJeremy L Thompson   Ceed                ceed;
456f3d47e36SJeremy L Thompson   bool                is_composite;
457*1c66c397SJeremy L Thompson   CeedInt             num_elem, elem_size, num_comp, layout_er[3], local_num_entries;
458*1c66c397SJeremy L Thompson   CeedSize            num_nodes, count = 0;
459*1c66c397SJeremy L Thompson   CeedScalar         *array;
460*1c66c397SJeremy L Thompson   const CeedScalar   *elem_dof_a;
461*1c66c397SJeremy L Thompson   CeedVector          index_vec, elem_dof;
462*1c66c397SJeremy L Thompson   CeedElemRestriction active_rstr, index_elem_rstr;
463*1c66c397SJeremy L Thompson 
464f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
465f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
4666574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
467eaf62fffSJeremy L Thompson 
4682b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &num_nodes, NULL));
4697c1dbaffSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestriction(op, &active_rstr));
4707c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionCreateUnorientedCopy(active_rstr, &index_elem_rstr));
4717c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(index_elem_rstr, &num_elem));
4727c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(index_elem_rstr, &elem_size));
4737c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(index_elem_rstr, &num_comp));
4747c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionGetELayout(index_elem_rstr, &layout_er));
475*1c66c397SJeremy L Thompson   local_num_entries = elem_size * num_comp * elem_size * num_comp * num_elem;
476eaf62fffSJeremy L Thompson 
477eaf62fffSJeremy L Thompson   // Determine elem_dof relation
4782b730f8bSJeremy L Thompson   CeedCall(CeedVectorCreate(ceed, num_nodes, &index_vec));
4792b730f8bSJeremy L Thompson   CeedCall(CeedVectorGetArrayWrite(index_vec, CEED_MEM_HOST, &array));
480ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_nodes; i++) array[i] = i;
4812b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArray(index_vec, &array));
4822b730f8bSJeremy L Thompson   CeedCall(CeedVectorCreate(ceed, num_elem * elem_size * num_comp, &elem_dof));
4832b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(elem_dof, 0.0));
4847c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionApply(index_elem_rstr, CEED_NOTRANSPOSE, index_vec, elem_dof, CEED_REQUEST_IMMEDIATE));
4852b730f8bSJeremy L Thompson   CeedCall(CeedVectorGetArrayRead(elem_dof, CEED_MEM_HOST, &elem_dof_a));
4862b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&index_vec));
487eaf62fffSJeremy L Thompson 
488eaf62fffSJeremy L Thompson   // Determine i, j locations for element matrices
489ed9e99e6SJeremy L Thompson   for (CeedInt e = 0; e < num_elem; e++) {
490ed9e99e6SJeremy L Thompson     for (CeedInt comp_in = 0; comp_in < num_comp; comp_in++) {
491ed9e99e6SJeremy L Thompson       for (CeedInt comp_out = 0; comp_out < num_comp; comp_out++) {
492ed9e99e6SJeremy L Thompson         for (CeedInt i = 0; i < elem_size; i++) {
493ed9e99e6SJeremy L Thompson           for (CeedInt j = 0; j < elem_size; j++) {
4942b730f8bSJeremy L Thompson             const CeedInt elem_dof_index_row = i * layout_er[0] + (comp_out)*layout_er[1] + e * layout_er[2];
4952b730f8bSJeremy L Thompson             const CeedInt elem_dof_index_col = j * layout_er[0] + comp_in * layout_er[1] + e * layout_er[2];
496eaf62fffSJeremy L Thompson             const CeedInt row                = elem_dof_a[elem_dof_index_row];
497eaf62fffSJeremy L Thompson             const CeedInt col                = elem_dof_a[elem_dof_index_col];
498eaf62fffSJeremy L Thompson 
499eaf62fffSJeremy L Thompson             rows[offset + count] = row;
500eaf62fffSJeremy L Thompson             cols[offset + count] = col;
501eaf62fffSJeremy L Thompson             count++;
502eaf62fffSJeremy L Thompson           }
503eaf62fffSJeremy L Thompson         }
504eaf62fffSJeremy L Thompson       }
505eaf62fffSJeremy L Thompson     }
506eaf62fffSJeremy L Thompson   }
5076574a04fSJeremy L Thompson   CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing assembled entries");
5082b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(elem_dof, &elem_dof_a));
5092b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&elem_dof));
5107c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr));
511eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
512eaf62fffSJeremy L Thompson }
513eaf62fffSJeremy L Thompson 
514eaf62fffSJeremy L Thompson /**
515eaf62fffSJeremy L Thompson   @brief Assemble nonzero entries for non-composite operator
516eaf62fffSJeremy L Thompson 
517eaf62fffSJeremy L Thompson   Users should generally use CeedOperatorLinearAssemble()
518eaf62fffSJeremy L Thompson 
519eaf62fffSJeremy L Thompson   @param[in]  op     CeedOperator to assemble
520ea61e9acSJeremy L Thompson   @param[in]  offset Offset for number of entries
521eaf62fffSJeremy L Thompson   @param[out] values Values to assemble into matrix
522eaf62fffSJeremy L Thompson 
523eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
524eaf62fffSJeremy L Thompson 
525eaf62fffSJeremy L Thompson   @ref Developer
526eaf62fffSJeremy L Thompson **/
5272b730f8bSJeremy L Thompson static int CeedSingleOperatorAssemble(CeedOperator op, CeedInt offset, CeedVector values) {
528f3d47e36SJeremy L Thompson   Ceed ceed;
529f3d47e36SJeremy L Thompson   bool is_composite;
530*1c66c397SJeremy L Thompson 
531f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
532f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
533f3d47e36SJeremy L Thompson 
5346574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
535f3d47e36SJeremy L Thompson 
536f3d47e36SJeremy L Thompson   // Early exit for empty operator
537f3d47e36SJeremy L Thompson   {
538f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
539f3d47e36SJeremy L Thompson 
540f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
541f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
542f3d47e36SJeremy L Thompson   }
543eaf62fffSJeremy L Thompson 
544cefa2673SJeremy L Thompson   if (op->LinearAssembleSingle) {
545cefa2673SJeremy L Thompson     // Backend version
5462b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSingle(op, offset, values));
547cefa2673SJeremy L Thompson     return CEED_ERROR_SUCCESS;
548cefa2673SJeremy L Thompson   } else {
549cefa2673SJeremy L Thompson     // Operator fallback
550cefa2673SJeremy L Thompson     CeedOperator op_fallback;
551cefa2673SJeremy L Thompson 
5522b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
553cefa2673SJeremy L Thompson     if (op_fallback) {
5542b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemble(op_fallback, offset, values));
555cefa2673SJeremy L Thompson       return CEED_ERROR_SUCCESS;
556cefa2673SJeremy L Thompson     }
557cefa2673SJeremy L Thompson   }
558cefa2673SJeremy L Thompson 
559eaf62fffSJeremy L Thompson   // Assemble QFunction
560*1c66c397SJeremy L Thompson   const bool     *orients      = NULL;
561*1c66c397SJeremy L Thompson   const CeedInt8 *curl_orients = NULL;
562*1c66c397SJeremy L Thompson   CeedInt *num_eval_modes_in, *num_eval_modes_out, num_active_bases, num_input_fields, num_output_fields, num_elem, elem_size, num_qpts, num_comp,
563*1c66c397SJeremy L Thompson       local_num_entries, layout_qf[3];
564*1c66c397SJeremy L Thompson   const CeedScalar        *assembled_qf_array;
565c5f45aeaSJeremy L Thompson   CeedVector               assembled_qf = NULL;
566*1c66c397SJeremy L Thompson   CeedRestrictionType      rstr_type;
567*1c66c397SJeremy L Thompson   CeedElemRestriction      rstr_q = NULL, active_rstr;
568*1c66c397SJeremy L Thompson   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
569*1c66c397SJeremy L Thompson   CeedBasis               *bases, basis_in;
570*1c66c397SJeremy L Thompson   CeedQFunction            qf;
571*1c66c397SJeremy L Thompson   CeedOperatorAssemblyData data;
572*1c66c397SJeremy L Thompson   CeedOperatorField       *input_fields, *output_fields;
573eaf62fffSJeremy L Thompson 
574*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
575*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &rstr_q, CEED_REQUEST_IMMEDIATE));
5762b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, &num_input_fields, &input_fields, &num_output_fields, &output_fields));
577eaf62fffSJeremy L Thompson 
578ed9e99e6SJeremy L Thompson   // Get assembly data
5792b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
580437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases, &num_eval_modes_in, &eval_modes_in, NULL, &num_eval_modes_out,
581437c7c90SJeremy L Thompson                                                 &eval_modes_out, NULL, NULL));
582437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &bases, NULL, NULL));
583*1c66c397SJeremy L Thompson   basis_in = bases[0];
584eaf62fffSJeremy L Thompson 
5856574a04fSJeremy L Thompson   CeedCheck(num_active_bases == 1, ceed, CEED_ERROR_UNSUPPORTED, "Cannot assemble operator with multiple active bases");
5866574a04fSJeremy L Thompson   CeedCheck(num_eval_modes_in[0] > 0 && num_eval_modes_out[0] > 0, ceed, CEED_ERROR_UNSUPPORTED, "Cannot assemble operator with out inputs/outputs");
587eaf62fffSJeremy L Thompson 
5882b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveElemRestriction(op, &active_rstr));
5892b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(active_rstr, &num_elem));
5902b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetElementSize(active_rstr, &elem_size));
5912b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumComponents(active_rstr, &num_comp));
5922b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_in, &num_qpts));
593*1c66c397SJeremy L Thompson   local_num_entries = elem_size * num_comp * elem_size * num_comp * num_elem;
594eaf62fffSJeremy L Thompson 
5957c1dbaffSSebastian Grimberg   CeedCall(CeedElemRestrictionGetType(active_rstr, &rstr_type));
5967c1dbaffSSebastian Grimberg   if (rstr_type == CEED_RESTRICTION_ORIENTED) {
5977c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionGetOrientations(active_rstr, CEED_MEM_HOST, &orients));
5987c1dbaffSSebastian Grimberg   } else if (rstr_type == CEED_RESTRICTION_CURL_ORIENTED) {
5997c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionGetCurlOrientations(active_rstr, CEED_MEM_HOST, &curl_orients));
6007c1dbaffSSebastian Grimberg   }
6017c1dbaffSSebastian Grimberg 
6027c1dbaffSSebastian Grimberg   // Loop over elements and put in data structure
6032b730f8bSJeremy L Thompson   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
6042b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetELayout(rstr_q, &layout_qf));
6052b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_q));
606eaf62fffSJeremy L Thompson 
6077c1dbaffSSebastian Grimberg   // We store B_mat_in, B_mat_out, BTD, elem_mat in row-major order
608*1c66c397SJeremy L Thompson   CeedSize           count = 0;
609*1c66c397SJeremy L Thompson   CeedScalar        *vals, BTD_mat[elem_size * num_qpts * num_eval_modes_in[0]], elem_mat[elem_size * elem_size];
610437c7c90SJeremy L Thompson   const CeedScalar **B_mats_in, **B_mats_out;
611437c7c90SJeremy L Thompson   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, NULL, &B_mats_in, &B_mats_out));
612437c7c90SJeremy L Thompson   const CeedScalar *B_mat_in = B_mats_in[0], *B_mat_out = B_mats_out[0];
613*1c66c397SJeremy L Thompson 
61428ec399dSJeremy L Thompson   CeedCall(CeedVectorGetArray(values, CEED_MEM_HOST, &vals));
615b94338b9SJed Brown   for (CeedSize e = 0; e < num_elem; e++) {
616ed9e99e6SJeremy L Thompson     for (CeedInt comp_in = 0; comp_in < num_comp; comp_in++) {
617ed9e99e6SJeremy L Thompson       for (CeedInt comp_out = 0; comp_out < num_comp; comp_out++) {
618ed9e99e6SJeremy L Thompson         // Compute B^T*D
619b94338b9SJed Brown         for (CeedSize n = 0; n < elem_size; n++) {
620b94338b9SJed Brown           for (CeedSize q = 0; q < num_qpts; q++) {
621437c7c90SJeremy L Thompson             for (CeedInt e_in = 0; e_in < num_eval_modes_in[0]; e_in++) {
622b94338b9SJed Brown               const CeedSize btd_index = n * (num_qpts * num_eval_modes_in[0]) + (num_eval_modes_in[0] * q + e_in);
623067fd99fSJeremy L Thompson               CeedScalar     sum       = 0.0;
624*1c66c397SJeremy L Thompson 
625437c7c90SJeremy L Thompson               for (CeedInt e_out = 0; e_out < num_eval_modes_out[0]; e_out++) {
626b94338b9SJed Brown                 const CeedSize b_out_index     = (num_eval_modes_out[0] * q + e_out) * elem_size + n;
627b94338b9SJed Brown                 const CeedSize eval_mode_index = ((e_in * num_comp + comp_in) * num_eval_modes_out[0] + e_out) * num_comp + comp_out;
628b94338b9SJed Brown                 const CeedSize qf_index        = q * layout_qf[0] + eval_mode_index * layout_qf[1] + e * layout_qf[2];
629*1c66c397SJeremy L Thompson 
630067fd99fSJeremy L Thompson                 sum += B_mat_out[b_out_index] * assembled_qf_array[qf_index];
631eaf62fffSJeremy L Thompson               }
632067fd99fSJeremy L Thompson               BTD_mat[btd_index] = sum;
633ed9e99e6SJeremy L Thompson             }
634ed9e99e6SJeremy L Thompson           }
635eaf62fffSJeremy L Thompson         }
6367c1dbaffSSebastian Grimberg 
6377c1dbaffSSebastian Grimberg         // Form element matrix itself (for each block component)
638437c7c90SJeremy L Thompson         CeedCall(CeedMatrixMatrixMultiply(ceed, BTD_mat, B_mat_in, elem_mat, elem_size, elem_size, num_qpts * num_eval_modes_in[0]));
639eaf62fffSJeremy L Thompson 
6407c1dbaffSSebastian Grimberg         // Transform the element matrix if required
6417c1dbaffSSebastian Grimberg         if (orients) {
6427c1dbaffSSebastian Grimberg           const bool *elem_orients = &orients[e * elem_size];
643*1c66c397SJeremy L Thompson 
6447c1dbaffSSebastian Grimberg           for (CeedInt i = 0; i < elem_size; i++) {
6457c1dbaffSSebastian Grimberg             for (CeedInt j = 0; j < elem_size; j++) {
6467c1dbaffSSebastian Grimberg               elem_mat[i * elem_size + j] *= elem_orients[i] ? -1.0 : 1.0;
6477c1dbaffSSebastian Grimberg               elem_mat[i * elem_size + j] *= elem_orients[j] ? -1.0 : 1.0;
6487c1dbaffSSebastian Grimberg             }
6497c1dbaffSSebastian Grimberg           }
6507c1dbaffSSebastian Grimberg         } else if (curl_orients) {
6517c1dbaffSSebastian Grimberg           const CeedInt8 *elem_curl_orients = &curl_orients[e * 3 * elem_size];
6527c1dbaffSSebastian Grimberg           CeedScalar      o_elem_mat[elem_size * elem_size];
653*1c66c397SJeremy L Thompson 
6547c1dbaffSSebastian Grimberg           // T^T*(B^T*D*B)
6557c1dbaffSSebastian Grimberg           for (CeedInt i = 0; i < elem_size; i++) {
6567c1dbaffSSebastian Grimberg             for (CeedInt j = 0; j < elem_size; j++) {
6577c1dbaffSSebastian Grimberg               o_elem_mat[i * elem_size + j] = elem_mat[i * elem_size + j] * elem_curl_orients[3 * i + 1] +
6587c1dbaffSSebastian Grimberg                                               (i > 0 ? elem_mat[(i - 1) * elem_size + j] * elem_curl_orients[3 * i - 1] : 0.0) +
6597c1dbaffSSebastian Grimberg                                               (i < elem_size - 1 ? elem_mat[(i + 1) * elem_size + j] * elem_curl_orients[3 * i + 3] : 0.0);
6607c1dbaffSSebastian Grimberg             }
6617c1dbaffSSebastian Grimberg           }
6627c1dbaffSSebastian Grimberg           // T^T*(B^T*D*B)*T
6637c1dbaffSSebastian Grimberg           for (CeedInt i = 0; i < elem_size; i++) {
6647c1dbaffSSebastian Grimberg             for (CeedInt j = 0; j < elem_size; j++) {
6657c1dbaffSSebastian Grimberg               elem_mat[i * elem_size + j] = o_elem_mat[i * elem_size + j] * elem_curl_orients[3 * j + 1] +
6667c1dbaffSSebastian Grimberg                                             (j > 0 ? o_elem_mat[i * elem_size + j - 1] * elem_curl_orients[3 * j - 1] : 0.0) +
6677c1dbaffSSebastian Grimberg                                             (j < elem_size - 1 ? o_elem_mat[i * elem_size + j + 1] * elem_curl_orients[3 * j + 3] : 0.0);
6687c1dbaffSSebastian Grimberg             }
6697c1dbaffSSebastian Grimberg           }
6707c1dbaffSSebastian Grimberg         }
6717c1dbaffSSebastian Grimberg 
6727c1dbaffSSebastian Grimberg         // Put element matrix in coordinate data structure
673ed9e99e6SJeremy L Thompson         for (CeedInt i = 0; i < elem_size; i++) {
674ed9e99e6SJeremy L Thompson           for (CeedInt j = 0; j < elem_size; j++) {
675eaf62fffSJeremy L Thompson             vals[offset + count] = elem_mat[i * elem_size + j];
676eaf62fffSJeremy L Thompson             count++;
677eaf62fffSJeremy L Thompson           }
678eaf62fffSJeremy L Thompson         }
679eaf62fffSJeremy L Thompson       }
680eaf62fffSJeremy L Thompson     }
681eaf62fffSJeremy L Thompson   }
6826574a04fSJeremy L Thompson   CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing entries");
6832b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArray(values, &vals));
684eaf62fffSJeremy L Thompson 
6852b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
6862b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
687eaf62fffSJeremy L Thompson 
6887c1dbaffSSebastian Grimberg   if (rstr_type == CEED_RESTRICTION_ORIENTED) {
6897c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreOrientations(active_rstr, &orients));
6907c1dbaffSSebastian Grimberg   } else if (rstr_type == CEED_RESTRICTION_CURL_ORIENTED) {
6917c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreCurlOrientations(active_rstr, &curl_orients));
6927c1dbaffSSebastian Grimberg   }
693eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
694eaf62fffSJeremy L Thompson }
695eaf62fffSJeremy L Thompson 
696eaf62fffSJeremy L Thompson /**
697eaf62fffSJeremy L Thompson   @brief Count number of entries for assembled CeedOperator
698eaf62fffSJeremy L Thompson 
699eaf62fffSJeremy L Thompson   @param[in]  op          CeedOperator to assemble
700eaf62fffSJeremy L Thompson   @param[out] num_entries Number of entries in assembled representation
701eaf62fffSJeremy L Thompson 
702eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
703eaf62fffSJeremy L Thompson 
704eaf62fffSJeremy L Thompson   @ref Utility
705eaf62fffSJeremy L Thompson **/
706b94338b9SJed Brown static int CeedSingleOperatorAssemblyCountEntries(CeedOperator op, CeedSize *num_entries) {
707b275c451SJeremy L Thompson   bool                is_composite;
708eaf62fffSJeremy L Thompson   CeedInt             num_elem, elem_size, num_comp;
709*1c66c397SJeremy L Thompson   CeedElemRestriction rstr;
710eaf62fffSJeremy L Thompson 
711b275c451SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
7126574a04fSJeremy L Thompson   CeedCheck(!is_composite, op->ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
7132b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveElemRestriction(op, &rstr));
7142b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
7152b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size));
7162b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp));
717b94338b9SJed Brown   *num_entries = (CeedSize)elem_size * num_comp * elem_size * num_comp * num_elem;
718eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
719eaf62fffSJeremy L Thompson }
720eaf62fffSJeremy L Thompson 
721eaf62fffSJeremy L Thompson /**
722ea61e9acSJeremy L Thompson   @brief Common code for creating a multigrid coarse operator and level transfer operators for a CeedOperator
723eaf62fffSJeremy L Thompson 
724eaf62fffSJeremy L Thompson   @param[in]  op_fine      Fine grid operator
72585bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
726eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid restriction
727eaf62fffSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector basis
72885bb9dcfSJeremy L Thompson   @param[in]  basis_c_to_f Basis for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
729eaf62fffSJeremy L Thompson   @param[out] op_coarse    Coarse grid operator
73085bb9dcfSJeremy L Thompson   @param[out] op_prolong   Coarse to fine operator, or NULL
73185bb9dcfSJeremy L Thompson   @param[out] op_restrict  Fine to coarse operator, or NULL
732eaf62fffSJeremy L Thompson 
733eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
734eaf62fffSJeremy L Thompson 
735eaf62fffSJeremy L Thompson   @ref Developer
736eaf62fffSJeremy L Thompson **/
7372b730f8bSJeremy L Thompson static int CeedSingleOperatorMultigridLevel(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
7382b730f8bSJeremy L Thompson                                             CeedBasis basis_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) {
739*1c66c397SJeremy L Thompson   bool                is_composite;
740eaf62fffSJeremy L Thompson   Ceed                ceed;
741*1c66c397SJeremy L Thompson   CeedInt             num_comp;
74285bb9dcfSJeremy L Thompson   CeedVector          mult_vec         = NULL;
743*1c66c397SJeremy L Thompson   CeedElemRestriction rstr_p_mult_fine = NULL, rstr_fine = NULL;
744*1c66c397SJeremy L Thompson 
7452b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
746eaf62fffSJeremy L Thompson 
747eaf62fffSJeremy L Thompson   // Check for composite operator
7482b730f8bSJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op_fine, &is_composite));
7496574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Automatic multigrid setup for composite operators not supported");
750eaf62fffSJeremy L Thompson 
751eaf62fffSJeremy L Thompson   // Coarse Grid
7522b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCreate(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse));
753eaf62fffSJeremy L Thompson   // -- Clone input fields
75492ae7e47SJeremy L Thompson   for (CeedInt i = 0; i < op_fine->qf->num_input_fields; i++) {
755eaf62fffSJeremy L Thompson     if (op_fine->input_fields[i]->vec == CEED_VECTOR_ACTIVE) {
756437c7c90SJeremy L Thompson       rstr_fine = op_fine->input_fields[i]->elem_rstr;
7572b730f8bSJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->input_fields[i]->field_name, rstr_coarse, basis_coarse, CEED_VECTOR_ACTIVE));
758eaf62fffSJeremy L Thompson     } else {
759437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->input_fields[i]->field_name, op_fine->input_fields[i]->elem_rstr,
7602b730f8bSJeremy L Thompson                                     op_fine->input_fields[i]->basis, op_fine->input_fields[i]->vec));
761eaf62fffSJeremy L Thompson     }
762eaf62fffSJeremy L Thompson   }
763eaf62fffSJeremy L Thompson   // -- Clone output fields
76492ae7e47SJeremy L Thompson   for (CeedInt i = 0; i < op_fine->qf->num_output_fields; i++) {
765eaf62fffSJeremy L Thompson     if (op_fine->output_fields[i]->vec == CEED_VECTOR_ACTIVE) {
7662b730f8bSJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->output_fields[i]->field_name, rstr_coarse, basis_coarse, CEED_VECTOR_ACTIVE));
767eaf62fffSJeremy L Thompson     } else {
768437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->output_fields[i]->field_name, op_fine->output_fields[i]->elem_rstr,
7692b730f8bSJeremy L Thompson                                     op_fine->output_fields[i]->basis, op_fine->output_fields[i]->vec));
770eaf62fffSJeremy L Thompson     }
771eaf62fffSJeremy L Thompson   }
772af99e877SJeremy L Thompson   // -- Clone QFunctionAssemblyData
7732b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataReferenceCopy(op_fine->qf_assembled, &(*op_coarse)->qf_assembled));
774eaf62fffSJeremy L Thompson 
775eaf62fffSJeremy L Thompson   // Multiplicity vector
77685bb9dcfSJeremy L Thompson   if (op_restrict || op_prolong) {
77785bb9dcfSJeremy L Thompson     CeedVector          mult_e_vec;
778*1c66c397SJeremy L Thompson     CeedRestrictionType rstr_type;
77985bb9dcfSJeremy L Thompson 
7807c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionGetType(rstr_fine, &rstr_type));
7817c1dbaffSSebastian Grimberg     CeedCheck(rstr_type != CEED_RESTRICTION_CURL_ORIENTED, ceed, CEED_ERROR_UNSUPPORTED,
7827c1dbaffSSebastian Grimberg               "Element restrictions created with CeedElemRestrictionCreateCurlOriented are not supported");
7836574a04fSJeremy L Thompson     CeedCheck(p_mult_fine, ceed, CEED_ERROR_INCOMPATIBLE, "Prolongation or restriction operator creation requires fine grid multiplicity vector");
7847c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnsignedCopy(rstr_fine, &rstr_p_mult_fine));
7852b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(rstr_fine, &mult_vec, &mult_e_vec));
7862b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_e_vec, 0.0));
787c17ec2beSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_NOTRANSPOSE, p_mult_fine, mult_e_vec, CEED_REQUEST_IMMEDIATE));
7882b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_vec, 0.0));
789c17ec2beSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_TRANSPOSE, mult_e_vec, mult_vec, CEED_REQUEST_IMMEDIATE));
7902b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&mult_e_vec));
7912b730f8bSJeremy L Thompson     CeedCall(CeedVectorReciprocal(mult_vec));
79285bb9dcfSJeremy L Thompson   }
793eaf62fffSJeremy L Thompson 
794addd79feSZach Atkins   // Clone name
795addd79feSZach Atkins   bool   has_name = op_fine->name;
796addd79feSZach Atkins   size_t name_len = op_fine->name ? strlen(op_fine->name) : 0;
797addd79feSZach Atkins   CeedCall(CeedOperatorSetName(*op_coarse, op_fine->name));
798addd79feSZach Atkins 
79983d6adf3SZach Atkins   // Check that coarse to fine basis is provided if prolong/restrict operators are requested
8006574a04fSJeremy L Thompson   CeedCheck(basis_c_to_f || (!op_restrict && !op_prolong), ceed, CEED_ERROR_INCOMPATIBLE,
8016574a04fSJeremy L Thompson             "Prolongation or restriction operator creation requires coarse-to-fine basis");
80283d6adf3SZach Atkins 
80385bb9dcfSJeremy L Thompson   // Restriction/Prolongation Operators
8042b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis_coarse, &num_comp));
805addd79feSZach Atkins 
806addd79feSZach Atkins   // Restriction
807addd79feSZach Atkins   if (op_restrict) {
808eaf62fffSJeremy L Thompson     CeedInt             *num_comp_r_data;
80985bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_r;
810*1c66c397SJeremy L Thompson     CeedQFunction        qf_restrict;
81185bb9dcfSJeremy L Thompson 
81285bb9dcfSJeremy L Thompson     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_restrict));
8132b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_r_data));
814eaf62fffSJeremy L Thompson     num_comp_r_data[0] = num_comp;
8152b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_r));
8162b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_r, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_r_data), num_comp_r_data));
8172b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(qf_restrict, ctx_r));
8182b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_r));
8192b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_restrict, "input", num_comp, CEED_EVAL_NONE));
8202b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_restrict, "scale", num_comp, CEED_EVAL_NONE));
8212b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(qf_restrict, "output", num_comp, CEED_EVAL_INTERP));
8222b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_restrict, num_comp));
823eaf62fffSJeremy L Thompson 
8242b730f8bSJeremy L Thompson     CeedCall(CeedOperatorCreate(ceed, qf_restrict, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_restrict));
8252b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_restrict, "input", rstr_fine, CEED_BASIS_COLLOCATED, CEED_VECTOR_ACTIVE));
826c17ec2beSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_restrict, "scale", rstr_p_mult_fine, CEED_BASIS_COLLOCATED, mult_vec));
8272b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_restrict, "output", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
828eaf62fffSJeremy L Thompson 
829addd79feSZach Atkins     // Set name
830addd79feSZach Atkins     char *restriction_name;
831*1c66c397SJeremy L Thompson 
832addd79feSZach Atkins     CeedCall(CeedCalloc(17 + name_len, &restriction_name));
833addd79feSZach Atkins     sprintf(restriction_name, "restriction%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
834addd79feSZach Atkins     CeedCall(CeedOperatorSetName(*op_restrict, restriction_name));
835addd79feSZach Atkins     CeedCall(CeedFree(&restriction_name));
836addd79feSZach Atkins 
837addd79feSZach Atkins     // Check
838addd79feSZach Atkins     CeedCall(CeedOperatorCheckReady(*op_restrict));
839addd79feSZach Atkins 
840addd79feSZach Atkins     // Cleanup
841addd79feSZach Atkins     CeedCall(CeedQFunctionDestroy(&qf_restrict));
842addd79feSZach Atkins   }
843addd79feSZach Atkins 
844eaf62fffSJeremy L Thompson   // Prolongation
845addd79feSZach Atkins   if (op_prolong) {
846eaf62fffSJeremy L Thompson     CeedInt             *num_comp_p_data;
84785bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_p;
848*1c66c397SJeremy L Thompson     CeedQFunction        qf_prolong;
84985bb9dcfSJeremy L Thompson 
85085bb9dcfSJeremy L Thompson     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_prolong));
8512b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_p_data));
852eaf62fffSJeremy L Thompson     num_comp_p_data[0] = num_comp;
8532b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_p));
8542b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_p, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_p_data), num_comp_p_data));
8552b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(qf_prolong, ctx_p));
8562b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_p));
8572b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "input", num_comp, CEED_EVAL_INTERP));
8582b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "scale", num_comp, CEED_EVAL_NONE));
8592b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(qf_prolong, "output", num_comp, CEED_EVAL_NONE));
8602b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_prolong, num_comp));
861eaf62fffSJeremy L Thompson 
8622b730f8bSJeremy L Thompson     CeedCall(CeedOperatorCreate(ceed, qf_prolong, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_prolong));
8632b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "input", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
864c17ec2beSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "scale", rstr_p_mult_fine, CEED_BASIS_COLLOCATED, mult_vec));
8652b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "output", rstr_fine, CEED_BASIS_COLLOCATED, CEED_VECTOR_ACTIVE));
866eaf62fffSJeremy L Thompson 
867addd79feSZach Atkins     // Set name
868ea6b5821SJeremy L Thompson     char *prolongation_name;
869*1c66c397SJeremy L Thompson 
8702b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(18 + name_len, &prolongation_name));
8712b730f8bSJeremy L Thompson     sprintf(prolongation_name, "prolongation%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
8722b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetName(*op_prolong, prolongation_name));
8732b730f8bSJeremy L Thompson     CeedCall(CeedFree(&prolongation_name));
874addd79feSZach Atkins 
875addd79feSZach Atkins     // Check
876addd79feSZach Atkins     CeedCall(CeedOperatorCheckReady(*op_prolong));
877addd79feSZach Atkins 
878addd79feSZach Atkins     // Cleanup
879addd79feSZach Atkins     CeedCall(CeedQFunctionDestroy(&qf_prolong));
880ea6b5821SJeremy L Thompson   }
881ea6b5821SJeremy L Thompson 
88258e4b056SJeremy L Thompson   // Check
88358e4b056SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(*op_coarse));
88458e4b056SJeremy L Thompson 
885eaf62fffSJeremy L Thompson   // Cleanup
8862b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&mult_vec));
887c17ec2beSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_fine));
8882b730f8bSJeremy L Thompson   CeedCall(CeedBasisDestroy(&basis_c_to_f));
889eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
890eaf62fffSJeremy L Thompson }
891eaf62fffSJeremy L Thompson 
892eaf62fffSJeremy L Thompson /**
893eaf62fffSJeremy L Thompson   @brief Build 1D mass matrix and Laplacian with perturbation
894eaf62fffSJeremy L Thompson 
895eaf62fffSJeremy L Thompson   @param[in]  interp_1d   Interpolation matrix in one dimension
896eaf62fffSJeremy L Thompson   @param[in]  grad_1d     Gradient matrix in one dimension
897eaf62fffSJeremy L Thompson   @param[in]  q_weight_1d Quadrature weights in one dimension
898eaf62fffSJeremy L Thompson   @param[in]  P_1d        Number of basis nodes in one dimension
899eaf62fffSJeremy L Thompson   @param[in]  Q_1d        Number of quadrature points in one dimension
900eaf62fffSJeremy L Thompson   @param[in]  dim         Dimension of basis
901eaf62fffSJeremy L Thompson   @param[out] mass        Assembled mass matrix in one dimension
902eaf62fffSJeremy L Thompson   @param[out] laplace     Assembled perturbed Laplacian in one dimension
903eaf62fffSJeremy L Thompson 
904eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
905eaf62fffSJeremy L Thompson 
906eaf62fffSJeremy L Thompson   @ref Developer
907eaf62fffSJeremy L Thompson **/
9082c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOff
9092c2ea1dbSJeremy L Thompson static int CeedBuildMassLaplace(const CeedScalar *interp_1d, const CeedScalar *grad_1d, const CeedScalar *q_weight_1d, CeedInt P_1d, CeedInt Q_1d,
9102c2ea1dbSJeremy L Thompson                                 CeedInt dim, CeedScalar *mass, CeedScalar *laplace) {
9112b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
912eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
913eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
9142b730f8bSJeremy 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];
915eaf62fffSJeremy L Thompson       mass[i + j * P_1d] = sum;
916eaf62fffSJeremy L Thompson     }
9172b730f8bSJeremy L Thompson   }
918eaf62fffSJeremy L Thompson   // -- Laplacian
9192b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
920eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
921eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
922*1c66c397SJeremy L Thompson 
9232b730f8bSJeremy 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];
924eaf62fffSJeremy L Thompson       laplace[i + j * P_1d] = sum;
925eaf62fffSJeremy L Thompson     }
9262b730f8bSJeremy L Thompson   }
927eaf62fffSJeremy L Thompson   CeedScalar perturbation = dim > 2 ? 1e-6 : 1e-4;
9282b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) laplace[i + P_1d * i] += perturbation;
929eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
930eaf62fffSJeremy L Thompson }
9312c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOn
932eaf62fffSJeremy L Thompson 
933eaf62fffSJeremy L Thompson /// @}
934eaf62fffSJeremy L Thompson 
935eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
936480fae85SJeremy L Thompson /// CeedOperator Backend API
937480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
938480fae85SJeremy L Thompson /// @addtogroup CeedOperatorBackend
939480fae85SJeremy L Thompson /// @{
940480fae85SJeremy L Thompson 
941480fae85SJeremy L Thompson /**
942480fae85SJeremy L Thompson   @brief Create object holding CeedQFunction assembly data for CeedOperator
943480fae85SJeremy L Thompson 
944480fae85SJeremy L Thompson   @param[in]  ceed A Ceed object where the CeedQFunctionAssemblyData will be created
945ea61e9acSJeremy L Thompson   @param[out] data Address of the variable where the newly created CeedQFunctionAssemblyData will be stored
946480fae85SJeremy L Thompson 
947480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
948480fae85SJeremy L Thompson 
949480fae85SJeremy L Thompson   @ref Backend
950480fae85SJeremy L Thompson **/
951ea61e9acSJeremy L Thompson int CeedQFunctionAssemblyDataCreate(Ceed ceed, CeedQFunctionAssemblyData *data) {
9522b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
953480fae85SJeremy L Thompson   (*data)->ref_count = 1;
954480fae85SJeremy L Thompson   (*data)->ceed      = ceed;
9552b730f8bSJeremy L Thompson   CeedCall(CeedReference(ceed));
956480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
957480fae85SJeremy L Thompson }
958480fae85SJeremy L Thompson 
959480fae85SJeremy L Thompson /**
960480fae85SJeremy L Thompson   @brief Increment the reference counter for a CeedQFunctionAssemblyData
961480fae85SJeremy L Thompson 
962ea61e9acSJeremy L Thompson   @param[in,out] data CeedQFunctionAssemblyData to increment the reference counter
963480fae85SJeremy L Thompson 
964480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
965480fae85SJeremy L Thompson 
966480fae85SJeremy L Thompson   @ref Backend
967480fae85SJeremy L Thompson **/
968480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataReference(CeedQFunctionAssemblyData data) {
969480fae85SJeremy L Thompson   data->ref_count++;
970480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
971480fae85SJeremy L Thompson }
972480fae85SJeremy L Thompson 
973480fae85SJeremy L Thompson /**
974beecbf24SJeremy L Thompson   @brief Set re-use of CeedQFunctionAssemblyData
9758b919e6bSJeremy L Thompson 
976ea61e9acSJeremy L Thompson   @param[in,out] data       CeedQFunctionAssemblyData to mark for reuse
977ea61e9acSJeremy L Thompson   @param[in]     reuse_data Boolean flag indicating data re-use
9788b919e6bSJeremy L Thompson 
9798b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
9808b919e6bSJeremy L Thompson 
9818b919e6bSJeremy L Thompson   @ref Backend
9828b919e6bSJeremy L Thompson **/
9832b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetReuse(CeedQFunctionAssemblyData data, bool reuse_data) {
984beecbf24SJeremy L Thompson   data->reuse_data        = reuse_data;
985beecbf24SJeremy L Thompson   data->needs_data_update = true;
986beecbf24SJeremy L Thompson   return CEED_ERROR_SUCCESS;
987beecbf24SJeremy L Thompson }
988beecbf24SJeremy L Thompson 
989beecbf24SJeremy L Thompson /**
990beecbf24SJeremy L Thompson   @brief Mark QFunctionAssemblyData as stale
991beecbf24SJeremy L Thompson 
992ea61e9acSJeremy L Thompson   @param[in,out] data              CeedQFunctionAssemblyData to mark as stale
993ea61e9acSJeremy L Thompson   @param[in]     needs_data_update Boolean flag indicating if update is needed or completed
994beecbf24SJeremy L Thompson 
995beecbf24SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
996beecbf24SJeremy L Thompson 
997beecbf24SJeremy L Thompson   @ref Backend
998beecbf24SJeremy L Thompson **/
9992b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetUpdateNeeded(CeedQFunctionAssemblyData data, bool needs_data_update) {
1000beecbf24SJeremy L Thompson   data->needs_data_update = needs_data_update;
10018b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
10028b919e6bSJeremy L Thompson }
10038b919e6bSJeremy L Thompson 
10048b919e6bSJeremy L Thompson /**
10058b919e6bSJeremy L Thompson   @brief Determine if QFunctionAssemblyData needs update
10068b919e6bSJeremy L Thompson 
10078b919e6bSJeremy L Thompson   @param[in]  data             CeedQFunctionAssemblyData to mark as stale
10088b919e6bSJeremy L Thompson   @param[out] is_update_needed Boolean flag indicating if re-assembly is required
10098b919e6bSJeremy L Thompson 
10108b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
10118b919e6bSJeremy L Thompson 
10128b919e6bSJeremy L Thompson   @ref Backend
10138b919e6bSJeremy L Thompson **/
10142b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsUpdateNeeded(CeedQFunctionAssemblyData data, bool *is_update_needed) {
1015beecbf24SJeremy L Thompson   *is_update_needed = !data->reuse_data || data->needs_data_update;
10168b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
10178b919e6bSJeremy L Thompson }
10188b919e6bSJeremy L Thompson 
10198b919e6bSJeremy L Thompson /**
1020ea61e9acSJeremy L Thompson   @brief Copy the pointer to a CeedQFunctionAssemblyData.
10214385fb7fSSebastian Grimberg 
1022ea61e9acSJeremy L Thompson   Both pointers should be destroyed with `CeedCeedQFunctionAssemblyDataDestroy()`.
1023512bb800SJeremy L Thompson 
1024512bb800SJeremy 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
1025512bb800SJeremy L Thompson         CeedQFunctionAssemblyData. This CeedQFunctionAssemblyData will be destroyed if `data_copy` is the only reference to this
1026512bb800SJeremy L Thompson         CeedQFunctionAssemblyData.
1027480fae85SJeremy L Thompson 
1028ea61e9acSJeremy L Thompson   @param[in]     data      CeedQFunctionAssemblyData to copy reference to
1029ea61e9acSJeremy L Thompson   @param[in,out] data_copy Variable to store copied reference
1030480fae85SJeremy L Thompson 
1031480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1032480fae85SJeremy L Thompson 
1033480fae85SJeremy L Thompson   @ref Backend
1034480fae85SJeremy L Thompson **/
10352b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataReferenceCopy(CeedQFunctionAssemblyData data, CeedQFunctionAssemblyData *data_copy) {
10362b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataReference(data));
10372b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataDestroy(data_copy));
1038480fae85SJeremy L Thompson   *data_copy = data;
1039480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1040480fae85SJeremy L Thompson }
1041480fae85SJeremy L Thompson 
1042480fae85SJeremy L Thompson /**
1043480fae85SJeremy L Thompson   @brief Get setup status for internal objects for CeedQFunctionAssemblyData
1044480fae85SJeremy L Thompson 
1045ea61e9acSJeremy L Thompson   @param[in]  data     CeedQFunctionAssemblyData to retrieve status
1046480fae85SJeremy L Thompson   @param[out] is_setup Boolean flag for setup status
1047480fae85SJeremy L Thompson 
1048480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1049480fae85SJeremy L Thompson 
1050480fae85SJeremy L Thompson   @ref Backend
1051480fae85SJeremy L Thompson **/
10522b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsSetup(CeedQFunctionAssemblyData data, bool *is_setup) {
1053480fae85SJeremy L Thompson   *is_setup = data->is_setup;
1054480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1055480fae85SJeremy L Thompson }
1056480fae85SJeremy L Thompson 
1057480fae85SJeremy L Thompson /**
1058480fae85SJeremy L Thompson   @brief Set internal objects for CeedQFunctionAssemblyData
1059480fae85SJeremy L Thompson 
1060ea61e9acSJeremy L Thompson   @param[in,out] data CeedQFunctionAssemblyData to set objects
1061480fae85SJeremy L Thompson   @param[in]     vec  CeedVector to store assembled CeedQFunction at quadrature points
1062480fae85SJeremy L Thompson   @param[in]     rstr CeedElemRestriction for CeedVector containing assembled CeedQFunction
1063480fae85SJeremy L Thompson 
1064480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1065480fae85SJeremy L Thompson 
1066480fae85SJeremy L Thompson   @ref Backend
1067480fae85SJeremy L Thompson **/
10682b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetObjects(CeedQFunctionAssemblyData data, CeedVector vec, CeedElemRestriction rstr) {
10692b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(vec, &data->vec));
10702b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(rstr, &data->rstr));
1071480fae85SJeremy L Thompson 
1072480fae85SJeremy L Thompson   data->is_setup = true;
1073480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1074480fae85SJeremy L Thompson }
1075480fae85SJeremy L Thompson 
10762b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataGetObjects(CeedQFunctionAssemblyData data, CeedVector *vec, CeedElemRestriction *rstr) {
10776574a04fSJeremy L Thompson   CeedCheck(data->is_setup, data->ceed, CEED_ERROR_INCOMPLETE, "Internal objects not set; must call CeedQFunctionAssemblyDataSetObjects first.");
1078480fae85SJeremy L Thompson 
10792b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(data->vec, vec));
10802b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(data->rstr, rstr));
1081480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1082480fae85SJeremy L Thompson }
1083480fae85SJeremy L Thompson 
1084480fae85SJeremy L Thompson /**
1085480fae85SJeremy L Thompson   @brief Destroy CeedQFunctionAssemblyData
1086480fae85SJeremy L Thompson 
1087ea61e9acSJeremy L Thompson   @param[in,out] data  CeedQFunctionAssemblyData to destroy
1088480fae85SJeremy L Thompson 
1089480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1090480fae85SJeremy L Thompson 
1091480fae85SJeremy L Thompson   @ref Backend
1092480fae85SJeremy L Thompson **/
1093480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataDestroy(CeedQFunctionAssemblyData *data) {
1094ad6481ceSJeremy L Thompson   if (!*data || --(*data)->ref_count > 0) {
1095ad6481ceSJeremy L Thompson     *data = NULL;
1096ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1097ad6481ceSJeremy L Thompson   }
10982b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
10992b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&(*data)->vec));
11002b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&(*data)->rstr));
1101480fae85SJeremy L Thompson 
11022b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1103480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1104480fae85SJeremy L Thompson }
1105480fae85SJeremy L Thompson 
1106ed9e99e6SJeremy L Thompson /**
1107ed9e99e6SJeremy L Thompson   @brief Get CeedOperatorAssemblyData
1108ed9e99e6SJeremy L Thompson 
1109ed9e99e6SJeremy L Thompson   @param[in]  op   CeedOperator to assemble
1110ed9e99e6SJeremy L Thompson   @param[out] data CeedQFunctionAssemblyData
1111ed9e99e6SJeremy L Thompson 
1112ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1113ed9e99e6SJeremy L Thompson 
1114ed9e99e6SJeremy L Thompson   @ref Backend
1115ed9e99e6SJeremy L Thompson **/
11162b730f8bSJeremy L Thompson int CeedOperatorGetOperatorAssemblyData(CeedOperator op, CeedOperatorAssemblyData *data) {
1117ed9e99e6SJeremy L Thompson   if (!op->op_assembled) {
1118ed9e99e6SJeremy L Thompson     CeedOperatorAssemblyData data;
1119ed9e99e6SJeremy L Thompson 
11202b730f8bSJeremy L Thompson     CeedCall(CeedOperatorAssemblyDataCreate(op->ceed, op, &data));
1121ed9e99e6SJeremy L Thompson     op->op_assembled = data;
1122ed9e99e6SJeremy L Thompson   }
1123ed9e99e6SJeremy L Thompson   *data = op->op_assembled;
1124ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1125ed9e99e6SJeremy L Thompson }
1126ed9e99e6SJeremy L Thompson 
1127ed9e99e6SJeremy L Thompson /**
1128ba746a46SJeremy L Thompson   @brief Create object holding CeedOperator assembly data.
1129ba746a46SJeremy L Thompson 
1130ba746a46SJeremy L Thompson   The CeedOperatorAssemblyData holds an array with references to every active CeedBasis used in the CeedOperator.
1131ba746a46SJeremy L Thompson   An array with references to the corresponding active CeedElemRestrictions is also stored.
1132ba746a46SJeremy L Thompson   For each active CeedBasis, the CeedOperatorAssemblyData holds an array of all input and output CeedEvalModes for this CeedBasis.
1133ba746a46SJeremy L Thompson   The CeedOperatorAssemblyData holds an array of offsets for indexing into the assembled CeedQFunction arrays to the row representing each
1134ba746a46SJeremy L Thompson CeedEvalMode.
1135ba746a46SJeremy L Thompson   The number of input columns across all active bases for the assembled CeedQFunction is also stored.
1136ba746a46SJeremy L Thompson   Lastly, the CeedOperatorAssembly data holds assembled matrices representing the full action of the CeedBasis for all CeedEvalModes.
1137ed9e99e6SJeremy L Thompson 
1138ea61e9acSJeremy L Thompson   @param[in]  ceed Ceed object where the CeedOperatorAssemblyData will be created
1139ed9e99e6SJeremy L Thompson   @param[in]  op   CeedOperator to be assembled
1140ea61e9acSJeremy L Thompson   @param[out] data Address of the variable where the newly created CeedOperatorAssemblyData will be stored
1141ed9e99e6SJeremy L Thompson 
1142ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1143ed9e99e6SJeremy L Thompson 
1144ed9e99e6SJeremy L Thompson   @ref Backend
1145ed9e99e6SJeremy L Thompson **/
11462b730f8bSJeremy L Thompson int CeedOperatorAssemblyDataCreate(Ceed ceed, CeedOperator op, CeedOperatorAssemblyData *data) {
1147*1c66c397SJeremy L Thompson   CeedInt             num_active_bases = 0, num_input_fields, *num_eval_modes_in = NULL, *num_eval_modes_out = NULL, offset = 0, num_output_fields;
1148*1c66c397SJeremy L Thompson   CeedSize          **eval_mode_offsets_in = NULL, **eval_mode_offsets_out = NULL;
1149*1c66c397SJeremy L Thompson   CeedEvalMode      **eval_modes_in = NULL, **eval_modes_out = NULL;
1150*1c66c397SJeremy L Thompson   CeedQFunctionField *qf_fields;
1151*1c66c397SJeremy L Thompson   CeedQFunction       qf;
1152*1c66c397SJeremy L Thompson   CeedOperatorField  *op_fields;
1153437c7c90SJeremy L Thompson 
1154437c7c90SJeremy L Thompson   // Allocate
11552b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
1156ed9e99e6SJeremy L Thompson   (*data)->ceed = ceed;
11572b730f8bSJeremy L Thompson   CeedCall(CeedReference(ceed));
1158ed9e99e6SJeremy L Thompson 
1159ed9e99e6SJeremy L Thompson   // Build OperatorAssembly data
11602b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
11612b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &qf_fields, NULL, NULL));
11622b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL));
1163ed9e99e6SJeremy L Thompson 
1164ed9e99e6SJeremy L Thompson   // Determine active input basis
1165ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
1166ed9e99e6SJeremy L Thompson     CeedVector vec;
1167*1c66c397SJeremy L Thompson 
11682b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1169ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
11707c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
1171*1c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
1172*1c66c397SJeremy L Thompson       CeedBasis    basis_in = NULL;
1173*1c66c397SJeremy L Thompson 
11742b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_in));
11752b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1176352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_in, &num_comp));
1177352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_in, eval_mode, &q_comp));
1178437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < num_active_bases; i++) {
1179437c7c90SJeremy L Thompson         if ((*data)->active_bases[i] == basis_in) index = i;
1180437c7c90SJeremy L Thompson       }
1181437c7c90SJeremy L Thompson       if (index == -1) {
1182437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_in;
1183*1c66c397SJeremy L Thompson 
1184437c7c90SJeremy L Thompson         index = num_active_bases;
1185437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->active_bases));
1186437c7c90SJeremy L Thompson         (*data)->active_bases[num_active_bases] = NULL;
1187437c7c90SJeremy L Thompson         CeedCall(CeedBasisReferenceCopy(basis_in, &(*data)->active_bases[num_active_bases]));
1188437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->active_elem_rstrs));
1189437c7c90SJeremy L Thompson         (*data)->active_elem_rstrs[num_active_bases] = NULL;
1190437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_in));
1191437c7c90SJeremy L Thompson         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_in, &(*data)->active_elem_rstrs[num_active_bases]));
1192437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &num_eval_modes_in));
1193437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &num_eval_modes_out));
1194437c7c90SJeremy L Thompson         num_eval_modes_in[index]  = 0;
1195437c7c90SJeremy L Thompson         num_eval_modes_out[index] = 0;
1196437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_modes_in));
1197437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_modes_out));
1198437c7c90SJeremy L Thompson         eval_modes_in[index]  = NULL;
1199437c7c90SJeremy L Thompson         eval_modes_out[index] = NULL;
1200437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_mode_offsets_in));
1201437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_mode_offsets_out));
1202437c7c90SJeremy L Thompson         eval_mode_offsets_in[index]  = NULL;
1203437c7c90SJeremy L Thompson         eval_mode_offsets_out[index] = NULL;
1204437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->assembled_bases_in));
1205437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->assembled_bases_out));
1206437c7c90SJeremy L Thompson         (*data)->assembled_bases_in[index]  = NULL;
1207437c7c90SJeremy L Thompson         (*data)->assembled_bases_out[index] = NULL;
1208437c7c90SJeremy L Thompson         num_active_bases++;
1209437c7c90SJeremy L Thompson       }
1210352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1211352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1212352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_modes_in[index]));
1213352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_mode_offsets_in[index]));
1214352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1215437c7c90SJeremy L Thompson           eval_modes_in[index][num_eval_modes_in[index] + d]        = eval_mode;
1216437c7c90SJeremy L Thompson           eval_mode_offsets_in[index][num_eval_modes_in[index] + d] = offset;
1217352a5e7cSSebastian Grimberg           offset += num_comp;
1218ed9e99e6SJeremy L Thompson         }
1219352a5e7cSSebastian Grimberg         num_eval_modes_in[index] += q_comp;
1220ed9e99e6SJeremy L Thompson       }
1221ed9e99e6SJeremy L Thompson     }
1222ed9e99e6SJeremy L Thompson   }
1223437c7c90SJeremy L Thompson   (*data)->num_eval_modes_in    = num_eval_modes_in;
1224437c7c90SJeremy L Thompson   (*data)->eval_modes_in        = eval_modes_in;
1225437c7c90SJeremy L Thompson   (*data)->eval_mode_offsets_in = eval_mode_offsets_in;
1226ed9e99e6SJeremy L Thompson 
1227ed9e99e6SJeremy L Thompson   // Determine active output basis
12282b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, NULL, &num_output_fields, &qf_fields));
12292b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields));
1230437c7c90SJeremy L Thompson   offset = 0;
1231ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_output_fields; i++) {
1232ed9e99e6SJeremy L Thompson     CeedVector vec;
1233*1c66c397SJeremy L Thompson 
12342b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1235ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
12367c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
1237*1c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
1238*1c66c397SJeremy L Thompson       CeedBasis    basis_out = NULL;
1239*1c66c397SJeremy L Thompson 
1240437c7c90SJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_out));
12412b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1242352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_out, &num_comp));
1243352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_out, eval_mode, &q_comp));
1244437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < num_active_bases; i++) {
1245437c7c90SJeremy L Thompson         if ((*data)->active_bases[i] == basis_out) index = i;
1246437c7c90SJeremy L Thompson       }
1247437c7c90SJeremy L Thompson       if (index == -1) {
1248437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_out;
1249*1c66c397SJeremy L Thompson 
1250437c7c90SJeremy L Thompson         index = num_active_bases;
1251437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->active_bases));
1252437c7c90SJeremy L Thompson         (*data)->active_bases[num_active_bases] = NULL;
1253437c7c90SJeremy L Thompson         CeedCall(CeedBasisReferenceCopy(basis_out, &(*data)->active_bases[num_active_bases]));
1254437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->active_elem_rstrs));
1255437c7c90SJeremy L Thompson         (*data)->active_elem_rstrs[num_active_bases] = NULL;
1256437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_out));
1257437c7c90SJeremy L Thompson         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_out, &(*data)->active_elem_rstrs[num_active_bases]));
1258437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &num_eval_modes_in));
1259437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &num_eval_modes_out));
1260437c7c90SJeremy L Thompson         num_eval_modes_in[index]  = 0;
1261437c7c90SJeremy L Thompson         num_eval_modes_out[index] = 0;
1262437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_modes_in));
1263437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_modes_out));
1264437c7c90SJeremy L Thompson         eval_modes_in[index]  = NULL;
1265437c7c90SJeremy L Thompson         eval_modes_out[index] = NULL;
1266437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_mode_offsets_in));
1267437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &eval_mode_offsets_out));
1268437c7c90SJeremy L Thompson         eval_mode_offsets_in[index]  = NULL;
1269437c7c90SJeremy L Thompson         eval_mode_offsets_out[index] = NULL;
1270437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->assembled_bases_in));
1271437c7c90SJeremy L Thompson         CeedCall(CeedRealloc(num_active_bases + 1, &(*data)->assembled_bases_out));
1272437c7c90SJeremy L Thompson         (*data)->assembled_bases_in[index]  = NULL;
1273437c7c90SJeremy L Thompson         (*data)->assembled_bases_out[index] = NULL;
1274437c7c90SJeremy L Thompson         num_active_bases++;
1275437c7c90SJeremy L Thompson       }
1276352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1277352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1278352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_modes_out[index]));
1279352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_mode_offsets_out[index]));
1280352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1281437c7c90SJeremy L Thompson           eval_modes_out[index][num_eval_modes_out[index] + d]        = eval_mode;
1282437c7c90SJeremy L Thompson           eval_mode_offsets_out[index][num_eval_modes_out[index] + d] = offset;
1283352a5e7cSSebastian Grimberg           offset += num_comp;
1284ed9e99e6SJeremy L Thompson         }
1285352a5e7cSSebastian Grimberg         num_eval_modes_out[index] += q_comp;
1286ed9e99e6SJeremy L Thompson       }
1287ed9e99e6SJeremy L Thompson     }
1288ed9e99e6SJeremy L Thompson   }
1289437c7c90SJeremy L Thompson   (*data)->num_output_components = offset;
1290437c7c90SJeremy L Thompson   (*data)->num_eval_modes_out    = num_eval_modes_out;
1291437c7c90SJeremy L Thompson   (*data)->eval_modes_out        = eval_modes_out;
1292437c7c90SJeremy L Thompson   (*data)->eval_mode_offsets_out = eval_mode_offsets_out;
1293437c7c90SJeremy L Thompson   (*data)->num_active_bases      = num_active_bases;
1294ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1295ed9e99e6SJeremy L Thompson }
1296ed9e99e6SJeremy L Thompson 
1297ed9e99e6SJeremy L Thompson /**
1298ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedEvalModes for assembly.
1299ba746a46SJeremy L Thompson 
1300ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1301ed9e99e6SJeremy L Thompson 
1302ed9e99e6SJeremy L Thompson   @param[in]  data                  CeedOperatorAssemblyData
1303ba746a46SJeremy L Thompson   @param[out] num_active_bases      Total number of active bases
1304c5d0f995SJed Brown   @param[out] num_eval_modes_in     Pointer to hold array of numbers of input CeedEvalModes, or NULL.
1305ba746a46SJeremy L Thompson                                       `eval_modes_in[0]` holds an array of eval modes for the first active basis.
1306c5d0f995SJed Brown   @param[out] eval_modes_in         Pointer to hold arrays of input CeedEvalModes, or NULL.
1307ba746a46SJeremy L Thompson   @param[out] eval_mode_offsets_in  Pointer to hold arrays of input offsets at each quadrature point.
1308c5d0f995SJed Brown   @param[out] num_eval_modes_out    Pointer to hold array of numbers of output CeedEvalModes, or NULL
1309c5d0f995SJed Brown   @param[out] eval_modes_out        Pointer to hold arrays of output CeedEvalModes, or NULL.
1310437c7c90SJeremy L Thompson   @param[out] eval_mode_offsets_out Pointer to hold arrays of output offsets at each quadrature point
1311ba746a46SJeremy L Thompson   @param[out] num_output_components The number of columns in the assembled CeedQFunction matrix for each quadrature point,
1312ba746a46SJeremy L Thompson                                       including contributions of all active bases
1313ed9e99e6SJeremy L Thompson 
1314ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1315ed9e99e6SJeremy L Thompson 
1316c5d0f995SJed Brown 
1317ed9e99e6SJeremy L Thompson   @ref Backend
1318ed9e99e6SJeremy L Thompson **/
1319437c7c90SJeremy L Thompson int CeedOperatorAssemblyDataGetEvalModes(CeedOperatorAssemblyData data, CeedInt *num_active_bases, CeedInt **num_eval_modes_in,
1320437c7c90SJeremy L Thompson                                          const CeedEvalMode ***eval_modes_in, CeedSize ***eval_mode_offsets_in, CeedInt **num_eval_modes_out,
1321437c7c90SJeremy L Thompson                                          const CeedEvalMode ***eval_modes_out, CeedSize ***eval_mode_offsets_out, CeedSize *num_output_components) {
1322437c7c90SJeremy L Thompson   if (num_active_bases) *num_active_bases = data->num_active_bases;
1323437c7c90SJeremy L Thompson   if (num_eval_modes_in) *num_eval_modes_in = data->num_eval_modes_in;
1324437c7c90SJeremy L Thompson   if (eval_modes_in) *eval_modes_in = (const CeedEvalMode **)data->eval_modes_in;
1325437c7c90SJeremy L Thompson   if (eval_mode_offsets_in) *eval_mode_offsets_in = data->eval_mode_offsets_in;
1326437c7c90SJeremy L Thompson   if (num_eval_modes_out) *num_eval_modes_out = data->num_eval_modes_out;
1327437c7c90SJeremy L Thompson   if (eval_modes_out) *eval_modes_out = (const CeedEvalMode **)data->eval_modes_out;
1328437c7c90SJeremy L Thompson   if (eval_mode_offsets_out) *eval_mode_offsets_out = data->eval_mode_offsets_out;
1329437c7c90SJeremy L Thompson   if (num_output_components) *num_output_components = data->num_output_components;
1330ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1331ed9e99e6SJeremy L Thompson }
1332ed9e99e6SJeremy L Thompson 
1333ed9e99e6SJeremy L Thompson /**
1334ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedBasis data for assembly.
1335ba746a46SJeremy L Thompson 
1336ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1337ed9e99e6SJeremy L Thompson 
1338ed9e99e6SJeremy L Thompson   @param[in]  data                CeedOperatorAssemblyData
1339437c7c90SJeremy L Thompson   @param[out] num_active_bases    Number of active bases, or NULL
1340437c7c90SJeremy L Thompson   @param[out] active_bases        Pointer to hold active CeedBasis, or NULL
1341437c7c90SJeremy L Thompson   @param[out] assembled_bases_in  Pointer to hold assembled active input B, or NULL
1342437c7c90SJeremy L Thompson   @param[out] assembled_bases_out Pointer to hold assembled active output B, or NULL
1343ed9e99e6SJeremy L Thompson 
1344ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1345ed9e99e6SJeremy L Thompson 
1346ed9e99e6SJeremy L Thompson   @ref Backend
1347ed9e99e6SJeremy L Thompson **/
1348437c7c90SJeremy L Thompson int CeedOperatorAssemblyDataGetBases(CeedOperatorAssemblyData data, CeedInt *num_active_bases, CeedBasis **active_bases,
1349437c7c90SJeremy L Thompson                                      const CeedScalar ***assembled_bases_in, const CeedScalar ***assembled_bases_out) {
1350ed9e99e6SJeremy L Thompson   // Assemble B_in, B_out if needed
1351437c7c90SJeremy L Thompson   if (assembled_bases_in && !data->assembled_bases_in[0]) {
1352437c7c90SJeremy L Thompson     CeedInt num_qpts;
1353437c7c90SJeremy L Thompson 
1354437c7c90SJeremy L Thompson     CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases[0], &num_qpts));
1355437c7c90SJeremy L Thompson     for (CeedInt b = 0; b < data->num_active_bases; b++) {
1356*1c66c397SJeremy L Thompson       bool        has_eval_none = false;
1357352a5e7cSSebastian Grimberg       CeedInt     num_nodes;
1358437c7c90SJeremy L Thompson       CeedScalar *B_in = NULL, *identity = NULL;
1359ed9e99e6SJeremy L Thompson 
1360352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumNodes(data->active_bases[b], &num_nodes));
1361352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_in[b], &B_in));
1362ed9e99e6SJeremy L Thompson 
1363437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_in[b]; i++) {
1364437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_in[b][i] == CEED_EVAL_NONE);
1365ed9e99e6SJeremy L Thompson       }
1366ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1367352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1368352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1369352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1370ed9e99e6SJeremy L Thompson         }
1371ed9e99e6SJeremy L Thompson       }
1372ed9e99e6SJeremy L Thompson 
1373ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1374352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1375352a5e7cSSebastian Grimberg           CeedInt      d_in              = 0, q_comp_in;
1376352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE;
1377*1c66c397SJeremy L Thompson 
1378437c7c90SJeremy L Thompson           for (CeedInt e_in = 0; e_in < data->num_eval_modes_in[b]; e_in++) {
1379437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_in[b] * q;
1380437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
1381*1c66c397SJeremy L Thompson 
1382352a5e7cSSebastian Grimberg             CeedOperatorGetBasisPointer(data->active_bases[b], data->eval_modes_in[b][e_in], identity, &B);
1383352a5e7cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases[b], data->eval_modes_in[b][e_in], &q_comp_in));
1384352a5e7cSSebastian Grimberg             if (q_comp_in > 1) {
1385352a5e7cSSebastian Grimberg               if (e_in == 0 || data->eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0;
1386352a5e7cSSebastian Grimberg               else B = &B[(++d_in) * num_qpts * num_nodes];
1387352a5e7cSSebastian Grimberg             }
1388352a5e7cSSebastian Grimberg             eval_mode_in_prev                 = data->eval_modes_in[b][e_in];
1389352a5e7cSSebastian Grimberg             B_in[(qq + e_in) * num_nodes + n] = B[q * num_nodes + n];
1390ed9e99e6SJeremy L Thompson           }
1391ed9e99e6SJeremy L Thompson         }
1392ed9e99e6SJeremy L Thompson       }
13937c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1394437c7c90SJeremy L Thompson       data->assembled_bases_in[b] = B_in;
1395437c7c90SJeremy L Thompson     }
1396ed9e99e6SJeremy L Thompson   }
1397ed9e99e6SJeremy L Thompson 
1398437c7c90SJeremy L Thompson   if (assembled_bases_out && !data->assembled_bases_out[0]) {
1399437c7c90SJeremy L Thompson     CeedInt num_qpts;
1400437c7c90SJeremy L Thompson 
1401437c7c90SJeremy L Thompson     CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases[0], &num_qpts));
1402437c7c90SJeremy L Thompson     for (CeedInt b = 0; b < data->num_active_bases; b++) {
1403ed9e99e6SJeremy L Thompson       bool        has_eval_none = false;
1404*1c66c397SJeremy L Thompson       CeedInt     num_nodes;
1405437c7c90SJeremy L Thompson       CeedScalar *B_out = NULL, *identity = NULL;
1406ed9e99e6SJeremy L Thompson 
1407352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumNodes(data->active_bases[b], &num_nodes));
1408352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_out[b], &B_out));
1409ed9e99e6SJeremy L Thompson 
1410437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_out[b]; i++) {
1411437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_out[b][i] == CEED_EVAL_NONE);
1412ed9e99e6SJeremy L Thompson       }
1413ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1414352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1415352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1416352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1417ed9e99e6SJeremy L Thompson         }
1418ed9e99e6SJeremy L Thompson       }
1419ed9e99e6SJeremy L Thompson 
1420ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1421352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1422352a5e7cSSebastian Grimberg           CeedInt      d_out              = 0, q_comp_out;
1423352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
1424*1c66c397SJeremy L Thompson 
1425437c7c90SJeremy L Thompson           for (CeedInt e_out = 0; e_out < data->num_eval_modes_out[b]; e_out++) {
1426437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_out[b] * q;
1427437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
1428*1c66c397SJeremy L Thompson 
1429352a5e7cSSebastian Grimberg             CeedOperatorGetBasisPointer(data->active_bases[b], data->eval_modes_out[b][e_out], identity, &B);
1430352a5e7cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases[b], data->eval_modes_out[b][e_out], &q_comp_out));
1431352a5e7cSSebastian Grimberg             if (q_comp_out > 1) {
1432352a5e7cSSebastian Grimberg               if (e_out == 0 || data->eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0;
1433352a5e7cSSebastian Grimberg               else B = &B[(++d_out) * num_qpts * num_nodes];
1434352a5e7cSSebastian Grimberg             }
1435352a5e7cSSebastian Grimberg             eval_mode_out_prev                  = data->eval_modes_out[b][e_out];
1436352a5e7cSSebastian Grimberg             B_out[(qq + e_out) * num_nodes + n] = B[q * num_nodes + n];
1437ed9e99e6SJeremy L Thompson           }
1438ed9e99e6SJeremy L Thompson         }
1439ed9e99e6SJeremy L Thompson       }
14407c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1441437c7c90SJeremy L Thompson       data->assembled_bases_out[b] = B_out;
1442437c7c90SJeremy L Thompson     }
1443ed9e99e6SJeremy L Thompson   }
1444ed9e99e6SJeremy L Thompson 
1445437c7c90SJeremy L Thompson   // Pass out assembled data
1446437c7c90SJeremy L Thompson   if (active_bases) *active_bases = data->active_bases;
1447437c7c90SJeremy L Thompson   if (assembled_bases_in) *assembled_bases_in = (const CeedScalar **)data->assembled_bases_in;
1448437c7c90SJeremy L Thompson   if (assembled_bases_out) *assembled_bases_out = (const CeedScalar **)data->assembled_bases_out;
1449437c7c90SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1450437c7c90SJeremy L Thompson }
1451437c7c90SJeremy L Thompson 
1452437c7c90SJeremy L Thompson /**
1453ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedBasis data for assembly.
1454ba746a46SJeremy L Thompson 
1455ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1456437c7c90SJeremy L Thompson 
1457437c7c90SJeremy L Thompson   @param[in]  data                  CeedOperatorAssemblyData
1458437c7c90SJeremy L Thompson   @param[out] num_active_elem_rstrs Number of active element restrictions, or NULL
1459437c7c90SJeremy L Thompson   @param[out] active_elem_rstrs     Pointer to hold active CeedElemRestrictions, or NULL
1460437c7c90SJeremy L Thompson 
1461437c7c90SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1462437c7c90SJeremy L Thompson 
1463437c7c90SJeremy L Thompson   @ref Backend
1464437c7c90SJeremy L Thompson **/
1465437c7c90SJeremy L Thompson int CeedOperatorAssemblyDataGetElemRestrictions(CeedOperatorAssemblyData data, CeedInt *num_active_elem_rstrs,
1466437c7c90SJeremy L Thompson                                                 CeedElemRestriction **active_elem_rstrs) {
1467437c7c90SJeremy L Thompson   if (num_active_elem_rstrs) *num_active_elem_rstrs = data->num_active_bases;
1468437c7c90SJeremy L Thompson   if (active_elem_rstrs) *active_elem_rstrs = data->active_elem_rstrs;
1469ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1470ed9e99e6SJeremy L Thompson }
1471ed9e99e6SJeremy L Thompson 
1472ed9e99e6SJeremy L Thompson /**
1473ed9e99e6SJeremy L Thompson   @brief Destroy CeedOperatorAssemblyData
1474ed9e99e6SJeremy L Thompson 
1475ea61e9acSJeremy L Thompson   @param[in,out] data CeedOperatorAssemblyData to destroy
1476ed9e99e6SJeremy L Thompson 
1477ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1478ed9e99e6SJeremy L Thompson 
1479ed9e99e6SJeremy L Thompson   @ref Backend
1480ed9e99e6SJeremy L Thompson **/
1481ed9e99e6SJeremy L Thompson int CeedOperatorAssemblyDataDestroy(CeedOperatorAssemblyData *data) {
1482ad6481ceSJeremy L Thompson   if (!*data) {
1483ad6481ceSJeremy L Thompson     *data = NULL;
1484ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1485ad6481ceSJeremy L Thompson   }
14862b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
1487437c7c90SJeremy L Thompson   for (CeedInt b = 0; b < (*data)->num_active_bases; b++) {
1488437c7c90SJeremy L Thompson     CeedCall(CeedBasisDestroy(&(*data)->active_bases[b]));
1489437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs[b]));
1490437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_modes_in[b]));
1491437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_modes_out[b]));
1492437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_mode_offsets_in[b]));
1493437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_mode_offsets_out[b]));
1494437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_in[b]));
1495437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_out[b]));
1496437c7c90SJeremy L Thompson   }
1497437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->active_bases));
1498437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->active_elem_rstrs));
1499437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_in));
1500437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_out));
1501437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_in));
1502437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_out));
1503437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_in));
1504437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_out));
1505437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_in));
1506437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_out));
1507ed9e99e6SJeremy L Thompson 
15082b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1509ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1510ed9e99e6SJeremy L Thompson }
1511ed9e99e6SJeremy L Thompson 
1512480fae85SJeremy L Thompson /// @}
1513480fae85SJeremy L Thompson 
1514480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
1515eaf62fffSJeremy L Thompson /// CeedOperator Public API
1516eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
1517eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorUser
1518eaf62fffSJeremy L Thompson /// @{
1519eaf62fffSJeremy L Thompson 
1520eaf62fffSJeremy L Thompson /**
1521eaf62fffSJeremy L Thompson   @brief Assemble a linear CeedQFunction associated with a CeedOperator
1522eaf62fffSJeremy L Thompson 
1523ea61e9acSJeremy L Thompson   This returns a CeedVector containing a matrix at each quadrature point providing the action of the CeedQFunction associated with the CeedOperator.
1524859c15bbSJames Wright   The vector `assembled` is of shape `[num_elements, num_input_fields, num_output_fields, num_quad_points]` and contains column-major matrices
1525859c15bbSJames Wright representing the action of the CeedQFunction for a corresponding quadrature point on an element.
1526859c15bbSJames Wright 
15279fd66db6SSebastian Grimberg   Inputs and outputs are in the order provided by the user when adding CeedOperator fields.
15289fd66db6SSebastian Grimberg   For example, a CeedQFunction with inputs 'u' and 'gradu' and outputs 'gradv' and 'v', provided in that order, would result in an assembled QFunction
15299fd66db6SSebastian Grimberg 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].
1530eaf62fffSJeremy L Thompson 
1531ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1532f04ea552SJeremy L Thompson 
1533ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1534ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedQFunction at quadrature points
1535ea61e9acSJeremy L Thompson   @param[out] rstr      CeedElemRestriction for CeedVector containing assembled CeedQFunction
1536ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1537eaf62fffSJeremy L Thompson 
1538eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1539eaf62fffSJeremy L Thompson 
1540eaf62fffSJeremy L Thompson   @ref User
1541eaf62fffSJeremy L Thompson **/
15422b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunction(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
15432b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1544eaf62fffSJeremy L Thompson 
1545eaf62fffSJeremy L Thompson   if (op->LinearAssembleQFunction) {
1546d04bbc78SJeremy L Thompson     // Backend version
15472b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleQFunction(op, assembled, rstr, request));
1548eaf62fffSJeremy L Thompson   } else {
1549d04bbc78SJeremy L Thompson     // Operator fallback
1550d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1551d04bbc78SJeremy L Thompson 
15522b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
15536574a04fSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunction(op_fallback, assembled, rstr, request));
15546574a04fSJeremy L Thompson     else return CeedError(op->ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunction");
155570a7ffb3SJeremy L Thompson   }
1556eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1557eaf62fffSJeremy L Thompson }
155870a7ffb3SJeremy L Thompson 
155970a7ffb3SJeremy L Thompson /**
1560ea61e9acSJeremy L Thompson   @brief Assemble CeedQFunction and store result internally.
15614385fb7fSSebastian Grimberg 
1562ea61e9acSJeremy L Thompson   Return copied references of stored data to the caller.
1563ea61e9acSJeremy L Thompson   Caller is responsible for ownership and destruction of the copied references.
1564ea61e9acSJeremy L Thompson   See also @ref CeedOperatorLinearAssembleQFunction
156570a7ffb3SJeremy L Thompson 
1566c5f45aeaSJeremy 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.
1567c5f45aeaSJeremy L Thompson         These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object.
1568c5f45aeaSJeremy L Thompson 
1569ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1570ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedQFunction at quadrature points
1571ea61e9acSJeremy L Thompson   @param[out] rstr      CeedElemRestriction for CeedVector containing assembledCeedQFunction
1572ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
157370a7ffb3SJeremy L Thompson 
157470a7ffb3SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
157570a7ffb3SJeremy L Thompson 
157670a7ffb3SJeremy L Thompson   @ref User
157770a7ffb3SJeremy L Thompson **/
15782b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdate(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
1579b05f7e9fSJeremy L Thompson   int (*LinearAssembleQFunctionUpdate)(CeedOperator, CeedVector, CeedElemRestriction, CeedRequest *) = NULL;
1580b05f7e9fSJeremy L Thompson   CeedOperator op_assemble                                                                           = NULL;
1581b05f7e9fSJeremy L Thompson 
15822b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
158370a7ffb3SJeremy L Thompson 
1584b05f7e9fSJeremy L Thompson   // Determine if fallback parent or operator has implementation
1585b05f7e9fSJeremy L Thompson   if (op->op_fallback_parent && op->op_fallback_parent->LinearAssembleQFunctionUpdate) {
1586b05f7e9fSJeremy L Thompson     // -- Backend version for op fallback parent is faster, if it exists
1587b05f7e9fSJeremy L Thompson     LinearAssembleQFunctionUpdate = op->op_fallback_parent->LinearAssembleQFunctionUpdate;
1588b05f7e9fSJeremy L Thompson     op_assemble                   = op->op_fallback_parent;
1589b05f7e9fSJeremy L Thompson   } else if (op->LinearAssembleQFunctionUpdate) {
1590b05f7e9fSJeremy L Thompson     // -- Backend version for op
1591b05f7e9fSJeremy L Thompson     LinearAssembleQFunctionUpdate = op->LinearAssembleQFunctionUpdate;
1592b05f7e9fSJeremy L Thompson     op_assemble                   = op;
1593b05f7e9fSJeremy L Thompson   }
1594b05f7e9fSJeremy L Thompson 
1595b05f7e9fSJeremy L Thompson   // Assemble QFunction
1596b05f7e9fSJeremy L Thompson   if (LinearAssembleQFunctionUpdate) {
1597b05f7e9fSJeremy L Thompson     // Backend or fallback parent version
1598480fae85SJeremy L Thompson     bool                qf_assembled_is_setup;
15992efa2d85SJeremy L Thompson     CeedVector          assembled_vec  = NULL;
16002efa2d85SJeremy L Thompson     CeedElemRestriction assembled_rstr = NULL;
1601480fae85SJeremy L Thompson 
16022b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataIsSetup(op->qf_assembled, &qf_assembled_is_setup));
1603480fae85SJeremy L Thompson     if (qf_assembled_is_setup) {
1604d04bbc78SJeremy L Thompson       bool update_needed;
1605d04bbc78SJeremy L Thompson 
16062b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataGetObjects(op->qf_assembled, &assembled_vec, &assembled_rstr));
16072b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataIsUpdateNeeded(op->qf_assembled, &update_needed));
1608b05f7e9fSJeremy L Thompson       if (update_needed) CeedCall(LinearAssembleQFunctionUpdate(op_assemble, assembled_vec, assembled_rstr, request));
160970a7ffb3SJeremy L Thompson     } else {
1610b05f7e9fSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleQFunction(op_assemble, &assembled_vec, &assembled_rstr, request));
16112b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataSetObjects(op->qf_assembled, assembled_vec, assembled_rstr));
161270a7ffb3SJeremy L Thompson     }
16132b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataSetUpdateNeeded(op->qf_assembled, false));
16142efa2d85SJeremy L Thompson 
1615d04bbc78SJeremy L Thompson     // Copy reference from internally held copy
16162b730f8bSJeremy L Thompson     CeedCall(CeedVectorReferenceCopy(assembled_vec, assembled));
16172b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionReferenceCopy(assembled_rstr, rstr));
1618c5f45aeaSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled_vec));
16192b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&assembled_rstr));
162070a7ffb3SJeremy L Thompson   } else {
1621d04bbc78SJeremy L Thompson     // Operator fallback
1622d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1623d04bbc78SJeremy L Thompson 
16242b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
16256574a04fSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op_fallback, assembled, rstr, request));
16266574a04fSJeremy L Thompson     else return CeedError(op->ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunctionUpdate");
162770a7ffb3SJeremy L Thompson   }
162870a7ffb3SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1629eaf62fffSJeremy L Thompson }
1630eaf62fffSJeremy L Thompson 
1631eaf62fffSJeremy L Thompson /**
1632eaf62fffSJeremy L Thompson   @brief Assemble the diagonal of a square linear CeedOperator
1633eaf62fffSJeremy L Thompson 
1634eaf62fffSJeremy L Thompson   This overwrites a CeedVector with the diagonal of a linear CeedOperator.
1635eaf62fffSJeremy L Thompson 
1636ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1637eaf62fffSJeremy L Thompson 
1638ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1639f04ea552SJeremy L Thompson 
1640ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1641eaf62fffSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator diagonal
1642ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1643eaf62fffSJeremy L Thompson 
1644eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1645eaf62fffSJeremy L Thompson 
1646eaf62fffSJeremy L Thompson   @ref User
1647eaf62fffSJeremy L Thompson **/
16482b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1649f3d47e36SJeremy L Thompson   bool     is_composite;
1650*1c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
1651*1c66c397SJeremy L Thompson 
16522b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1653f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1654eaf62fffSJeremy L Thompson 
16552b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
16566574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1657c9366a6bSJeremy L Thompson 
1658f3d47e36SJeremy L Thompson   // Early exit for empty operator
1659f3d47e36SJeremy L Thompson   if (!is_composite) {
1660f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1661f3d47e36SJeremy L Thompson 
1662f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1663f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1664f3d47e36SJeremy L Thompson   }
1665f3d47e36SJeremy L Thompson 
1666eaf62fffSJeremy L Thompson   if (op->LinearAssembleDiagonal) {
1667d04bbc78SJeremy L Thompson     // Backend version
16682b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleDiagonal(op, assembled, request));
1669eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1670eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddDiagonal) {
1671d04bbc78SJeremy L Thompson     // Backend version with zeroing first
16722b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
16732b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
1674eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1675eaf62fffSJeremy L Thompson   } else {
1676d04bbc78SJeremy L Thompson     // Operator fallback
1677d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1678d04bbc78SJeremy L Thompson 
16792b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1680d04bbc78SJeremy L Thompson     if (op_fallback) {
16812b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleDiagonal(op_fallback, assembled, request));
1682eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1683eaf62fffSJeremy L Thompson     }
1684eaf62fffSJeremy L Thompson   }
1685eaf62fffSJeremy L Thompson   // Default interface implementation
16862b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
16872b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddDiagonal(op, assembled, request));
1688eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1689eaf62fffSJeremy L Thompson }
1690eaf62fffSJeremy L Thompson 
1691eaf62fffSJeremy L Thompson /**
1692eaf62fffSJeremy L Thompson   @brief Assemble the diagonal of a square linear CeedOperator
1693eaf62fffSJeremy L Thompson 
1694eaf62fffSJeremy L Thompson   This sums into a CeedVector the diagonal of a linear CeedOperator.
1695eaf62fffSJeremy L Thompson 
1696ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1697eaf62fffSJeremy L Thompson 
1698ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1699f04ea552SJeremy L Thompson 
1700ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1701eaf62fffSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator diagonal
1702ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1703eaf62fffSJeremy L Thompson 
1704eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1705eaf62fffSJeremy L Thompson 
1706eaf62fffSJeremy L Thompson   @ref User
1707eaf62fffSJeremy L Thompson **/
17082b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1709f3d47e36SJeremy L Thompson   bool     is_composite;
1710*1c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
1711*1c66c397SJeremy L Thompson 
17122b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1713f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1714eaf62fffSJeremy L Thompson 
17152b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
17166574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1717c9366a6bSJeremy L Thompson 
1718f3d47e36SJeremy L Thompson   // Early exit for empty operator
1719f3d47e36SJeremy L Thompson   if (!is_composite) {
1720f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1721f3d47e36SJeremy L Thompson 
1722f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1723f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1724f3d47e36SJeremy L Thompson   }
1725f3d47e36SJeremy L Thompson 
1726eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddDiagonal) {
1727d04bbc78SJeremy L Thompson     // Backend version
17282b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
1729eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1730eaf62fffSJeremy L Thompson   } else {
1731d04bbc78SJeremy L Thompson     // Operator fallback
1732d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1733d04bbc78SJeremy L Thompson 
17342b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1735d04bbc78SJeremy L Thompson     if (op_fallback) {
17362b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddDiagonal(op_fallback, assembled, request));
1737eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1738eaf62fffSJeremy L Thompson     }
1739eaf62fffSJeremy L Thompson   }
1740eaf62fffSJeremy L Thompson   // Default interface implementation
1741eaf62fffSJeremy L Thompson   if (is_composite) {
17422b730f8bSJeremy L Thompson     CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, false, assembled));
1743eaf62fffSJeremy L Thompson   } else {
17442b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleAddDiagonal_Core(op, request, false, assembled));
1745eaf62fffSJeremy L Thompson   }
1746d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1747eaf62fffSJeremy L Thompson }
1748eaf62fffSJeremy L Thompson 
1749eaf62fffSJeremy L Thompson /**
1750eaf62fffSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear CeedOperator
1751eaf62fffSJeremy L Thompson 
1752ea61e9acSJeremy L Thompson   This overwrites a CeedVector with the point block diagonal of a linear CeedOperator.
1753eaf62fffSJeremy L Thompson 
1754ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1755eaf62fffSJeremy L Thompson 
1756ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1757f04ea552SJeremy L Thompson 
1758ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1759ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator point block diagonal, provided in row-major form with an @a num_comp * @a num_comp
1760ea61e9acSJeremy L Thompson block at each node. The dimensions of this vector are derived from the active vector for the CeedOperator. The array has shape [nodes, component out,
1761ea61e9acSJeremy L Thompson component in].
1762ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1763eaf62fffSJeremy L Thompson 
1764eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1765eaf62fffSJeremy L Thompson 
1766eaf62fffSJeremy L Thompson   @ref User
1767eaf62fffSJeremy L Thompson **/
17682b730f8bSJeremy L Thompson int CeedOperatorLinearAssemblePointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1769f3d47e36SJeremy L Thompson   bool     is_composite;
1770*1c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
1771*1c66c397SJeremy L Thompson 
17722b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1773f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1774eaf62fffSJeremy L Thompson 
17752b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
17766574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1777c9366a6bSJeremy L Thompson 
1778f3d47e36SJeremy L Thompson   // Early exit for empty operator
1779f3d47e36SJeremy L Thompson   if (!is_composite) {
1780f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1781f3d47e36SJeremy L Thompson 
1782f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1783f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1784f3d47e36SJeremy L Thompson   }
1785f3d47e36SJeremy L Thompson 
1786eaf62fffSJeremy L Thompson   if (op->LinearAssemblePointBlockDiagonal) {
1787d04bbc78SJeremy L Thompson     // Backend version
17882b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemblePointBlockDiagonal(op, assembled, request));
1789eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1790eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddPointBlockDiagonal) {
1791d04bbc78SJeremy L Thompson     // Backend version with zeroing first
17922b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
17932b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
1794eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1795eaf62fffSJeremy L Thompson   } else {
1796d04bbc78SJeremy L Thompson     // Operator fallback
1797d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1798d04bbc78SJeremy L Thompson 
17992b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1800d04bbc78SJeremy L Thompson     if (op_fallback) {
18012b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemblePointBlockDiagonal(op_fallback, assembled, request));
1802eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1803eaf62fffSJeremy L Thompson     }
1804eaf62fffSJeremy L Thompson   }
1805eaf62fffSJeremy L Thompson   // Default interface implementation
18062b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
18072b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
1808eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1809eaf62fffSJeremy L Thompson }
1810eaf62fffSJeremy L Thompson 
1811eaf62fffSJeremy L Thompson /**
1812eaf62fffSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear CeedOperator
1813eaf62fffSJeremy L Thompson 
1814ea61e9acSJeremy L Thompson   This sums into a CeedVector with the point block diagonal of a linear CeedOperator.
1815eaf62fffSJeremy L Thompson 
1816ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1817eaf62fffSJeremy L Thompson 
1818ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1819f04ea552SJeremy L Thompson 
1820ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1821ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator point block diagonal, provided in row-major form with an @a num_comp * @a num_comp
1822ea61e9acSJeremy L Thompson block at each node. The dimensions of this vector are derived from the active vector for the CeedOperator. The array has shape [nodes, component out,
1823ea61e9acSJeremy L Thompson component in].
1824ea61e9acSJeremy L Thompson   @param[in]  request Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1825eaf62fffSJeremy L Thompson 
1826eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1827eaf62fffSJeremy L Thompson 
1828eaf62fffSJeremy L Thompson   @ref User
1829eaf62fffSJeremy L Thompson **/
18302b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddPointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1831f3d47e36SJeremy L Thompson   bool     is_composite;
1832*1c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
1833*1c66c397SJeremy L Thompson 
18342b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1835f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1836eaf62fffSJeremy L Thompson 
18372b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
18386574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1839c9366a6bSJeremy L Thompson 
1840f3d47e36SJeremy L Thompson   // Early exit for empty operator
1841f3d47e36SJeremy L Thompson   if (!is_composite) {
1842f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1843f3d47e36SJeremy L Thompson 
1844f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1845f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1846f3d47e36SJeremy L Thompson   }
1847f3d47e36SJeremy L Thompson 
1848eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddPointBlockDiagonal) {
1849d04bbc78SJeremy L Thompson     // Backend version
18502b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddPointBlockDiagonal(op, assembled, request));
1851eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1852eaf62fffSJeremy L Thompson   } else {
1853d04bbc78SJeremy L Thompson     // Operator fallback
1854d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1855d04bbc78SJeremy L Thompson 
18562b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1857d04bbc78SJeremy L Thompson     if (op_fallback) {
18582b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op_fallback, assembled, request));
1859eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1860eaf62fffSJeremy L Thompson     }
1861eaf62fffSJeremy L Thompson   }
1862ea61e9acSJeremy L Thompson   // Default interface implementation
1863eaf62fffSJeremy L Thompson   if (is_composite) {
18642b730f8bSJeremy L Thompson     CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, true, assembled));
1865eaf62fffSJeremy L Thompson   } else {
18662b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleAddDiagonal_Core(op, request, true, assembled));
1867eaf62fffSJeremy L Thompson   }
1868d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1869eaf62fffSJeremy L Thompson }
1870eaf62fffSJeremy L Thompson 
1871eaf62fffSJeremy L Thompson /**
1872eaf62fffSJeremy L Thompson    @brief Fully assemble the nonzero pattern of a linear operator.
1873eaf62fffSJeremy L Thompson 
1874ea61e9acSJeremy L Thompson    Expected to be used in conjunction with CeedOperatorLinearAssemble().
1875eaf62fffSJeremy L Thompson 
1876ea61e9acSJeremy 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
18779fd66db6SSebastian Grimberg matrix in entry (i, j).
18789fd66db6SSebastian Grimberg   Note that the (i, j) pairs are not unique and may repeat.
18799fd66db6SSebastian Grimberg   This function returns the number of entries and their (i, j) locations, while CeedOperatorLinearAssemble() provides the values in the same ordering.
1880eaf62fffSJeremy L Thompson 
1881eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
1882eaf62fffSJeremy L Thompson 
1883ea61e9acSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1884f04ea552SJeremy L Thompson 
1885eaf62fffSJeremy L Thompson    @param[in]  op          CeedOperator to assemble
1886eaf62fffSJeremy L Thompson    @param[out] num_entries Number of entries in coordinate nonzero pattern
1887eaf62fffSJeremy L Thompson    @param[out] rows        Row number for each entry
1888eaf62fffSJeremy L Thompson    @param[out] cols        Column number for each entry
1889eaf62fffSJeremy L Thompson 
1890eaf62fffSJeremy L Thompson    @ref User
1891eaf62fffSJeremy L Thompson **/
18922b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) {
1893*1c66c397SJeremy L Thompson   bool          is_composite;
1894*1c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
1895b94338b9SJed Brown   CeedSize      single_entries;
1896eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
1897*1c66c397SJeremy L Thompson 
18982b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1899f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1900eaf62fffSJeremy L Thompson 
1901eaf62fffSJeremy L Thompson   if (op->LinearAssembleSymbolic) {
1902d04bbc78SJeremy L Thompson     // Backend version
19032b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSymbolic(op, num_entries, rows, cols));
1904eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1905eaf62fffSJeremy L Thompson   } else {
1906d04bbc78SJeremy L Thompson     // Operator fallback
1907d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1908d04bbc78SJeremy L Thompson 
19092b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1910d04bbc78SJeremy L Thompson     if (op_fallback) {
19112b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleSymbolic(op_fallback, num_entries, rows, cols));
1912eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1913eaf62fffSJeremy L Thompson     }
1914eaf62fffSJeremy L Thompson   }
1915eaf62fffSJeremy L Thompson 
1916eaf62fffSJeremy L Thompson   // Default interface implementation
1917eaf62fffSJeremy L Thompson 
1918eaf62fffSJeremy L Thompson   // count entries and allocate rows, cols arrays
1919eaf62fffSJeremy L Thompson   *num_entries = 0;
1920eaf62fffSJeremy L Thompson   if (is_composite) {
1921c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
1922c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
192392ae7e47SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; ++k) {
19242b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
1925eaf62fffSJeremy L Thompson       *num_entries += single_entries;
1926eaf62fffSJeremy L Thompson     }
1927eaf62fffSJeremy L Thompson   } else {
19282b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssemblyCountEntries(op, &single_entries));
1929eaf62fffSJeremy L Thompson     *num_entries += single_entries;
1930eaf62fffSJeremy L Thompson   }
19312b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, rows));
19322b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, cols));
1933eaf62fffSJeremy L Thompson 
1934eaf62fffSJeremy L Thompson   // assemble nonzero locations
1935eaf62fffSJeremy L Thompson   if (is_composite) {
1936c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
1937c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
193892ae7e47SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; ++k) {
19392b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssembleSymbolic(sub_operators[k], offset, *rows, *cols));
19402b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
1941eaf62fffSJeremy L Thompson       offset += single_entries;
1942eaf62fffSJeremy L Thompson     }
1943eaf62fffSJeremy L Thompson   } else {
19442b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleSymbolic(op, offset, *rows, *cols));
1945eaf62fffSJeremy L Thompson   }
1946eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1947eaf62fffSJeremy L Thompson }
1948eaf62fffSJeremy L Thompson 
1949eaf62fffSJeremy L Thompson /**
1950eaf62fffSJeremy L Thompson    @brief Fully assemble the nonzero entries of a linear operator.
1951eaf62fffSJeremy L Thompson 
1952ea61e9acSJeremy L Thompson    Expected to be used in conjunction with CeedOperatorLinearAssembleSymbolic().
1953eaf62fffSJeremy L Thompson 
1954ea61e9acSJeremy 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
19559fd66db6SSebastian Grimberg matrix in entry (i, j).
19569fd66db6SSebastian Grimberg   Note that the (i, j) pairs are not unique and may repeat.
19579fd66db6SSebastian Grimberg   This function returns the values of the nonzero entries to be added, their (i, j) locations are provided by CeedOperatorLinearAssembleSymbolic()
1958eaf62fffSJeremy L Thompson 
1959eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
1960eaf62fffSJeremy L Thompson 
1961ea61e9acSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1962f04ea552SJeremy L Thompson 
1963eaf62fffSJeremy L Thompson    @param[in]  op     CeedOperator to assemble
1964eaf62fffSJeremy L Thompson    @param[out] values Values to assemble into matrix
1965eaf62fffSJeremy L Thompson 
1966eaf62fffSJeremy L Thompson    @ref User
1967eaf62fffSJeremy L Thompson **/
1968eaf62fffSJeremy L Thompson int CeedOperatorLinearAssemble(CeedOperator op, CeedVector values) {
1969*1c66c397SJeremy L Thompson   bool          is_composite;
1970*1c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
1971b94338b9SJed Brown   CeedSize      single_entries = 0;
1972eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
1973*1c66c397SJeremy L Thompson 
19742b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1975f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1976f3d47e36SJeremy L Thompson 
1977f3d47e36SJeremy L Thompson   // Early exit for empty operator
1978f3d47e36SJeremy L Thompson   if (!is_composite) {
1979f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1980f3d47e36SJeremy L Thompson 
1981f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1982f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1983f3d47e36SJeremy L Thompson   }
1984eaf62fffSJeremy L Thompson 
1985eaf62fffSJeremy L Thompson   if (op->LinearAssemble) {
1986d04bbc78SJeremy L Thompson     // Backend version
19872b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemble(op, values));
1988eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1989eaf62fffSJeremy L Thompson   } else {
1990d04bbc78SJeremy L Thompson     // Operator fallback
1991d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1992d04bbc78SJeremy L Thompson 
19932b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1994d04bbc78SJeremy L Thompson     if (op_fallback) {
19952b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemble(op_fallback, values));
1996eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1997eaf62fffSJeremy L Thompson     }
1998eaf62fffSJeremy L Thompson   }
1999eaf62fffSJeremy L Thompson 
2000eaf62fffSJeremy L Thompson   // Default interface implementation
200128ec399dSJeremy L Thompson   CeedCall(CeedVectorSetValue(values, 0.0));
2002eaf62fffSJeremy L Thompson   if (is_composite) {
2003c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2004c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
2005cefa2673SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; k++) {
20062b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemble(sub_operators[k], offset, values));
20072b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
2008eaf62fffSJeremy L Thompson       offset += single_entries;
2009eaf62fffSJeremy L Thompson     }
2010eaf62fffSJeremy L Thompson   } else {
20112b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssemble(op, offset, values));
2012eaf62fffSJeremy L Thompson   }
2013eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2014eaf62fffSJeremy L Thompson }
2015eaf62fffSJeremy L Thompson 
2016eaf62fffSJeremy L Thompson /**
201775f0d5a4SJeremy L Thompson   @brief Get the multiplicity of nodes across suboperators in a composite CeedOperator
201875f0d5a4SJeremy L Thompson 
201975f0d5a4SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
202075f0d5a4SJeremy L Thompson 
202175f0d5a4SJeremy L Thompson   @param[in]  op               Composite CeedOperator
202275f0d5a4SJeremy L Thompson   @param[in]  num_skip_indices Number of suboperators to skip
202375f0d5a4SJeremy L Thompson   @param[in]  skip_indices     Array of indices of suboperators to skip
202475f0d5a4SJeremy L Thompson   @param[out] mult             Vector to store multiplicity (of size l_size)
202575f0d5a4SJeremy L Thompson 
202675f0d5a4SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
202775f0d5a4SJeremy L Thompson 
202875f0d5a4SJeremy L Thompson   @ref User
202975f0d5a4SJeremy L Thompson **/
203075f0d5a4SJeremy L Thompson int CeedCompositeOperatorGetMultiplicity(CeedOperator op, CeedInt num_skip_indices, CeedInt *skip_indices, CeedVector mult) {
203175f0d5a4SJeremy L Thompson   Ceed                ceed;
2032b275c451SJeremy L Thompson   CeedInt             num_suboperators;
203375f0d5a4SJeremy L Thompson   CeedSize            l_vec_len;
203475f0d5a4SJeremy L Thompson   CeedScalar         *mult_array;
203575f0d5a4SJeremy L Thompson   CeedVector          ones_l_vec;
20367c1dbaffSSebastian Grimberg   CeedElemRestriction elem_rstr, mult_elem_rstr;
2037b275c451SJeremy L Thompson   CeedOperator       *sub_operators;
203875f0d5a4SJeremy L Thompson 
2039*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2040*1c66c397SJeremy L Thompson 
204175f0d5a4SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
204275f0d5a4SJeremy L Thompson 
204375f0d5a4SJeremy L Thompson   // Zero mult vector
204475f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(mult, 0.0));
204575f0d5a4SJeremy L Thompson 
204675f0d5a4SJeremy L Thompson   // Get suboperators
2047b275c451SJeremy L Thompson   CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2048b275c451SJeremy L Thompson   CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
2049b275c451SJeremy L Thompson   if (num_suboperators == 0) return CEED_ERROR_SUCCESS;
205075f0d5a4SJeremy L Thompson 
205175f0d5a4SJeremy L Thompson   // Work vector
205275f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetLength(mult, &l_vec_len));
205375f0d5a4SJeremy L Thompson   CeedCall(CeedVectorCreate(ceed, l_vec_len, &ones_l_vec));
205475f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(ones_l_vec, 1.0));
205575f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetArray(mult, CEED_MEM_HOST, &mult_array));
205675f0d5a4SJeremy L Thompson 
205775f0d5a4SJeremy L Thompson   // Compute multiplicity across suboperators
2058b275c451SJeremy L Thompson   for (CeedInt i = 0; i < num_suboperators; i++) {
205975f0d5a4SJeremy L Thompson     const CeedScalar *sub_mult_array;
206075f0d5a4SJeremy L Thompson     CeedVector        sub_mult_l_vec, ones_e_vec;
206175f0d5a4SJeremy L Thompson 
206275f0d5a4SJeremy L Thompson     // -- Check for suboperator to skip
206375f0d5a4SJeremy L Thompson     for (CeedInt j = 0; j < num_skip_indices; j++) {
206475f0d5a4SJeremy L Thompson       if (skip_indices[j] == i) continue;
206575f0d5a4SJeremy L Thompson     }
206675f0d5a4SJeremy L Thompson 
206775f0d5a4SJeremy L Thompson     // -- Sub operator multiplicity
2068437c7c90SJeremy L Thompson     CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[i], &elem_rstr));
20697c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr, &mult_elem_rstr));
20707c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateVector(mult_elem_rstr, &sub_mult_l_vec, &ones_e_vec));
207175f0d5a4SJeremy L Thompson     CeedCall(CeedVectorSetValue(sub_mult_l_vec, 0.0));
20727c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_NOTRANSPOSE, ones_l_vec, ones_e_vec, CEED_REQUEST_IMMEDIATE));
20737c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_TRANSPOSE, ones_e_vec, sub_mult_l_vec, CEED_REQUEST_IMMEDIATE));
207475f0d5a4SJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(sub_mult_l_vec, CEED_MEM_HOST, &sub_mult_array));
207575f0d5a4SJeremy L Thompson     // ---- Flag every node present in the current suboperator
207675f0d5a4SJeremy L Thompson     for (CeedInt j = 0; j < l_vec_len; j++) {
207775f0d5a4SJeremy L Thompson       if (sub_mult_array[j] > 0.0) mult_array[j] += 1.0;
207875f0d5a4SJeremy L Thompson     }
207975f0d5a4SJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(sub_mult_l_vec, &sub_mult_array));
208075f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&sub_mult_l_vec));
208175f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&ones_e_vec));
20827c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&mult_elem_rstr));
208375f0d5a4SJeremy L Thompson   }
208475f0d5a4SJeremy L Thompson   CeedCall(CeedVectorRestoreArray(mult, &mult_array));
2085811d0ccfSJeremy L Thompson   CeedCall(CeedVectorDestroy(&ones_l_vec));
208675f0d5a4SJeremy L Thompson   return CEED_ERROR_SUCCESS;
208775f0d5a4SJeremy L Thompson }
208875f0d5a4SJeremy L Thompson 
208975f0d5a4SJeremy L Thompson /**
2090ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator, creating the prolongation basis from the fine and coarse
2091ea61e9acSJeremy L Thompson grid interpolation
2092eaf62fffSJeremy L Thompson 
209358e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2094f04ea552SJeremy L Thompson 
2095eaf62fffSJeremy L Thompson   @param[in]  op_fine      Fine grid operator
209685bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2097eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid restriction
2098eaf62fffSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector basis
2099eaf62fffSJeremy L Thompson   @param[out] op_coarse    Coarse grid operator
210085bb9dcfSJeremy L Thompson   @param[out] op_prolong   Coarse to fine operator, or NULL
210185bb9dcfSJeremy L Thompson   @param[out] op_restrict  Fine to coarse operator, or NULL
2102eaf62fffSJeremy L Thompson 
2103eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2104eaf62fffSJeremy L Thompson 
2105eaf62fffSJeremy L Thompson   @ref User
2106eaf62fffSJeremy L Thompson **/
21072b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreate(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
21082b730f8bSJeremy L Thompson                                      CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) {
2109*1c66c397SJeremy L Thompson   CeedBasis basis_c_to_f = NULL;
2110*1c66c397SJeremy L Thompson 
21112b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
2112eaf62fffSJeremy L Thompson 
211383d6adf3SZach Atkins   // Build prolongation matrix, if required
211483d6adf3SZach Atkins   if (op_prolong || op_restrict) {
211583d6adf3SZach Atkins     CeedBasis basis_fine;
2116*1c66c397SJeremy L Thompson 
21172b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
21182b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateProjection(basis_coarse, basis_fine, &basis_c_to_f));
211983d6adf3SZach Atkins   }
2120eaf62fffSJeremy L Thompson 
2121f113e5dcSJeremy L Thompson   // Core code
21222b730f8bSJeremy L Thompson   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2123eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2124eaf62fffSJeremy L Thompson }
2125eaf62fffSJeremy L Thompson 
2126eaf62fffSJeremy L Thompson /**
2127ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator with a tensor basis for the active basis
2128eaf62fffSJeremy L Thompson 
212958e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2130f04ea552SJeremy L Thompson 
2131eaf62fffSJeremy L Thompson   @param[in]  op_fine       Fine grid operator
213285bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2133eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid restriction
2134eaf62fffSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector basis
213585bb9dcfSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
2136eaf62fffSJeremy L Thompson   @param[out] op_coarse     Coarse grid operator
213785bb9dcfSJeremy L Thompson   @param[out] op_prolong    Coarse to fine operator, or NULL
213885bb9dcfSJeremy L Thompson   @param[out] op_restrict   Fine to coarse operator, or NULL
2139eaf62fffSJeremy L Thompson 
2140eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2141eaf62fffSJeremy L Thompson 
2142eaf62fffSJeremy L Thompson   @ref User
2143eaf62fffSJeremy L Thompson **/
21442b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateTensorH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
21452b730f8bSJeremy L Thompson                                              const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
21462b730f8bSJeremy L Thompson                                              CeedOperator *op_restrict) {
2147eaf62fffSJeremy L Thompson   Ceed      ceed;
2148*1c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
2149*1c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
2150*1c66c397SJeremy L Thompson 
2151*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
21522b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2153eaf62fffSJeremy L Thompson 
2154eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
21552b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
21562b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
21572b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
21586574a04fSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces");
2159eaf62fffSJeremy L Thompson 
216083d6adf3SZach Atkins   // Create coarse to fine basis, if required
216183d6adf3SZach Atkins   if (op_prolong || op_restrict) {
2162*1c66c397SJeremy L Thompson     CeedInt     dim, num_comp, num_nodes_c, P_1d_f, P_1d_c;
2163*1c66c397SJeremy L Thompson     CeedScalar *q_ref, *q_weight, *grad;
2164*1c66c397SJeremy L Thompson 
216583d6adf3SZach Atkins     // Check if interpolation matrix is provided
21666574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
21676574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
21682b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
21692b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
21702b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes1D(basis_fine, &P_1d_f));
21712b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
21722b730f8bSJeremy L Thompson     P_1d_c = dim == 1 ? num_nodes_c : dim == 2 ? sqrt(num_nodes_c) : cbrt(num_nodes_c);
21732b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_ref));
21742b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_weight));
21752b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f * P_1d_c * dim, &grad));
21762b730f8bSJeremy 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));
21772b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
21782b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
21792b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
218083d6adf3SZach Atkins   }
2181eaf62fffSJeremy L Thompson 
2182eaf62fffSJeremy L Thompson   // Core code
21832b730f8bSJeremy L Thompson   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2184eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2185eaf62fffSJeremy L Thompson }
2186eaf62fffSJeremy L Thompson 
2187eaf62fffSJeremy L Thompson /**
2188ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator with a non-tensor basis for the active vector
2189eaf62fffSJeremy L Thompson 
219058e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2191f04ea552SJeremy L Thompson 
2192eaf62fffSJeremy L Thompson   @param[in]  op_fine       Fine grid operator
219385bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2194eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid restriction
2195eaf62fffSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector basis
219685bb9dcfSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
2197eaf62fffSJeremy L Thompson   @param[out] op_coarse     Coarse grid operator
219885bb9dcfSJeremy L Thompson   @param[out] op_prolong    Coarse to fine operator, or NULL
219985bb9dcfSJeremy L Thompson   @param[out] op_restrict   Fine to coarse operator, or NULL
2200eaf62fffSJeremy L Thompson 
2201eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2202eaf62fffSJeremy L Thompson 
2203eaf62fffSJeremy L Thompson   @ref User
2204eaf62fffSJeremy L Thompson **/
22052b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
22062b730f8bSJeremy L Thompson                                        const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
2207eaf62fffSJeremy L Thompson                                        CeedOperator *op_restrict) {
2208eaf62fffSJeremy L Thompson   Ceed      ceed;
2209*1c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
2210*1c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
2211*1c66c397SJeremy L Thompson 
2212*1c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
22132b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2214eaf62fffSJeremy L Thompson 
2215eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
22162b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
22172b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
22182b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
22196574a04fSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces");
2220eaf62fffSJeremy L Thompson 
2221eaf62fffSJeremy L Thompson   // Coarse to fine basis
222283d6adf3SZach Atkins   if (op_prolong || op_restrict) {
2223*1c66c397SJeremy L Thompson     CeedInt          dim, num_comp, num_nodes_c, num_nodes_f;
2224*1c66c397SJeremy L Thompson     CeedScalar      *q_ref, *q_weight, *grad;
2225*1c66c397SJeremy L Thompson     CeedElemTopology topo;
2226*1c66c397SJeremy L Thompson 
222783d6adf3SZach Atkins     // Check if interpolation matrix is provided
22286574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
22296574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
22302b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetTopology(basis_fine, &topo));
22312b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
22322b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
22332b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes(basis_fine, &num_nodes_f));
22342b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
22352b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * dim, &q_ref));
22362b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f, &q_weight));
22372b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * num_nodes_c * dim, &grad));
22382b730f8bSJeremy 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));
22392b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
22402b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
22412b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
224283d6adf3SZach Atkins   }
2243eaf62fffSJeremy L Thompson 
2244eaf62fffSJeremy L Thompson   // Core code
22452b730f8bSJeremy L Thompson   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2246eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2247eaf62fffSJeremy L Thompson }
2248eaf62fffSJeremy L Thompson 
2249eaf62fffSJeremy L Thompson /**
2250ea61e9acSJeremy L Thompson   @brief Build a FDM based approximate inverse for each element for a CeedOperator
2251eaf62fffSJeremy L Thompson 
2252ea61e9acSJeremy L Thompson   This returns a CeedOperator and CeedVector to apply a Fast Diagonalization Method based approximate inverse.
2253859c15bbSJames 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$.
2254859c15bbSJames Wright   The assembled QFunction is used to modify the eigenvalues from simultaneous diagonalization and obtain an approximate inverse of the form \f$V^T
22559fd66db6SSebastian Grimberg \hat S V\f$.
22569fd66db6SSebastian Grimberg   The CeedOperator must be linear and non-composite.
22579fd66db6SSebastian Grimberg   The associated CeedQFunction must therefore also be linear.
2258eaf62fffSJeremy L Thompson 
2259ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2260f04ea552SJeremy L Thompson 
2261ea61e9acSJeremy L Thompson   @param[in]  op      CeedOperator to create element inverses
2262ea61e9acSJeremy L Thompson   @param[out] fdm_inv CeedOperator to apply the action of a FDM based inverse for each element
2263ea61e9acSJeremy L Thompson   @param[in]  request Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2264eaf62fffSJeremy L Thompson 
2265eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2266eaf62fffSJeremy L Thompson 
2267480fae85SJeremy L Thompson   @ref User
2268eaf62fffSJeremy L Thompson **/
22692b730f8bSJeremy L Thompson int CeedOperatorCreateFDMElementInverse(CeedOperator op, CeedOperator *fdm_inv, CeedRequest *request) {
2270*1c66c397SJeremy L Thompson   Ceed                 ceed, ceed_parent;
2271*1c66c397SJeremy L Thompson   bool                 interp = false, grad = false, is_tensor_basis = true;
2272*1c66c397SJeremy L Thompson   CeedInt              num_input_fields, P_1d, Q_1d, num_nodes, num_qpts, dim, num_comp = 1, num_elem = 1;
2273*1c66c397SJeremy L Thompson   CeedSize             l_size = 1;
2274*1c66c397SJeremy L Thompson   CeedScalar          *mass, *laplace, *x, *fdm_interp, *lambda, *elem_avg;
2275*1c66c397SJeremy L Thompson   const CeedScalar    *interp_1d, *grad_1d, *q_weight_1d;
2276*1c66c397SJeremy L Thompson   CeedVector           q_data;
2277*1c66c397SJeremy L Thompson   CeedElemRestriction  rstr  = NULL, rstr_qd_i;
2278*1c66c397SJeremy L Thompson   CeedBasis            basis = NULL, fdm_basis;
2279*1c66c397SJeremy L Thompson   CeedQFunctionContext ctx_fdm;
2280*1c66c397SJeremy L Thompson   CeedQFunctionField  *qf_fields;
2281*1c66c397SJeremy L Thompson   CeedQFunction        qf, qf_fdm;
2282*1c66c397SJeremy L Thompson   CeedOperatorField   *op_fields;
2283*1c66c397SJeremy L Thompson 
22842b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2285eaf62fffSJeremy L Thompson 
2286eaf62fffSJeremy L Thompson   if (op->CreateFDMElementInverse) {
2287d04bbc78SJeremy L Thompson     // Backend version
22882b730f8bSJeremy L Thompson     CeedCall(op->CreateFDMElementInverse(op, fdm_inv, request));
2289eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2290eaf62fffSJeremy L Thompson   } else {
2291d04bbc78SJeremy L Thompson     // Operator fallback
2292d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2293d04bbc78SJeremy L Thompson 
22942b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2295d04bbc78SJeremy L Thompson     if (op_fallback) {
22962b730f8bSJeremy L Thompson       CeedCall(CeedOperatorCreateFDMElementInverse(op_fallback, fdm_inv, request));
2297eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2298eaf62fffSJeremy L Thompson     }
2299eaf62fffSJeremy L Thompson   }
2300eaf62fffSJeremy L Thompson 
2301d04bbc78SJeremy L Thompson   // Default interface implementation
23022b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
23032b730f8bSJeremy L Thompson   CeedCall(CeedGetOperatorFallbackParentCeed(ceed, &ceed_parent));
2304eaf62fffSJeremy L Thompson   ceed_parent = ceed_parent ? ceed_parent : ceed;
23052b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
2306eaf62fffSJeremy L Thompson 
2307eaf62fffSJeremy L Thompson   // Determine active input basis
23082b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, &num_input_fields, &op_fields, NULL, NULL));
23092b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL));
2310eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
2311eaf62fffSJeremy L Thompson     CeedVector vec;
2312*1c66c397SJeremy L Thompson 
23132b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
2314eaf62fffSJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
2315eaf62fffSJeremy L Thompson       CeedEvalMode eval_mode;
2316*1c66c397SJeremy L Thompson 
23172b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
2318eaf62fffSJeremy L Thompson       interp = interp || eval_mode == CEED_EVAL_INTERP;
2319eaf62fffSJeremy L Thompson       grad   = grad || eval_mode == CEED_EVAL_GRAD;
23202b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis));
23212b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &rstr));
2322eaf62fffSJeremy L Thompson     }
2323eaf62fffSJeremy L Thompson   }
23246574a04fSJeremy L Thompson   CeedCheck(basis, ceed, CEED_ERROR_BACKEND, "No active field set");
23252b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumNodes1D(basis, &P_1d));
2326352a5e7cSSebastian Grimberg   CeedCall(CeedBasisGetNumNodes(basis, &num_nodes));
23272b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints1D(basis, &Q_1d));
23282b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis, &num_qpts));
23292b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetDimension(basis, &dim));
23302b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis, &num_comp));
23312b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
23322b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size));
2333eaf62fffSJeremy L Thompson 
2334eaf62fffSJeremy L Thompson   // Build and diagonalize 1D Mass and Laplacian
23356574a04fSJeremy L Thompson   CeedCall(CeedBasisIsTensor(basis, &is_tensor_basis));
23366574a04fSJeremy L Thompson   CeedCheck(is_tensor_basis, ceed, CEED_ERROR_BACKEND, "FDMElementInverse only supported for tensor bases");
23372b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &mass));
23382b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &laplace));
23392b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &x));
23402b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &fdm_interp));
23412b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d, &lambda));
2342eaf62fffSJeremy L Thompson   // -- Build matrices
23432b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetInterp1D(basis, &interp_1d));
23442b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetGrad1D(basis, &grad_1d));
23452b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetQWeights(basis, &q_weight_1d));
23462b730f8bSJeremy L Thompson   CeedCall(CeedBuildMassLaplace(interp_1d, grad_1d, q_weight_1d, P_1d, Q_1d, dim, mass, laplace));
2347eaf62fffSJeremy L Thompson 
2348eaf62fffSJeremy L Thompson   // -- Diagonalize
23492b730f8bSJeremy L Thompson   CeedCall(CeedSimultaneousDiagonalization(ceed, laplace, mass, x, lambda, P_1d));
23502b730f8bSJeremy L Thompson   CeedCall(CeedFree(&mass));
23512b730f8bSJeremy L Thompson   CeedCall(CeedFree(&laplace));
23522b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
23532b730f8bSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) fdm_interp[i + j * P_1d] = x[j + i * P_1d];
23542b730f8bSJeremy L Thompson   }
23552b730f8bSJeremy L Thompson   CeedCall(CeedFree(&x));
2356eaf62fffSJeremy L Thompson 
2357*1c66c397SJeremy L Thompson   {
2358*1c66c397SJeremy L Thompson     CeedInt             layout[3], num_modes = (interp ? 1 : 0) + (grad ? dim : 0);
2359*1c66c397SJeremy L Thompson     CeedScalar          max_norm = 0;
2360*1c66c397SJeremy L Thompson     const CeedScalar   *assembled_array, *q_weight_array;
2361*1c66c397SJeremy L Thompson     CeedVector          assembled = NULL, q_weight;
2362c5f45aeaSJeremy L Thompson     CeedElemRestriction rstr_qf   = NULL;
2363*1c66c397SJeremy L Thompson 
2364*1c66c397SJeremy L Thompson     // Assemble QFunction
23652b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled, &rstr_qf, request));
23662b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetELayout(rstr_qf, &layout));
23672b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr_qf));
23682b730f8bSJeremy L Thompson     CeedCall(CeedVectorNorm(assembled, CEED_NORM_MAX, &max_norm));
2369eaf62fffSJeremy L Thompson 
2370eaf62fffSJeremy L Thompson     // Calculate element averages
23712b730f8bSJeremy L Thompson     CeedCall(CeedVectorCreate(ceed_parent, num_qpts, &q_weight));
23722b730f8bSJeremy L Thompson     CeedCall(CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_weight));
23732b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(assembled, CEED_MEM_HOST, &assembled_array));
23742b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(q_weight, CEED_MEM_HOST, &q_weight_array));
23752b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_elem, &elem_avg));
2376eaf62fffSJeremy L Thompson     const CeedScalar qf_value_bound = max_norm * 100 * CEED_EPSILON;
2377*1c66c397SJeremy L Thompson 
2378eaf62fffSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
2379eaf62fffSJeremy L Thompson       CeedInt count = 0;
2380*1c66c397SJeremy L Thompson 
23812b730f8bSJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
23822b730f8bSJeremy L Thompson         for (CeedInt i = 0; i < num_comp * num_comp * num_modes * num_modes; i++) {
23832b730f8bSJeremy L Thompson           if (fabs(assembled_array[q * layout[0] + i * layout[1] + e * layout[2]]) > qf_value_bound) {
23842b730f8bSJeremy L Thompson             elem_avg[e] += assembled_array[q * layout[0] + i * layout[1] + e * layout[2]] / q_weight_array[q];
2385eaf62fffSJeremy L Thompson             count++;
2386eaf62fffSJeremy L Thompson           }
23872b730f8bSJeremy L Thompson         }
23882b730f8bSJeremy L Thompson       }
2389eaf62fffSJeremy L Thompson       if (count) {
2390eaf62fffSJeremy L Thompson         elem_avg[e] /= count;
2391eaf62fffSJeremy L Thompson       } else {
2392eaf62fffSJeremy L Thompson         elem_avg[e] = 1.0;
2393eaf62fffSJeremy L Thompson       }
2394eaf62fffSJeremy L Thompson     }
23952b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(assembled, &assembled_array));
23962b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled));
23972b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(q_weight, &q_weight_array));
23982b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&q_weight));
2399*1c66c397SJeremy L Thompson   }
2400eaf62fffSJeremy L Thompson 
2401eaf62fffSJeremy L Thompson   // Build FDM diagonal
2402*1c66c397SJeremy L Thompson   {
2403eaf62fffSJeremy L Thompson     CeedScalar *q_data_array, *fdm_diagonal;
2404*1c66c397SJeremy L Thompson 
2405352a5e7cSSebastian Grimberg     CeedCall(CeedCalloc(num_comp * num_nodes, &fdm_diagonal));
2406352a5e7cSSebastian Grimberg     const CeedScalar fdm_diagonal_bound = num_nodes * CEED_EPSILON;
24072b730f8bSJeremy L Thompson     for (CeedInt c = 0; c < num_comp; c++) {
2408352a5e7cSSebastian Grimberg       for (CeedInt n = 0; n < num_nodes; n++) {
2409352a5e7cSSebastian Grimberg         if (interp) fdm_diagonal[c * num_nodes + n] = 1.0;
24102b730f8bSJeremy L Thompson         if (grad) {
2411eaf62fffSJeremy L Thompson           for (CeedInt d = 0; d < dim; d++) {
2412eaf62fffSJeremy L Thompson             CeedInt i = (n / CeedIntPow(P_1d, d)) % P_1d;
2413352a5e7cSSebastian Grimberg             fdm_diagonal[c * num_nodes + n] += lambda[i];
2414eaf62fffSJeremy L Thompson           }
2415eaf62fffSJeremy L Thompson         }
2416352a5e7cSSebastian Grimberg         if (fabs(fdm_diagonal[c * num_nodes + n]) < fdm_diagonal_bound) fdm_diagonal[c * num_nodes + n] = fdm_diagonal_bound;
24172b730f8bSJeremy L Thompson       }
24182b730f8bSJeremy L Thompson     }
2419352a5e7cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed_parent, num_elem * num_comp * num_nodes, &q_data));
24202b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(q_data, 0.0));
24212b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayWrite(q_data, CEED_MEM_HOST, &q_data_array));
24222b730f8bSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
24232b730f8bSJeremy L Thompson       for (CeedInt c = 0; c < num_comp; c++) {
2424*1c66c397SJeremy L Thompson         for (CeedInt n = 0; n < num_nodes; n++)
2425*1c66c397SJeremy L Thompson           q_data_array[(e * num_comp + c) * num_nodes + n] = 1. / (elem_avg[e] * fdm_diagonal[c * num_nodes + n]);
24262b730f8bSJeremy L Thompson       }
24272b730f8bSJeremy L Thompson     }
24282b730f8bSJeremy L Thompson     CeedCall(CeedFree(&elem_avg));
24292b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_diagonal));
24302b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(q_data, &q_data_array));
2431*1c66c397SJeremy L Thompson   }
2432eaf62fffSJeremy L Thompson 
2433eaf62fffSJeremy L Thompson   // Setup FDM operator
2434eaf62fffSJeremy L Thompson   // -- Basis
2435*1c66c397SJeremy L Thompson   {
2436eaf62fffSJeremy L Thompson     CeedScalar *grad_dummy, *q_ref_dummy, *q_weight_dummy;
2437*1c66c397SJeremy L Thompson 
24382b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d * P_1d, &grad_dummy));
24392b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_ref_dummy));
24402b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_weight_dummy));
24412b730f8bSJeremy 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));
24422b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_interp));
24432b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad_dummy));
24442b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref_dummy));
24452b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight_dummy));
24462b730f8bSJeremy L Thompson     CeedCall(CeedFree(&lambda));
2447*1c66c397SJeremy L Thompson   }
2448eaf62fffSJeremy L Thompson 
2449eaf62fffSJeremy L Thompson   // -- Restriction
2450*1c66c397SJeremy L Thompson   {
2451352a5e7cSSebastian Grimberg     CeedInt strides[3] = {1, num_nodes, num_nodes * num_comp};
2452352a5e7cSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateStrided(ceed_parent, num_elem, num_nodes, num_comp, num_elem * num_comp * num_nodes, strides, &rstr_qd_i));
2453*1c66c397SJeremy L Thompson   }
2454*1c66c397SJeremy L Thompson 
2455eaf62fffSJeremy L Thompson   // -- QFunction
24562b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionCreateInteriorByName(ceed_parent, "Scale", &qf_fdm));
24572b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "input", num_comp, CEED_EVAL_INTERP));
24582b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "scale", num_comp, CEED_EVAL_NONE));
24592b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddOutput(qf_fdm, "output", num_comp, CEED_EVAL_INTERP));
24602b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_fdm, num_comp));
2461*1c66c397SJeremy L Thompson 
2462eaf62fffSJeremy L Thompson   // -- QFunction context
2463*1c66c397SJeremy L Thompson   {
2464eaf62fffSJeremy L Thompson     CeedInt *num_comp_data;
2465*1c66c397SJeremy L Thompson 
24662b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_data));
2467eaf62fffSJeremy L Thompson     num_comp_data[0] = num_comp;
24682b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_fdm));
24692b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_fdm, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_data), num_comp_data));
2470*1c66c397SJeremy L Thompson   }
24712b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetContext(qf_fdm, ctx_fdm));
24722b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionContextDestroy(&ctx_fdm));
2473*1c66c397SJeremy L Thompson 
2474eaf62fffSJeremy L Thompson   // -- Operator
24752b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCreate(ceed_parent, qf_fdm, NULL, NULL, fdm_inv));
24762b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "input", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
24772b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "scale", rstr_qd_i, CEED_BASIS_COLLOCATED, q_data));
24782b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "output", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
2479eaf62fffSJeremy L Thompson 
2480eaf62fffSJeremy L Thompson   // Cleanup
24812b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&q_data));
24822b730f8bSJeremy L Thompson   CeedCall(CeedBasisDestroy(&fdm_basis));
24832b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_qd_i));
24842b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionDestroy(&qf_fdm));
2485eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2486eaf62fffSJeremy L Thompson }
2487eaf62fffSJeremy L Thompson 
2488eaf62fffSJeremy L Thompson /// @}
2489