xref: /libCEED/rust/libceed-sys/c-src/interface/ceed-preconditioning.c (revision c22497ad5a46a0850640e10db6d676d37e33d9ae)
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) {
381c66c397SJeremy L Thompson   char *source_path_with_name = NULL;
391c66c397SJeremy 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;
841c66c397SJeremy L Thompson   bool         is_composite;
851c66c397SJeremy 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;
1141c66c397SJeremy 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));
1289e77b9c8SJeremy L Thompson     // Cleanup
1292b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&qf_fallback));
1302b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqf_fallback));
1312b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionDestroy(&dqfT_fallback));
132805fe78eSJeremy L Thompson   }
1332b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetName(op_fallback, op->name));
1342b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fallback));
135b05f7e9fSJeremy L Thompson   // Note: No ref-counting here so we don't get caught in a reference loop.
136b05f7e9fSJeremy L Thompson   //       The op holds the only reference to op_fallback and is responsible for deleting itself and op_fallback.
137805fe78eSJeremy L Thompson   op->op_fallback                 = op_fallback;
138b05f7e9fSJeremy L Thompson   op_fallback->op_fallback_parent = op;
139eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
140eaf62fffSJeremy L Thompson }
141eaf62fffSJeremy L Thompson 
142eaf62fffSJeremy L Thompson /**
143eaf62fffSJeremy L Thompson   @brief Select correct basis matrix pointer based on CeedEvalMode
144eaf62fffSJeremy L Thompson 
145352a5e7cSSebastian Grimberg   @param[in]  basis     CeedBasis from which to get the basis matrix
146eaf62fffSJeremy L Thompson   @param[in]  eval_mode Current basis evaluation mode
147eaf62fffSJeremy L Thompson   @param[in]  identity  Pointer to identity matrix
148eaf62fffSJeremy L Thompson   @param[out] basis_ptr Basis pointer to set
149eaf62fffSJeremy L Thompson 
150eaf62fffSJeremy L Thompson   @ref Developer
151eaf62fffSJeremy L Thompson **/
152352a5e7cSSebastian Grimberg static inline int CeedOperatorGetBasisPointer(CeedBasis basis, CeedEvalMode eval_mode, const CeedScalar *identity, const CeedScalar **basis_ptr) {
153eaf62fffSJeremy L Thompson   switch (eval_mode) {
154eaf62fffSJeremy L Thompson     case CEED_EVAL_NONE:
155eaf62fffSJeremy L Thompson       *basis_ptr = identity;
156eaf62fffSJeremy L Thompson       break;
157eaf62fffSJeremy L Thompson     case CEED_EVAL_INTERP:
158352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetInterp(basis, basis_ptr));
159eaf62fffSJeremy L Thompson       break;
160eaf62fffSJeremy L Thompson     case CEED_EVAL_GRAD:
161352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetGrad(basis, basis_ptr));
162352a5e7cSSebastian Grimberg       break;
163352a5e7cSSebastian Grimberg     case CEED_EVAL_DIV:
164352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetDiv(basis, basis_ptr));
165352a5e7cSSebastian Grimberg       break;
166352a5e7cSSebastian Grimberg     case CEED_EVAL_CURL:
167352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetCurl(basis, basis_ptr));
168eaf62fffSJeremy L Thompson       break;
169eaf62fffSJeremy L Thompson     case CEED_EVAL_WEIGHT:
170eaf62fffSJeremy L Thompson       break;  // Caught by QF Assembly
171eaf62fffSJeremy L Thompson   }
172ed9e99e6SJeremy L Thompson   assert(*basis_ptr != NULL);
173352a5e7cSSebastian Grimberg   return CEED_ERROR_SUCCESS;
174eaf62fffSJeremy L Thompson }
175eaf62fffSJeremy L Thompson 
176eaf62fffSJeremy L Thompson /**
177eaf62fffSJeremy L Thompson   @brief Core logic for assembling operator diagonal or point block diagonal
178eaf62fffSJeremy L Thompson 
179eaf62fffSJeremy L Thompson   @param[in]  op             CeedOperator to assemble point block diagonal
180ea61e9acSJeremy L Thompson   @param[in]  request        Address of CeedRequest for non-blocking completion, else CEED_REQUEST_IMMEDIATE
181bd83916cSSebastian Grimberg   @param[in]  is_point_block Boolean flag to assemble diagonal or point block diagonal
182eaf62fffSJeremy L Thompson   @param[out] assembled      CeedVector to store assembled diagonal
183eaf62fffSJeremy L Thompson 
184eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
185eaf62fffSJeremy L Thompson 
186eaf62fffSJeremy L Thompson   @ref Developer
187eaf62fffSJeremy L Thompson **/
188bd83916cSSebastian Grimberg static inline int CeedSingleOperatorAssembleAddDiagonal_Core(CeedOperator op, CeedRequest *request, const bool is_point_block, CeedVector assembled) {
189eaf62fffSJeremy L Thompson   Ceed ceed;
190506b1a0cSSebastian Grimberg   bool is_composite;
191506b1a0cSSebastian Grimberg 
192506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetCeed(op, &ceed));
193506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorIsComposite(op, &is_composite));
194506b1a0cSSebastian Grimberg   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
195506b1a0cSSebastian Grimberg 
196506b1a0cSSebastian Grimberg   // Assemble QFunction
197506b1a0cSSebastian Grimberg   CeedInt             layout_qf[3];
198437c7c90SJeremy L Thompson   const CeedScalar   *assembled_qf_array;
199c5f45aeaSJeremy L Thompson   CeedVector          assembled_qf        = NULL;
200c5f45aeaSJeremy L Thompson   CeedElemRestriction assembled_elem_rstr = NULL;
201437c7c90SJeremy L Thompson 
202437c7c90SJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, request));
203506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, &layout_qf));
204437c7c90SJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr));
205437c7c90SJeremy L Thompson   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
206eaf62fffSJeremy L Thompson 
207ed9e99e6SJeremy L Thompson   // Get assembly data
208437c7c90SJeremy L Thompson   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
209506b1a0cSSebastian Grimberg   CeedInt                  num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out;
210437c7c90SJeremy L Thompson   CeedSize               **eval_mode_offsets_in, **eval_mode_offsets_out, num_output_components;
211506b1a0cSSebastian Grimberg   CeedBasis               *active_bases_in, *active_bases_out;
212506b1a0cSSebastian Grimberg   CeedElemRestriction     *active_elem_rstrs_in, *active_elem_rstrs_out;
2131c66c397SJeremy L Thompson   CeedOperatorAssemblyData data;
2141c66c397SJeremy L Thompson 
215437c7c90SJeremy L Thompson   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
216506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, &eval_mode_offsets_in,
217506b1a0cSSebastian Grimberg                                                 &num_active_bases_out, &num_eval_modes_out, &eval_modes_out, &eval_mode_offsets_out,
218506b1a0cSSebastian Grimberg                                                 &num_output_components));
219506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, NULL, NULL, &active_bases_out, NULL));
220506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, NULL, &active_elem_rstrs_in, NULL, &active_elem_rstrs_out));
221506b1a0cSSebastian Grimberg 
222934a29f5SSebastian Grimberg   // Loop over all active bases (find matching input/output pairs)
223934a29f5SSebastian Grimberg   for (CeedInt b = 0; b < CeedIntMin(num_active_bases_in, num_active_bases_out); b++) {
224934a29f5SSebastian Grimberg     CeedInt             b_in, b_out, num_elem, num_nodes, num_qpts, num_comp;
2251c66c397SJeremy L Thompson     bool                has_eval_none = false;
2261c66c397SJeremy L Thompson     CeedScalar         *elem_diag_array, *identity = NULL;
2271c66c397SJeremy L Thompson     CeedVector          elem_diag;
2287c1dbaffSSebastian Grimberg     CeedElemRestriction diag_elem_rstr;
2291c66c397SJeremy L Thompson 
230934a29f5SSebastian Grimberg     if (num_active_bases_in <= num_active_bases_out) {
231934a29f5SSebastian Grimberg       b_in = b;
232934a29f5SSebastian Grimberg       for (b_out = 0; b_out < num_active_bases_out; b_out++) {
233934a29f5SSebastian Grimberg         if (active_bases_in[b_in] == active_bases_out[b_out]) {
234934a29f5SSebastian Grimberg           break;
235934a29f5SSebastian Grimberg         }
236934a29f5SSebastian Grimberg       }
237934a29f5SSebastian Grimberg       if (b_out == num_active_bases_out) {
238934a29f5SSebastian Grimberg         continue;
239934a29f5SSebastian Grimberg       }  // No matching output basis found
240934a29f5SSebastian Grimberg     } else {
241934a29f5SSebastian Grimberg       b_out = b;
242934a29f5SSebastian Grimberg       for (b_in = 0; b_in < num_active_bases_in; b_in++) {
243934a29f5SSebastian Grimberg         if (active_bases_in[b_in] == active_bases_out[b_out]) {
244934a29f5SSebastian Grimberg           break;
245934a29f5SSebastian Grimberg         }
246934a29f5SSebastian Grimberg       }
247934a29f5SSebastian Grimberg       if (b_in == num_active_bases_in) {
248934a29f5SSebastian Grimberg         continue;
249934a29f5SSebastian Grimberg       }  // No matching output basis found
250934a29f5SSebastian Grimberg     }
251934a29f5SSebastian Grimberg     CeedCheck(active_elem_rstrs_in[b_in] == active_elem_rstrs_out[b_out], ceed, CEED_ERROR_UNSUPPORTED,
252506b1a0cSSebastian Grimberg               "Cannot assemble operator diagonal with different input and output active element restrictions");
253506b1a0cSSebastian Grimberg 
2541c66c397SJeremy L Thompson     // Assemble point block diagonal restriction, if needed
255bd83916cSSebastian Grimberg     if (is_point_block) {
256934a29f5SSebastian Grimberg       CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstrs_in[b_in], &diag_elem_rstr));
2577c1dbaffSSebastian Grimberg     } else {
258934a29f5SSebastian Grimberg       CeedCall(CeedElemRestrictionCreateUnsignedCopy(active_elem_rstrs_in[b_in], &diag_elem_rstr));
259eaf62fffSJeremy L Thompson     }
260eaf62fffSJeremy L Thompson 
261eaf62fffSJeremy L Thompson     // Create diagonal vector
262437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(diag_elem_rstr, NULL, &elem_diag));
263eaf62fffSJeremy L Thompson 
264eaf62fffSJeremy L Thompson     // Assemble element operator diagonals
2652b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(elem_diag, 0.0));
2662b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArray(elem_diag, CEED_MEM_HOST, &elem_diag_array));
267437c7c90SJeremy L Thompson     CeedCall(CeedElemRestrictionGetNumElements(diag_elem_rstr, &num_elem));
268934a29f5SSebastian Grimberg     CeedCall(CeedBasisGetNumNodes(active_bases_in[b_in], &num_nodes));
269934a29f5SSebastian Grimberg     CeedCall(CeedBasisGetNumComponents(active_bases_in[b_in], &num_comp));
270934a29f5SSebastian Grimberg     if (active_bases_in[b_in] == CEED_BASIS_NONE) num_qpts = num_nodes;
271934a29f5SSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(active_bases_in[b_in], &num_qpts));
272ed9e99e6SJeremy L Thompson 
273352a5e7cSSebastian Grimberg     // Construct identity matrix for basis if required
274934a29f5SSebastian Grimberg     for (CeedInt i = 0; i < num_eval_modes_in[b_in]; i++) {
275934a29f5SSebastian Grimberg       has_eval_none = has_eval_none || (eval_modes_in[b_in][i] == CEED_EVAL_NONE);
276ed9e99e6SJeremy L Thompson     }
277934a29f5SSebastian Grimberg     for (CeedInt i = 0; i < num_eval_modes_out[b_out]; i++) {
278934a29f5SSebastian Grimberg       has_eval_none = has_eval_none || (eval_modes_out[b_out][i] == CEED_EVAL_NONE);
279ed9e99e6SJeremy L Thompson     }
280ed9e99e6SJeremy L Thompson     if (has_eval_none) {
2812b730f8bSJeremy L Thompson       CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
2822b730f8bSJeremy L Thompson       for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) identity[i * num_nodes + i] = 1.0;
283eaf62fffSJeremy L Thompson     }
284352a5e7cSSebastian Grimberg 
285eaf62fffSJeremy L Thompson     // Compute the diagonal of B^T D B
286eaf62fffSJeremy L Thompson     // Each element
287b94338b9SJed Brown     for (CeedSize e = 0; e < num_elem; e++) {
288eaf62fffSJeremy L Thompson       // Each basis eval mode pair
289352a5e7cSSebastian Grimberg       CeedInt      d_out              = 0, q_comp_out;
290352a5e7cSSebastian Grimberg       CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
2911c66c397SJeremy L Thompson 
292934a29f5SSebastian Grimberg       for (CeedInt e_out = 0; e_out < num_eval_modes_out[b_out]; e_out++) {
2931c66c397SJeremy L Thompson         CeedInt           d_in              = 0, q_comp_in;
294437c7c90SJeremy L Thompson         const CeedScalar *B_t               = NULL;
2951c66c397SJeremy L Thompson         CeedEvalMode      eval_mode_in_prev = CEED_EVAL_NONE;
2961c66c397SJeremy L Thompson 
297934a29f5SSebastian Grimberg         CeedCall(CeedOperatorGetBasisPointer(active_bases_out[b_out], eval_modes_out[b_out][e_out], identity, &B_t));
298934a29f5SSebastian Grimberg         CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_out[b_out], eval_modes_out[b_out][e_out], &q_comp_out));
299352a5e7cSSebastian Grimberg         if (q_comp_out > 1) {
300934a29f5SSebastian Grimberg           if (e_out == 0 || eval_modes_out[b_out][e_out] != eval_mode_out_prev) d_out = 0;
301352a5e7cSSebastian Grimberg           else B_t = &B_t[(++d_out) * num_qpts * num_nodes];
302352a5e7cSSebastian Grimberg         }
303934a29f5SSebastian Grimberg         eval_mode_out_prev = eval_modes_out[b_out][e_out];
304352a5e7cSSebastian Grimberg 
305934a29f5SSebastian Grimberg         for (CeedInt e_in = 0; e_in < num_eval_modes_in[b_in]; e_in++) {
306437c7c90SJeremy L Thompson           const CeedScalar *B = NULL;
3071c66c397SJeremy L Thompson 
308934a29f5SSebastian Grimberg           CeedCall(CeedOperatorGetBasisPointer(active_bases_in[b_in], eval_modes_in[b_in][e_in], identity, &B));
309934a29f5SSebastian Grimberg           CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_in[b_in], eval_modes_in[b_in][e_in], &q_comp_in));
310352a5e7cSSebastian Grimberg           if (q_comp_in > 1) {
311934a29f5SSebastian Grimberg             if (e_in == 0 || eval_modes_in[b_in][e_in] != eval_mode_in_prev) d_in = 0;
312352a5e7cSSebastian Grimberg             else B = &B[(++d_in) * num_qpts * num_nodes];
313352a5e7cSSebastian Grimberg           }
314934a29f5SSebastian Grimberg           eval_mode_in_prev = eval_modes_in[b_in][e_in];
315352a5e7cSSebastian Grimberg 
316eaf62fffSJeremy L Thompson           // Each component
317506b1a0cSSebastian Grimberg           for (CeedInt c_out = 0; c_out < num_comp; c_out++) {
318437c7c90SJeremy L Thompson             // Each qpt/node pair
3192b730f8bSJeremy L Thompson             for (CeedInt q = 0; q < num_qpts; q++) {
320bd83916cSSebastian Grimberg               if (is_point_block) {
321eaf62fffSJeremy L Thompson                 // Point Block Diagonal
322506b1a0cSSebastian Grimberg                 for (CeedInt c_in = 0; c_in < num_comp; c_in++) {
323934a29f5SSebastian Grimberg                   const CeedSize c_offset =
324934a29f5SSebastian Grimberg                       (eval_mode_offsets_in[b_in][e_in] + c_in) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out;
325506b1a0cSSebastian Grimberg                   const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]];
3261c66c397SJeremy L Thompson 
3272b730f8bSJeremy L Thompson                   for (CeedInt n = 0; n < num_nodes; n++) {
328506b1a0cSSebastian Grimberg                     elem_diag_array[((e * num_comp + c_out) * num_comp + c_in) * num_nodes + n] +=
329437c7c90SJeremy L Thompson                         B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
330eaf62fffSJeremy L Thompson                   }
3312b730f8bSJeremy L Thompson                 }
332eaf62fffSJeremy L Thompson               } else {
333eaf62fffSJeremy L Thompson                 // Diagonal Only
334934a29f5SSebastian Grimberg                 const CeedInt c_offset =
335934a29f5SSebastian Grimberg                     (eval_mode_offsets_in[b_in][e_in] + c_out) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out;
336506b1a0cSSebastian Grimberg                 const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]];
3371c66c397SJeremy L Thompson 
3382b730f8bSJeremy L Thompson                 for (CeedInt n = 0; n < num_nodes; n++) {
339506b1a0cSSebastian Grimberg                   elem_diag_array[(e * num_comp + c_out) * num_nodes + n] += B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n];
340eaf62fffSJeremy L Thompson                 }
341eaf62fffSJeremy L Thompson               }
342eaf62fffSJeremy L Thompson             }
343eaf62fffSJeremy L Thompson           }
3442b730f8bSJeremy L Thompson         }
3452b730f8bSJeremy L Thompson       }
3462b730f8bSJeremy L Thompson     }
3472b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(elem_diag, &elem_diag_array));
348eaf62fffSJeremy L Thompson 
349eaf62fffSJeremy L Thompson     // Assemble local operator diagonal
3507c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(diag_elem_rstr, CEED_TRANSPOSE, elem_diag, assembled, request));
351eaf62fffSJeremy L Thompson 
352eaf62fffSJeremy L Thompson     // Cleanup
3537c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&diag_elem_rstr));
3542b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&elem_diag));
3552b730f8bSJeremy L Thompson     CeedCall(CeedFree(&identity));
356437c7c90SJeremy L Thompson   }
357437c7c90SJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
358437c7c90SJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
359eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
360eaf62fffSJeremy L Thompson }
361eaf62fffSJeremy L Thompson 
362eaf62fffSJeremy L Thompson /**
363eaf62fffSJeremy L Thompson   @brief Core logic for assembling composite operator diagonal
364eaf62fffSJeremy L Thompson 
365eaf62fffSJeremy L Thompson   @param[in]  op             CeedOperator to assemble point block diagonal
366ea61e9acSJeremy L Thompson   @param[in]  request        Address of CeedRequest for non-blocking completion, else CEED_REQUEST_IMMEDIATE
367bd83916cSSebastian Grimberg   @param[in]  is_point_block Boolean flag to assemble diagonal or point block diagonal
368eaf62fffSJeremy L Thompson   @param[out] assembled      CeedVector to store assembled diagonal
369eaf62fffSJeremy L Thompson 
370eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
371eaf62fffSJeremy L Thompson 
372eaf62fffSJeremy L Thompson   @ref Developer
373eaf62fffSJeremy L Thompson **/
374bd83916cSSebastian Grimberg static inline int CeedCompositeOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_point_block,
375eaf62fffSJeremy L Thompson                                                                  CeedVector assembled) {
376eaf62fffSJeremy L Thompson   CeedInt       num_sub;
377eaf62fffSJeremy L Thompson   CeedOperator *suboperators;
3781c66c397SJeremy L Thompson 
379c6ebc35dSJeremy L Thompson   CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub));
380c6ebc35dSJeremy L Thompson   CeedCall(CeedCompositeOperatorGetSubList(op, &suboperators));
381eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_sub; i++) {
382bd83916cSSebastian Grimberg     if (is_point_block) {
3832b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(suboperators[i], assembled, request));
3846aa95790SJeremy L Thompson     } else {
3852b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddDiagonal(suboperators[i], assembled, request));
3866aa95790SJeremy L Thompson     }
387eaf62fffSJeremy L Thompson   }
388eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
389eaf62fffSJeremy L Thompson }
390eaf62fffSJeremy L Thompson 
391eaf62fffSJeremy L Thompson /**
392eaf62fffSJeremy L Thompson   @brief Build nonzero pattern for non-composite operator
393eaf62fffSJeremy L Thompson 
394eaf62fffSJeremy L Thompson   Users should generally use CeedOperatorLinearAssembleSymbolic()
395eaf62fffSJeremy L Thompson 
396eaf62fffSJeremy L Thompson   @param[in]  op     CeedOperator to assemble nonzero pattern
397eaf62fffSJeremy L Thompson   @param[in]  offset Offset for number of entries
398eaf62fffSJeremy L Thompson   @param[out] rows   Row number for each entry
399eaf62fffSJeremy L Thompson   @param[out] cols   Column number for each entry
400eaf62fffSJeremy L Thompson 
401eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
402eaf62fffSJeremy L Thompson 
403eaf62fffSJeremy L Thompson   @ref Developer
404eaf62fffSJeremy L Thompson **/
4052b730f8bSJeremy L Thompson static int CeedSingleOperatorAssembleSymbolic(CeedOperator op, CeedInt offset, CeedInt *rows, CeedInt *cols) {
406f3d47e36SJeremy L Thompson   Ceed                ceed;
407f3d47e36SJeremy L Thompson   bool                is_composite;
408506b1a0cSSebastian Grimberg   CeedSize            num_nodes_in, num_nodes_out, count = 0;
409506b1a0cSSebastian Grimberg   CeedInt             num_elem_in, elem_size_in, num_comp_in, layout_er_in[3];
410506b1a0cSSebastian Grimberg   CeedInt             num_elem_out, elem_size_out, num_comp_out, layout_er_out[3], local_num_entries;
4111c66c397SJeremy L Thompson   CeedScalar         *array;
412506b1a0cSSebastian Grimberg   const CeedScalar   *elem_dof_a_in, *elem_dof_a_out;
413506b1a0cSSebastian Grimberg   CeedVector          index_vec_in, index_vec_out, elem_dof_in, elem_dof_out;
414506b1a0cSSebastian Grimberg   CeedElemRestriction elem_rstr_in, elem_rstr_out, index_elem_rstr_in, index_elem_rstr_out;
4151c66c397SJeremy L Thompson 
416f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
417f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
4186574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
419eaf62fffSJeremy L Thompson 
420506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveVectorLengths(op, &num_nodes_in, &num_nodes_out));
421506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out));
422506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in));
423506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in));
424506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in));
425506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetELayout(elem_rstr_in, &layout_er_in));
426eaf62fffSJeremy L Thompson 
427506b1a0cSSebastian Grimberg   // Determine elem_dof relation for input
428506b1a0cSSebastian Grimberg   CeedCall(CeedVectorCreate(ceed, num_nodes_in, &index_vec_in));
429506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayWrite(index_vec_in, CEED_MEM_HOST, &array));
430506b1a0cSSebastian Grimberg   for (CeedInt i = 0; i < num_nodes_in; i++) array[i] = i;
431506b1a0cSSebastian Grimberg   CeedCall(CeedVectorRestoreArray(index_vec_in, &array));
432506b1a0cSSebastian Grimberg   CeedCall(CeedVectorCreate(ceed, num_elem_in * elem_size_in * num_comp_in, &elem_dof_in));
433506b1a0cSSebastian Grimberg   CeedCall(CeedVectorSetValue(elem_dof_in, 0.0));
434506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_in, &index_elem_rstr_in));
435506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionApply(index_elem_rstr_in, CEED_NOTRANSPOSE, index_vec_in, elem_dof_in, CEED_REQUEST_IMMEDIATE));
436506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayRead(elem_dof_in, CEED_MEM_HOST, &elem_dof_a_in));
437506b1a0cSSebastian Grimberg   CeedCall(CeedVectorDestroy(&index_vec_in));
438506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_in));
439506b1a0cSSebastian Grimberg 
440506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
441506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out));
442506b1a0cSSebastian Grimberg     CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED,
443506b1a0cSSebastian Grimberg               "Active input and output operator restrictions must have the same number of elements");
444506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out));
445506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out));
446506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetELayout(elem_rstr_out, &layout_er_out));
447506b1a0cSSebastian Grimberg 
448506b1a0cSSebastian Grimberg     // Determine elem_dof relation for output
449506b1a0cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed, num_nodes_out, &index_vec_out));
450506b1a0cSSebastian Grimberg     CeedCall(CeedVectorGetArrayWrite(index_vec_out, CEED_MEM_HOST, &array));
451506b1a0cSSebastian Grimberg     for (CeedInt i = 0; i < num_nodes_out; i++) array[i] = i;
452506b1a0cSSebastian Grimberg     CeedCall(CeedVectorRestoreArray(index_vec_out, &array));
453506b1a0cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed, num_elem_out * elem_size_out * num_comp_out, &elem_dof_out));
454506b1a0cSSebastian Grimberg     CeedCall(CeedVectorSetValue(elem_dof_out, 0.0));
455506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_out, &index_elem_rstr_out));
456506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(index_elem_rstr_out, CEED_NOTRANSPOSE, index_vec_out, elem_dof_out, CEED_REQUEST_IMMEDIATE));
457506b1a0cSSebastian Grimberg     CeedCall(CeedVectorGetArrayRead(elem_dof_out, CEED_MEM_HOST, &elem_dof_a_out));
458506b1a0cSSebastian Grimberg     CeedCall(CeedVectorDestroy(&index_vec_out));
459506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_out));
460506b1a0cSSebastian Grimberg   } else {
461506b1a0cSSebastian Grimberg     num_elem_out     = num_elem_in;
462506b1a0cSSebastian Grimberg     elem_size_out    = elem_size_in;
463506b1a0cSSebastian Grimberg     num_comp_out     = num_comp_in;
464506b1a0cSSebastian Grimberg     layout_er_out[0] = layout_er_in[0];
465506b1a0cSSebastian Grimberg     layout_er_out[1] = layout_er_in[1];
466506b1a0cSSebastian Grimberg     layout_er_out[2] = layout_er_in[2];
467506b1a0cSSebastian Grimberg     elem_dof_a_out   = elem_dof_a_in;
468506b1a0cSSebastian Grimberg   }
469506b1a0cSSebastian Grimberg   local_num_entries = elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in;
470eaf62fffSJeremy L Thompson 
471eaf62fffSJeremy L Thompson   // Determine i, j locations for element matrices
472506b1a0cSSebastian Grimberg   for (CeedInt e = 0; e < num_elem_in; e++) {
473506b1a0cSSebastian Grimberg     for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) {
474506b1a0cSSebastian Grimberg       for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) {
475506b1a0cSSebastian Grimberg         for (CeedInt i = 0; i < elem_size_out; i++) {
476506b1a0cSSebastian Grimberg           for (CeedInt j = 0; j < elem_size_in; j++) {
477506b1a0cSSebastian Grimberg             const CeedInt elem_dof_index_row = i * layout_er_out[0] + comp_out * layout_er_out[1] + e * layout_er_out[2];
478506b1a0cSSebastian Grimberg             const CeedInt elem_dof_index_col = j * layout_er_in[0] + comp_in * layout_er_in[1] + e * layout_er_in[2];
479506b1a0cSSebastian Grimberg             const CeedInt row                = elem_dof_a_out[elem_dof_index_row];
480506b1a0cSSebastian Grimberg             const CeedInt col                = elem_dof_a_in[elem_dof_index_col];
481eaf62fffSJeremy L Thompson 
482eaf62fffSJeremy L Thompson             rows[offset + count] = row;
483eaf62fffSJeremy L Thompson             cols[offset + count] = col;
484eaf62fffSJeremy L Thompson             count++;
485eaf62fffSJeremy L Thompson           }
486eaf62fffSJeremy L Thompson         }
487eaf62fffSJeremy L Thompson       }
488eaf62fffSJeremy L Thompson     }
489eaf62fffSJeremy L Thompson   }
4906574a04fSJeremy L Thompson   CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing assembled entries");
491506b1a0cSSebastian Grimberg   CeedCall(CeedVectorRestoreArrayRead(elem_dof_in, &elem_dof_a_in));
492506b1a0cSSebastian Grimberg   CeedCall(CeedVectorDestroy(&elem_dof_in));
493506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
494506b1a0cSSebastian Grimberg     CeedCall(CeedVectorRestoreArrayRead(elem_dof_out, &elem_dof_a_out));
495506b1a0cSSebastian Grimberg     CeedCall(CeedVectorDestroy(&elem_dof_out));
496506b1a0cSSebastian Grimberg   }
497eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
498eaf62fffSJeremy L Thompson }
499eaf62fffSJeremy L Thompson 
500eaf62fffSJeremy L Thompson /**
501eaf62fffSJeremy L Thompson   @brief Assemble nonzero entries for non-composite operator
502eaf62fffSJeremy L Thompson 
503eaf62fffSJeremy L Thompson   Users should generally use CeedOperatorLinearAssemble()
504eaf62fffSJeremy L Thompson 
505eaf62fffSJeremy L Thompson   @param[in]  op     CeedOperator to assemble
506ea61e9acSJeremy L Thompson   @param[in]  offset Offset for number of entries
507eaf62fffSJeremy L Thompson   @param[out] values Values to assemble into matrix
508eaf62fffSJeremy L Thompson 
509eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
510eaf62fffSJeremy L Thompson 
511eaf62fffSJeremy L Thompson   @ref Developer
512eaf62fffSJeremy L Thompson **/
5132b730f8bSJeremy L Thompson static int CeedSingleOperatorAssemble(CeedOperator op, CeedInt offset, CeedVector values) {
514f3d47e36SJeremy L Thompson   Ceed ceed;
515f3d47e36SJeremy L Thompson   bool is_composite;
5161c66c397SJeremy L Thompson 
517f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
518f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
5196574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
520f3d47e36SJeremy L Thompson 
521f3d47e36SJeremy L Thompson   // Early exit for empty operator
522f3d47e36SJeremy L Thompson   {
523f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
524f3d47e36SJeremy L Thompson 
525f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
526f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
527f3d47e36SJeremy L Thompson   }
528eaf62fffSJeremy L Thompson 
529cefa2673SJeremy L Thompson   if (op->LinearAssembleSingle) {
530cefa2673SJeremy L Thompson     // Backend version
5312b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSingle(op, offset, values));
532cefa2673SJeremy L Thompson     return CEED_ERROR_SUCCESS;
533cefa2673SJeremy L Thompson   } else {
534cefa2673SJeremy L Thompson     // Operator fallback
535cefa2673SJeremy L Thompson     CeedOperator op_fallback;
536cefa2673SJeremy L Thompson 
5372b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
538cefa2673SJeremy L Thompson     if (op_fallback) {
5392b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemble(op_fallback, offset, values));
540cefa2673SJeremy L Thompson       return CEED_ERROR_SUCCESS;
541cefa2673SJeremy L Thompson     }
542cefa2673SJeremy L Thompson   }
543cefa2673SJeremy L Thompson 
544eaf62fffSJeremy L Thompson   // Assemble QFunction
545506b1a0cSSebastian Grimberg   CeedInt             layout_qf[3];
5461c66c397SJeremy L Thompson   const CeedScalar   *assembled_qf_array;
547c5f45aeaSJeremy L Thompson   CeedVector          assembled_qf        = NULL;
548506b1a0cSSebastian Grimberg   CeedElemRestriction assembled_elem_rstr = NULL;
549eaf62fffSJeremy L Thompson 
550506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, CEED_REQUEST_IMMEDIATE));
551506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, &layout_qf));
552506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr));
553506b1a0cSSebastian Grimberg   CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array));
554eaf62fffSJeremy L Thompson 
555ed9e99e6SJeremy L Thompson   // Get assembly data
556506b1a0cSSebastian Grimberg   CeedInt                  num_elem_in, elem_size_in, num_comp_in, num_qpts_in;
557506b1a0cSSebastian Grimberg   CeedInt                  num_elem_out, elem_size_out, num_comp_out, num_qpts_out, local_num_entries;
558506b1a0cSSebastian Grimberg   const CeedEvalMode     **eval_modes_in, **eval_modes_out;
559506b1a0cSSebastian Grimberg   CeedInt                  num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out;
560506b1a0cSSebastian Grimberg   CeedBasis               *active_bases_in, *active_bases_out, basis_in, basis_out;
561506b1a0cSSebastian Grimberg   const CeedScalar       **B_mats_in, **B_mats_out, *B_mat_in, *B_mat_out;
562506b1a0cSSebastian Grimberg   CeedElemRestriction      elem_rstr_in, elem_rstr_out;
563506b1a0cSSebastian Grimberg   CeedRestrictionType      elem_rstr_type_in, elem_rstr_type_out;
564506b1a0cSSebastian Grimberg   const bool              *elem_rstr_orients_in = NULL, *elem_rstr_orients_out = NULL;
565506b1a0cSSebastian Grimberg   const CeedInt8          *elem_rstr_curl_orients_in = NULL, *elem_rstr_curl_orients_out = NULL;
566506b1a0cSSebastian Grimberg   CeedOperatorAssemblyData data;
567eaf62fffSJeremy L Thompson 
568506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data));
569506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, NULL, &num_active_bases_out,
570506b1a0cSSebastian Grimberg                                                 &num_eval_modes_out, &eval_modes_out, NULL, NULL));
571506b1a0cSSebastian Grimberg 
572506b1a0cSSebastian Grimberg   CeedCheck(num_active_bases_in == num_active_bases_out && num_active_bases_in == 1, ceed, CEED_ERROR_UNSUPPORTED,
573506b1a0cSSebastian Grimberg             "Cannot assemble operator with multiple active bases");
5746574a04fSJeremy L Thompson   CeedCheck(num_eval_modes_in[0] > 0 && num_eval_modes_out[0] > 0, ceed, CEED_ERROR_UNSUPPORTED, "Cannot assemble operator without inputs/outputs");
575eaf62fffSJeremy L Thompson 
576506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, &B_mats_in, NULL, &active_bases_out, &B_mats_out));
577506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out));
578506b1a0cSSebastian Grimberg   basis_in  = active_bases_in[0];
579506b1a0cSSebastian Grimberg   basis_out = active_bases_out[0];
580506b1a0cSSebastian Grimberg   B_mat_in  = B_mats_in[0];
581506b1a0cSSebastian Grimberg   B_mat_out = B_mats_out[0];
582eaf62fffSJeremy L Thompson 
583506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in));
584506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in));
585506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in));
586506b1a0cSSebastian Grimberg   if (basis_in == CEED_BASIS_NONE) num_qpts_in = elem_size_in;
587506b1a0cSSebastian Grimberg   else CeedCall(CeedBasisGetNumQuadraturePoints(basis_in, &num_qpts_in));
588506b1a0cSSebastian Grimberg 
589506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetType(elem_rstr_in, &elem_rstr_type_in));
590506b1a0cSSebastian Grimberg   if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) {
591506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_orients_in));
592506b1a0cSSebastian Grimberg   } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) {
593506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_curl_orients_in));
5947c1dbaffSSebastian Grimberg   }
5957c1dbaffSSebastian Grimberg 
596506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
597506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out));
598506b1a0cSSebastian Grimberg     CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED,
599506b1a0cSSebastian Grimberg               "Active input and output operator restrictions must have the same number of elements");
600506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out));
601506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out));
602506b1a0cSSebastian Grimberg     if (basis_out == CEED_BASIS_NONE) num_qpts_out = elem_size_out;
603506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(basis_out, &num_qpts_out));
604506b1a0cSSebastian Grimberg     CeedCheck(num_qpts_in == num_qpts_out, ceed, CEED_ERROR_UNSUPPORTED,
605506b1a0cSSebastian Grimberg               "Active input and output bases must have the same number of quadrature points");
606eaf62fffSJeremy L Thompson 
607506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetType(elem_rstr_out, &elem_rstr_type_out));
608506b1a0cSSebastian Grimberg     if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) {
609506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_orients_out));
610506b1a0cSSebastian Grimberg     } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) {
611506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_curl_orients_out));
612506b1a0cSSebastian Grimberg     }
613506b1a0cSSebastian Grimberg   } else {
614506b1a0cSSebastian Grimberg     num_elem_out  = num_elem_in;
615506b1a0cSSebastian Grimberg     elem_size_out = elem_size_in;
616506b1a0cSSebastian Grimberg     num_comp_out  = num_comp_in;
617506b1a0cSSebastian Grimberg     num_qpts_out  = num_qpts_in;
618506b1a0cSSebastian Grimberg 
619506b1a0cSSebastian Grimberg     elem_rstr_orients_out      = elem_rstr_orients_in;
620506b1a0cSSebastian Grimberg     elem_rstr_curl_orients_out = elem_rstr_curl_orients_in;
621506b1a0cSSebastian Grimberg   }
622506b1a0cSSebastian Grimberg   local_num_entries = elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in;
623506b1a0cSSebastian Grimberg 
624506b1a0cSSebastian Grimberg   // Loop over elements and put in data structure
6257c1dbaffSSebastian Grimberg   // We store B_mat_in, B_mat_out, BTD, elem_mat in row-major order
6261c66c397SJeremy L Thompson   CeedSize           count = 0;
6270459ebd3SSebastian Grimberg   CeedTensorContract contract;
628123d890dSSebastian Grimberg   CeedScalar        *vals, *BTD_mat = NULL, *elem_mat = NULL, *elem_mat_b = NULL;
629506b1a0cSSebastian Grimberg 
630*c22497adSSebastian Grimberg   CeedCall(CeedBasisGetTensorContract(basis_in, &contract));
631123d890dSSebastian Grimberg   CeedCall(CeedCalloc(elem_size_out * num_qpts_in * num_eval_modes_in[0], &BTD_mat));
632123d890dSSebastian Grimberg   CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat));
633506b1a0cSSebastian Grimberg   if (elem_rstr_curl_orients_in || elem_rstr_curl_orients_out) CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat_b));
6341c66c397SJeremy L Thompson 
63528ec399dSJeremy L Thompson   CeedCall(CeedVectorGetArray(values, CEED_MEM_HOST, &vals));
636506b1a0cSSebastian Grimberg   for (CeedSize e = 0; e < num_elem_in; e++) {
637506b1a0cSSebastian Grimberg     for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) {
638506b1a0cSSebastian Grimberg       for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) {
639ed9e99e6SJeremy L Thompson         // Compute B^T*D
640506b1a0cSSebastian Grimberg         for (CeedSize n = 0; n < elem_size_out; n++) {
641506b1a0cSSebastian Grimberg           for (CeedSize q = 0; q < num_qpts_in; q++) {
642437c7c90SJeremy L Thompson             for (CeedInt e_in = 0; e_in < num_eval_modes_in[0]; e_in++) {
643506b1a0cSSebastian Grimberg               const CeedSize btd_index = n * (num_qpts_in * num_eval_modes_in[0]) + q * num_eval_modes_in[0] + e_in;
644067fd99fSJeremy L Thompson               CeedScalar     sum       = 0.0;
6451c66c397SJeremy L Thompson 
646437c7c90SJeremy L Thompson               for (CeedInt e_out = 0; e_out < num_eval_modes_out[0]; e_out++) {
647506b1a0cSSebastian Grimberg                 const CeedSize b_out_index     = (q * num_eval_modes_out[0] + e_out) * elem_size_out + n;
648506b1a0cSSebastian Grimberg                 const CeedSize eval_mode_index = ((e_in * num_comp_in + comp_in) * num_eval_modes_out[0] + e_out) * num_comp_out + comp_out;
649b94338b9SJed Brown                 const CeedSize qf_index        = q * layout_qf[0] + eval_mode_index * layout_qf[1] + e * layout_qf[2];
6501c66c397SJeremy L Thompson 
651067fd99fSJeremy L Thompson                 sum += B_mat_out[b_out_index] * assembled_qf_array[qf_index];
652eaf62fffSJeremy L Thompson               }
653067fd99fSJeremy L Thompson               BTD_mat[btd_index] = sum;
654ed9e99e6SJeremy L Thompson             }
655ed9e99e6SJeremy L Thompson           }
656eaf62fffSJeremy L Thompson         }
6577c1dbaffSSebastian Grimberg 
6587c1dbaffSSebastian Grimberg         // Form element matrix itself (for each block component)
6590459ebd3SSebastian Grimberg         CeedCall(CeedTensorContractApply(contract, 1, num_qpts_in * num_eval_modes_in[0], elem_size_in, elem_size_out, BTD_mat, CEED_NOTRANSPOSE,
6600459ebd3SSebastian Grimberg                                          false, B_mat_in, elem_mat));
661eaf62fffSJeremy L Thompson 
6627c1dbaffSSebastian Grimberg         // Transform the element matrix if required
663506b1a0cSSebastian Grimberg         if (elem_rstr_orients_out) {
664506b1a0cSSebastian Grimberg           const bool *elem_orients = &elem_rstr_orients_out[e * elem_size_out];
6651c66c397SJeremy L Thompson 
666506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
667506b1a0cSSebastian Grimberg             const double orient = elem_orients[i] ? -1.0 : 1.0;
668506b1a0cSSebastian Grimberg 
669506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
670506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] *= orient;
6717c1dbaffSSebastian Grimberg             }
6727c1dbaffSSebastian Grimberg           }
673506b1a0cSSebastian Grimberg         } else if (elem_rstr_curl_orients_out) {
674506b1a0cSSebastian Grimberg           const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_out[e * 3 * elem_size_out];
6751c66c397SJeremy L Thompson 
6767c1dbaffSSebastian Grimberg           // T^T*(B^T*D*B)
677506b1a0cSSebastian Grimberg           memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar));
678506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
679506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
680506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * i + 1] +
681506b1a0cSSebastian Grimberg                                                (i > 0 ? elem_mat_b[(i - 1) * elem_size_in + j] * elem_curl_orients[3 * i - 1] : 0.0) +
682506b1a0cSSebastian Grimberg                                                (i < elem_size_out - 1 ? elem_mat_b[(i + 1) * elem_size_in + j] * elem_curl_orients[3 * i + 3] : 0.0);
6837c1dbaffSSebastian Grimberg             }
6847c1dbaffSSebastian Grimberg           }
685506b1a0cSSebastian Grimberg         }
686506b1a0cSSebastian Grimberg         if (elem_rstr_orients_in) {
687506b1a0cSSebastian Grimberg           const bool *elem_orients = &elem_rstr_orients_in[e * elem_size_in];
688506b1a0cSSebastian Grimberg 
689506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
690506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
691506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] *= elem_orients[j] ? -1.0 : 1.0;
692506b1a0cSSebastian Grimberg             }
693506b1a0cSSebastian Grimberg           }
694506b1a0cSSebastian Grimberg         } else if (elem_rstr_curl_orients_in) {
695506b1a0cSSebastian Grimberg           const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_in[e * 3 * elem_size_in];
696506b1a0cSSebastian Grimberg 
697506b1a0cSSebastian Grimberg           // (B^T*D*B)*T
698506b1a0cSSebastian Grimberg           memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar));
699506b1a0cSSebastian Grimberg           for (CeedInt i = 0; i < elem_size_out; i++) {
700506b1a0cSSebastian Grimberg             for (CeedInt j = 0; j < elem_size_in; j++) {
701506b1a0cSSebastian Grimberg               elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * j + 1] +
702506b1a0cSSebastian Grimberg                                                (j > 0 ? elem_mat_b[i * elem_size_in + j - 1] * elem_curl_orients[3 * j - 1] : 0.0) +
703506b1a0cSSebastian Grimberg                                                (j < elem_size_in - 1 ? elem_mat_b[i * elem_size_in + j + 1] * elem_curl_orients[3 * j + 3] : 0.0);
7047c1dbaffSSebastian Grimberg             }
7057c1dbaffSSebastian Grimberg           }
7067c1dbaffSSebastian Grimberg         }
7077c1dbaffSSebastian Grimberg 
7087c1dbaffSSebastian Grimberg         // Put element matrix in coordinate data structure
709506b1a0cSSebastian Grimberg         for (CeedInt i = 0; i < elem_size_out; i++) {
710506b1a0cSSebastian Grimberg           for (CeedInt j = 0; j < elem_size_in; j++) {
711506b1a0cSSebastian Grimberg             vals[offset + count] = elem_mat[i * elem_size_in + j];
712eaf62fffSJeremy L Thompson             count++;
713eaf62fffSJeremy L Thompson           }
714eaf62fffSJeremy L Thompson         }
715eaf62fffSJeremy L Thompson       }
716eaf62fffSJeremy L Thompson     }
717eaf62fffSJeremy L Thompson   }
7186574a04fSJeremy L Thompson   CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing entries");
7192b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArray(values, &vals));
720eaf62fffSJeremy L Thompson 
721506b1a0cSSebastian Grimberg   // Cleanup
722123d890dSSebastian Grimberg   CeedCall(CeedFree(&BTD_mat));
723123d890dSSebastian Grimberg   CeedCall(CeedFree(&elem_mat));
724506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&elem_mat_b));
725506b1a0cSSebastian Grimberg   if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) {
726506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_in, &elem_rstr_orients_in));
727506b1a0cSSebastian Grimberg   } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) {
728506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_in, &elem_rstr_curl_orients_in));
729506b1a0cSSebastian Grimberg   }
730506b1a0cSSebastian Grimberg   if (elem_rstr_in != elem_rstr_out) {
731506b1a0cSSebastian Grimberg     if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) {
732506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_out, &elem_rstr_orients_out));
733506b1a0cSSebastian Grimberg     } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) {
734506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_out, &elem_rstr_curl_orients_out));
735506b1a0cSSebastian Grimberg     }
736506b1a0cSSebastian Grimberg   }
7372b730f8bSJeremy L Thompson   CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array));
7382b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&assembled_qf));
739eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
740eaf62fffSJeremy L Thompson }
741eaf62fffSJeremy L Thompson 
742eaf62fffSJeremy L Thompson /**
743eaf62fffSJeremy L Thompson   @brief Count number of entries for assembled CeedOperator
744eaf62fffSJeremy L Thompson 
745eaf62fffSJeremy L Thompson   @param[in]  op          CeedOperator to assemble
746eaf62fffSJeremy L Thompson   @param[out] num_entries Number of entries in assembled representation
747eaf62fffSJeremy L Thompson 
748eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
749eaf62fffSJeremy L Thompson 
750eaf62fffSJeremy L Thompson   @ref Utility
751eaf62fffSJeremy L Thompson **/
752b94338b9SJed Brown static int CeedSingleOperatorAssemblyCountEntries(CeedOperator op, CeedSize *num_entries) {
753b275c451SJeremy L Thompson   bool                is_composite;
754506b1a0cSSebastian Grimberg   CeedInt             num_elem_in, elem_size_in, num_comp_in, num_elem_out, elem_size_out, num_comp_out;
755506b1a0cSSebastian Grimberg   CeedElemRestriction rstr_in, rstr_out;
756eaf62fffSJeremy L Thompson 
757b275c451SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
7586574a04fSJeremy L Thompson   CeedCheck(!is_composite, op->ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported");
759506b1a0cSSebastian Grimberg 
760506b1a0cSSebastian Grimberg   CeedCall(CeedOperatorGetActiveElemRestrictions(op, &rstr_in, &rstr_out));
761506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(rstr_in, &num_elem_in));
762506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(rstr_in, &elem_size_in));
763506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(rstr_in, &num_comp_in));
764506b1a0cSSebastian Grimberg   if (rstr_in != rstr_out) {
765506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumElements(rstr_out, &num_elem_out));
766506b1a0cSSebastian Grimberg     CeedCheck(num_elem_in == num_elem_out, op->ceed, CEED_ERROR_UNSUPPORTED,
767506b1a0cSSebastian Grimberg               "Active input and output operator restrictions must have the same number of elements");
768506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetElementSize(rstr_out, &elem_size_out));
769506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetNumComponents(rstr_out, &num_comp_out));
770506b1a0cSSebastian Grimberg   } else {
771506b1a0cSSebastian Grimberg     num_elem_out  = num_elem_in;
772506b1a0cSSebastian Grimberg     elem_size_out = elem_size_in;
773506b1a0cSSebastian Grimberg     num_comp_out  = num_comp_in;
774506b1a0cSSebastian Grimberg   }
775506b1a0cSSebastian Grimberg   *num_entries = (CeedSize)elem_size_in * num_comp_in * elem_size_out * num_comp_out * num_elem_in;
776eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
777eaf62fffSJeremy L Thompson }
778eaf62fffSJeremy L Thompson 
779eaf62fffSJeremy L Thompson /**
780ea61e9acSJeremy L Thompson   @brief Common code for creating a multigrid coarse operator and level transfer operators for a CeedOperator
781eaf62fffSJeremy L Thompson 
782eaf62fffSJeremy L Thompson   @param[in]  op_fine      Fine grid operator
78385bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
784eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid restriction
785eaf62fffSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector basis
78685bb9dcfSJeremy L Thompson   @param[in]  basis_c_to_f Basis for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
787eaf62fffSJeremy L Thompson   @param[out] op_coarse    Coarse grid operator
78885bb9dcfSJeremy L Thompson   @param[out] op_prolong   Coarse to fine operator, or NULL
7897758292fSSebastian Grimberg   @param[out] op_restrict  Fine to coarse operator, or NULL
790eaf62fffSJeremy L Thompson 
791eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
792eaf62fffSJeremy L Thompson 
793eaf62fffSJeremy L Thompson   @ref Developer
794eaf62fffSJeremy L Thompson **/
7952b730f8bSJeremy L Thompson static int CeedSingleOperatorMultigridLevel(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
7967758292fSSebastian Grimberg                                             CeedBasis basis_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) {
7971c66c397SJeremy L Thompson   bool                is_composite;
798eaf62fffSJeremy L Thompson   Ceed                ceed;
7991c66c397SJeremy L Thompson   CeedInt             num_comp;
80085bb9dcfSJeremy L Thompson   CeedVector          mult_vec         = NULL;
8011c66c397SJeremy L Thompson   CeedElemRestriction rstr_p_mult_fine = NULL, rstr_fine = NULL;
8021c66c397SJeremy L Thompson 
8032b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
804eaf62fffSJeremy L Thompson 
805eaf62fffSJeremy L Thompson   // Check for composite operator
8062b730f8bSJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op_fine, &is_composite));
8076574a04fSJeremy L Thompson   CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Automatic multigrid setup for composite operators not supported");
808eaf62fffSJeremy L Thompson 
809eaf62fffSJeremy L Thompson   // Coarse Grid
8102b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCreate(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse));
811eaf62fffSJeremy L Thompson   // -- Clone input fields
81292ae7e47SJeremy L Thompson   for (CeedInt i = 0; i < op_fine->qf->num_input_fields; i++) {
813eaf62fffSJeremy L Thompson     if (op_fine->input_fields[i]->vec == CEED_VECTOR_ACTIVE) {
814437c7c90SJeremy L Thompson       rstr_fine = op_fine->input_fields[i]->elem_rstr;
8152b730f8bSJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->input_fields[i]->field_name, rstr_coarse, basis_coarse, CEED_VECTOR_ACTIVE));
816eaf62fffSJeremy L Thompson     } else {
817437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->input_fields[i]->field_name, op_fine->input_fields[i]->elem_rstr,
8182b730f8bSJeremy L Thompson                                     op_fine->input_fields[i]->basis, op_fine->input_fields[i]->vec));
819eaf62fffSJeremy L Thompson     }
820eaf62fffSJeremy L Thompson   }
821eaf62fffSJeremy L Thompson   // -- Clone output fields
82292ae7e47SJeremy L Thompson   for (CeedInt i = 0; i < op_fine->qf->num_output_fields; i++) {
823eaf62fffSJeremy L Thompson     if (op_fine->output_fields[i]->vec == CEED_VECTOR_ACTIVE) {
8242b730f8bSJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->output_fields[i]->field_name, rstr_coarse, basis_coarse, CEED_VECTOR_ACTIVE));
825eaf62fffSJeremy L Thompson     } else {
826437c7c90SJeremy L Thompson       CeedCall(CeedOperatorSetField(*op_coarse, op_fine->output_fields[i]->field_name, op_fine->output_fields[i]->elem_rstr,
8272b730f8bSJeremy L Thompson                                     op_fine->output_fields[i]->basis, op_fine->output_fields[i]->vec));
828eaf62fffSJeremy L Thompson     }
829eaf62fffSJeremy L Thompson   }
830af99e877SJeremy L Thompson   // -- Clone QFunctionAssemblyData
8312b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataReferenceCopy(op_fine->qf_assembled, &(*op_coarse)->qf_assembled));
832eaf62fffSJeremy L Thompson 
833eaf62fffSJeremy L Thompson   // Multiplicity vector
8347758292fSSebastian Grimberg   if (op_restrict || op_prolong) {
83585bb9dcfSJeremy L Thompson     CeedVector          mult_e_vec;
8361c66c397SJeremy L Thompson     CeedRestrictionType rstr_type;
83785bb9dcfSJeremy L Thompson 
8387c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionGetType(rstr_fine, &rstr_type));
8397c1dbaffSSebastian Grimberg     CeedCheck(rstr_type != CEED_RESTRICTION_CURL_ORIENTED, ceed, CEED_ERROR_UNSUPPORTED,
8407c1dbaffSSebastian Grimberg               "Element restrictions created with CeedElemRestrictionCreateCurlOriented are not supported");
8416574a04fSJeremy L Thompson     CeedCheck(p_mult_fine, ceed, CEED_ERROR_INCOMPATIBLE, "Prolongation or restriction operator creation requires fine grid multiplicity vector");
8427c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnsignedCopy(rstr_fine, &rstr_p_mult_fine));
8432b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionCreateVector(rstr_fine, &mult_vec, &mult_e_vec));
8442b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_e_vec, 0.0));
845c17ec2beSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_NOTRANSPOSE, p_mult_fine, mult_e_vec, CEED_REQUEST_IMMEDIATE));
8462b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(mult_vec, 0.0));
847c17ec2beSJeremy L Thompson     CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_TRANSPOSE, mult_e_vec, mult_vec, CEED_REQUEST_IMMEDIATE));
8482b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&mult_e_vec));
8492b730f8bSJeremy L Thompson     CeedCall(CeedVectorReciprocal(mult_vec));
85085bb9dcfSJeremy L Thompson   }
851eaf62fffSJeremy L Thompson 
852addd79feSZach Atkins   // Clone name
853addd79feSZach Atkins   bool   has_name = op_fine->name;
854addd79feSZach Atkins   size_t name_len = op_fine->name ? strlen(op_fine->name) : 0;
855addd79feSZach Atkins   CeedCall(CeedOperatorSetName(*op_coarse, op_fine->name));
856addd79feSZach Atkins 
8577758292fSSebastian Grimberg   // Check that coarse to fine basis is provided if prolong/restrict operators are requested
8587758292fSSebastian Grimberg   CeedCheck(basis_c_to_f || (!op_restrict && !op_prolong), ceed, CEED_ERROR_INCOMPATIBLE,
8596574a04fSJeremy L Thompson             "Prolongation or restriction operator creation requires coarse-to-fine basis");
86083d6adf3SZach Atkins 
86185bb9dcfSJeremy L Thompson   // Restriction/Prolongation Operators
8622b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis_coarse, &num_comp));
863addd79feSZach Atkins 
864addd79feSZach Atkins   // Restriction
8657758292fSSebastian Grimberg   if (op_restrict) {
866eaf62fffSJeremy L Thompson     CeedInt             *num_comp_r_data;
86785bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_r;
8687758292fSSebastian Grimberg     CeedQFunction        qf_restrict;
86985bb9dcfSJeremy L Thompson 
8707758292fSSebastian Grimberg     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_restrict));
8712b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_r_data));
872eaf62fffSJeremy L Thompson     num_comp_r_data[0] = num_comp;
8732b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_r));
8742b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_r, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_r_data), num_comp_r_data));
8757758292fSSebastian Grimberg     CeedCall(CeedQFunctionSetContext(qf_restrict, ctx_r));
8762b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_r));
8777758292fSSebastian Grimberg     CeedCall(CeedQFunctionAddInput(qf_restrict, "input", num_comp, CEED_EVAL_NONE));
8787758292fSSebastian Grimberg     CeedCall(CeedQFunctionAddInput(qf_restrict, "scale", num_comp, CEED_EVAL_NONE));
8797758292fSSebastian Grimberg     CeedCall(CeedQFunctionAddOutput(qf_restrict, "output", num_comp, CEED_EVAL_INTERP));
8807758292fSSebastian Grimberg     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_restrict, num_comp));
881eaf62fffSJeremy L Thompson 
8827758292fSSebastian Grimberg     CeedCall(CeedOperatorCreate(ceed, qf_restrict, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_restrict));
8837758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "input", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
8847758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec));
8857758292fSSebastian Grimberg     CeedCall(CeedOperatorSetField(*op_restrict, "output", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
886eaf62fffSJeremy L Thompson 
887addd79feSZach Atkins     // Set name
888addd79feSZach Atkins     char *restriction_name;
8891c66c397SJeremy L Thompson 
890addd79feSZach Atkins     CeedCall(CeedCalloc(17 + name_len, &restriction_name));
891addd79feSZach Atkins     sprintf(restriction_name, "restriction%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
8927758292fSSebastian Grimberg     CeedCall(CeedOperatorSetName(*op_restrict, restriction_name));
893addd79feSZach Atkins     CeedCall(CeedFree(&restriction_name));
894addd79feSZach Atkins 
895addd79feSZach Atkins     // Check
8967758292fSSebastian Grimberg     CeedCall(CeedOperatorCheckReady(*op_restrict));
897addd79feSZach Atkins 
898addd79feSZach Atkins     // Cleanup
8997758292fSSebastian Grimberg     CeedCall(CeedQFunctionDestroy(&qf_restrict));
900addd79feSZach Atkins   }
901addd79feSZach Atkins 
902eaf62fffSJeremy L Thompson   // Prolongation
903addd79feSZach Atkins   if (op_prolong) {
904eaf62fffSJeremy L Thompson     CeedInt             *num_comp_p_data;
90585bb9dcfSJeremy L Thompson     CeedQFunctionContext ctx_p;
9061c66c397SJeremy L Thompson     CeedQFunction        qf_prolong;
90785bb9dcfSJeremy L Thompson 
90885bb9dcfSJeremy L Thompson     CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_prolong));
9092b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_p_data));
910eaf62fffSJeremy L Thompson     num_comp_p_data[0] = num_comp;
9112b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_p));
9122b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_p, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_p_data), num_comp_p_data));
9132b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetContext(qf_prolong, ctx_p));
9142b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextDestroy(&ctx_p));
9152b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "input", num_comp, CEED_EVAL_INTERP));
9162b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddInput(qf_prolong, "scale", num_comp, CEED_EVAL_NONE));
9172b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAddOutput(qf_prolong, "output", num_comp, CEED_EVAL_NONE));
9182b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_prolong, num_comp));
919eaf62fffSJeremy L Thompson 
9202b730f8bSJeremy L Thompson     CeedCall(CeedOperatorCreate(ceed, qf_prolong, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_prolong));
9212b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "input", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE));
922356036faSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec));
923356036faSJeremy L Thompson     CeedCall(CeedOperatorSetField(*op_prolong, "output", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE));
924eaf62fffSJeremy L Thompson 
925addd79feSZach Atkins     // Set name
926ea6b5821SJeremy L Thompson     char *prolongation_name;
9271c66c397SJeremy L Thompson 
9282b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(18 + name_len, &prolongation_name));
9292b730f8bSJeremy L Thompson     sprintf(prolongation_name, "prolongation%s%s", has_name ? " for " : "", has_name ? op_fine->name : "");
9302b730f8bSJeremy L Thompson     CeedCall(CeedOperatorSetName(*op_prolong, prolongation_name));
9312b730f8bSJeremy L Thompson     CeedCall(CeedFree(&prolongation_name));
932addd79feSZach Atkins 
933addd79feSZach Atkins     // Check
934addd79feSZach Atkins     CeedCall(CeedOperatorCheckReady(*op_prolong));
935addd79feSZach Atkins 
936addd79feSZach Atkins     // Cleanup
937addd79feSZach Atkins     CeedCall(CeedQFunctionDestroy(&qf_prolong));
938ea6b5821SJeremy L Thompson   }
939ea6b5821SJeremy L Thompson 
94058e4b056SJeremy L Thompson   // Check
94158e4b056SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(*op_coarse));
94258e4b056SJeremy L Thompson 
943eaf62fffSJeremy L Thompson   // Cleanup
9442b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&mult_vec));
945c17ec2beSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_fine));
9462b730f8bSJeremy L Thompson   CeedCall(CeedBasisDestroy(&basis_c_to_f));
947eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
948eaf62fffSJeremy L Thompson }
949eaf62fffSJeremy L Thompson 
950eaf62fffSJeremy L Thompson /**
951eaf62fffSJeremy L Thompson   @brief Build 1D mass matrix and Laplacian with perturbation
952eaf62fffSJeremy L Thompson 
953eaf62fffSJeremy L Thompson   @param[in]  interp_1d   Interpolation matrix in one dimension
954eaf62fffSJeremy L Thompson   @param[in]  grad_1d     Gradient matrix in one dimension
955eaf62fffSJeremy L Thompson   @param[in]  q_weight_1d Quadrature weights in one dimension
956eaf62fffSJeremy L Thompson   @param[in]  P_1d        Number of basis nodes in one dimension
957eaf62fffSJeremy L Thompson   @param[in]  Q_1d        Number of quadrature points in one dimension
958eaf62fffSJeremy L Thompson   @param[in]  dim         Dimension of basis
959eaf62fffSJeremy L Thompson   @param[out] mass        Assembled mass matrix in one dimension
960eaf62fffSJeremy L Thompson   @param[out] laplace     Assembled perturbed Laplacian in one dimension
961eaf62fffSJeremy L Thompson 
962eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
963eaf62fffSJeremy L Thompson 
964eaf62fffSJeremy L Thompson   @ref Developer
965eaf62fffSJeremy L Thompson **/
9662c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOff
9672c2ea1dbSJeremy L Thompson static int CeedBuildMassLaplace(const CeedScalar *interp_1d, const CeedScalar *grad_1d, const CeedScalar *q_weight_1d, CeedInt P_1d, CeedInt Q_1d,
9682c2ea1dbSJeremy L Thompson                                 CeedInt dim, CeedScalar *mass, CeedScalar *laplace) {
9692b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
970eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
971eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
9722b730f8bSJeremy 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];
973eaf62fffSJeremy L Thompson       mass[i + j * P_1d] = sum;
974eaf62fffSJeremy L Thompson     }
9752b730f8bSJeremy L Thompson   }
976eaf62fffSJeremy L Thompson   // -- Laplacian
9772b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
978eaf62fffSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) {
979eaf62fffSJeremy L Thompson       CeedScalar sum = 0.0;
9801c66c397SJeremy L Thompson 
9812b730f8bSJeremy 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];
982eaf62fffSJeremy L Thompson       laplace[i + j * P_1d] = sum;
983eaf62fffSJeremy L Thompson     }
9842b730f8bSJeremy L Thompson   }
985eaf62fffSJeremy L Thompson   CeedScalar perturbation = dim > 2 ? 1e-6 : 1e-4;
9862b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) laplace[i + P_1d * i] += perturbation;
987eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
988eaf62fffSJeremy L Thompson }
9892c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOn
990eaf62fffSJeremy L Thompson 
991eaf62fffSJeremy L Thompson /// @}
992eaf62fffSJeremy L Thompson 
993eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
994480fae85SJeremy L Thompson /// CeedOperator Backend API
995480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
996480fae85SJeremy L Thompson /// @addtogroup CeedOperatorBackend
997480fae85SJeremy L Thompson /// @{
998480fae85SJeremy L Thompson 
999480fae85SJeremy L Thompson /**
1000506b1a0cSSebastian Grimberg   @brief Create point block restriction for active operator field
1001506b1a0cSSebastian Grimberg 
1002506b1a0cSSebastian Grimberg   @param[in]  rstr             Original CeedElemRestriction for active field
1003506b1a0cSSebastian Grimberg   @param[out] point_block_rstr Address of the variable where the newly created CeedElemRestriction will be stored
1004506b1a0cSSebastian Grimberg 
1005506b1a0cSSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
1006506b1a0cSSebastian Grimberg 
1007506b1a0cSSebastian Grimberg   @ref Backend
1008506b1a0cSSebastian Grimberg **/
1009506b1a0cSSebastian Grimberg int CeedOperatorCreateActivePointBlockRestriction(CeedElemRestriction rstr, CeedElemRestriction *point_block_rstr) {
1010506b1a0cSSebastian Grimberg   Ceed           ceed;
1011506b1a0cSSebastian Grimberg   CeedInt        num_elem, num_comp, shift, elem_size, comp_stride, *point_block_offsets;
1012506b1a0cSSebastian Grimberg   CeedSize       l_size;
1013506b1a0cSSebastian Grimberg   const CeedInt *offsets;
1014506b1a0cSSebastian Grimberg 
1015506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetCeed(rstr, &ceed));
1016506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetOffsets(rstr, CEED_MEM_HOST, &offsets));
1017506b1a0cSSebastian Grimberg 
1018506b1a0cSSebastian Grimberg   // Expand offsets
1019506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
1020506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp));
1021506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size));
1022506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetCompStride(rstr, &comp_stride));
1023506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size));
1024506b1a0cSSebastian Grimberg   shift = num_comp;
1025506b1a0cSSebastian Grimberg   if (comp_stride != 1) shift *= num_comp;
1026506b1a0cSSebastian Grimberg   CeedCall(CeedCalloc(num_elem * elem_size, &point_block_offsets));
1027506b1a0cSSebastian Grimberg   for (CeedInt i = 0; i < num_elem * elem_size; i++) {
1028506b1a0cSSebastian Grimberg     point_block_offsets[i] = offsets[i] * shift;
1029506b1a0cSSebastian Grimberg   }
1030506b1a0cSSebastian Grimberg 
1031506b1a0cSSebastian Grimberg   // Create new restriction
1032506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionCreate(ceed, num_elem, elem_size, num_comp * num_comp, 1, l_size * num_comp, CEED_MEM_HOST, CEED_OWN_POINTER,
1033506b1a0cSSebastian Grimberg                                      point_block_offsets, point_block_rstr));
1034506b1a0cSSebastian Grimberg 
1035506b1a0cSSebastian Grimberg   // Cleanup
1036506b1a0cSSebastian Grimberg   CeedCall(CeedElemRestrictionRestoreOffsets(rstr, &offsets));
1037506b1a0cSSebastian Grimberg   return CEED_ERROR_SUCCESS;
1038506b1a0cSSebastian Grimberg }
1039506b1a0cSSebastian Grimberg 
1040506b1a0cSSebastian Grimberg /**
1041480fae85SJeremy L Thompson   @brief Create object holding CeedQFunction assembly data for CeedOperator
1042480fae85SJeremy L Thompson 
1043480fae85SJeremy L Thompson   @param[in]  ceed A Ceed object where the CeedQFunctionAssemblyData will be created
1044ea61e9acSJeremy L Thompson   @param[out] data Address of the variable where the newly created CeedQFunctionAssemblyData will be stored
1045480fae85SJeremy L Thompson 
1046480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1047480fae85SJeremy L Thompson 
1048480fae85SJeremy L Thompson   @ref Backend
1049480fae85SJeremy L Thompson **/
1050ea61e9acSJeremy L Thompson int CeedQFunctionAssemblyDataCreate(Ceed ceed, CeedQFunctionAssemblyData *data) {
10512b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
1052480fae85SJeremy L Thompson   (*data)->ref_count = 1;
1053480fae85SJeremy L Thompson   (*data)->ceed      = ceed;
10542b730f8bSJeremy L Thompson   CeedCall(CeedReference(ceed));
1055480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1056480fae85SJeremy L Thompson }
1057480fae85SJeremy L Thompson 
1058480fae85SJeremy L Thompson /**
1059480fae85SJeremy L Thompson   @brief Increment the reference counter for a CeedQFunctionAssemblyData
1060480fae85SJeremy L Thompson 
1061ea61e9acSJeremy L Thompson   @param[in,out] data CeedQFunctionAssemblyData to increment the reference counter
1062480fae85SJeremy L Thompson 
1063480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1064480fae85SJeremy L Thompson 
1065480fae85SJeremy L Thompson   @ref Backend
1066480fae85SJeremy L Thompson **/
1067480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataReference(CeedQFunctionAssemblyData data) {
1068480fae85SJeremy L Thompson   data->ref_count++;
1069480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1070480fae85SJeremy L Thompson }
1071480fae85SJeremy L Thompson 
1072480fae85SJeremy L Thompson /**
1073beecbf24SJeremy L Thompson   @brief Set re-use of CeedQFunctionAssemblyData
10748b919e6bSJeremy L Thompson 
1075ea61e9acSJeremy L Thompson   @param[in,out] data       CeedQFunctionAssemblyData to mark for reuse
1076ea61e9acSJeremy L Thompson   @param[in]     reuse_data Boolean flag indicating data re-use
10778b919e6bSJeremy L Thompson 
10788b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
10798b919e6bSJeremy L Thompson 
10808b919e6bSJeremy L Thompson   @ref Backend
10818b919e6bSJeremy L Thompson **/
10822b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetReuse(CeedQFunctionAssemblyData data, bool reuse_data) {
1083beecbf24SJeremy L Thompson   data->reuse_data        = reuse_data;
1084beecbf24SJeremy L Thompson   data->needs_data_update = true;
1085beecbf24SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1086beecbf24SJeremy L Thompson }
1087beecbf24SJeremy L Thompson 
1088beecbf24SJeremy L Thompson /**
1089beecbf24SJeremy L Thompson   @brief Mark QFunctionAssemblyData as stale
1090beecbf24SJeremy L Thompson 
1091ea61e9acSJeremy L Thompson   @param[in,out] data              CeedQFunctionAssemblyData to mark as stale
1092ea61e9acSJeremy L Thompson   @param[in]     needs_data_update Boolean flag indicating if update is needed or completed
1093beecbf24SJeremy L Thompson 
1094beecbf24SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1095beecbf24SJeremy L Thompson 
1096beecbf24SJeremy L Thompson   @ref Backend
1097beecbf24SJeremy L Thompson **/
10982b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetUpdateNeeded(CeedQFunctionAssemblyData data, bool needs_data_update) {
1099beecbf24SJeremy L Thompson   data->needs_data_update = needs_data_update;
11008b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
11018b919e6bSJeremy L Thompson }
11028b919e6bSJeremy L Thompson 
11038b919e6bSJeremy L Thompson /**
11048b919e6bSJeremy L Thompson   @brief Determine if QFunctionAssemblyData needs update
11058b919e6bSJeremy L Thompson 
11068b919e6bSJeremy L Thompson   @param[in]  data             CeedQFunctionAssemblyData to mark as stale
11078b919e6bSJeremy L Thompson   @param[out] is_update_needed Boolean flag indicating if re-assembly is required
11088b919e6bSJeremy L Thompson 
11098b919e6bSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
11108b919e6bSJeremy L Thompson 
11118b919e6bSJeremy L Thompson   @ref Backend
11128b919e6bSJeremy L Thompson **/
11132b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsUpdateNeeded(CeedQFunctionAssemblyData data, bool *is_update_needed) {
1114beecbf24SJeremy L Thompson   *is_update_needed = !data->reuse_data || data->needs_data_update;
11158b919e6bSJeremy L Thompson   return CEED_ERROR_SUCCESS;
11168b919e6bSJeremy L Thompson }
11178b919e6bSJeremy L Thompson 
11188b919e6bSJeremy L Thompson /**
1119ea61e9acSJeremy L Thompson   @brief Copy the pointer to a CeedQFunctionAssemblyData.
11204385fb7fSSebastian Grimberg 
1121ea61e9acSJeremy L Thompson   Both pointers should be destroyed with `CeedCeedQFunctionAssemblyDataDestroy()`.
1122512bb800SJeremy L Thompson 
1123512bb800SJeremy 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
1124512bb800SJeremy L Thompson         CeedQFunctionAssemblyData. This CeedQFunctionAssemblyData will be destroyed if `data_copy` is the only reference to this
1125512bb800SJeremy L Thompson         CeedQFunctionAssemblyData.
1126480fae85SJeremy L Thompson 
1127ea61e9acSJeremy L Thompson   @param[in]     data      CeedQFunctionAssemblyData to copy reference to
1128ea61e9acSJeremy L Thompson   @param[in,out] data_copy Variable to store copied reference
1129480fae85SJeremy L Thompson 
1130480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1131480fae85SJeremy L Thompson 
1132480fae85SJeremy L Thompson   @ref Backend
1133480fae85SJeremy L Thompson **/
11342b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataReferenceCopy(CeedQFunctionAssemblyData data, CeedQFunctionAssemblyData *data_copy) {
11352b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataReference(data));
11362b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAssemblyDataDestroy(data_copy));
1137480fae85SJeremy L Thompson   *data_copy = data;
1138480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1139480fae85SJeremy L Thompson }
1140480fae85SJeremy L Thompson 
1141480fae85SJeremy L Thompson /**
1142480fae85SJeremy L Thompson   @brief Get setup status for internal objects for CeedQFunctionAssemblyData
1143480fae85SJeremy L Thompson 
1144ea61e9acSJeremy L Thompson   @param[in]  data     CeedQFunctionAssemblyData to retrieve status
1145480fae85SJeremy L Thompson   @param[out] is_setup Boolean flag for setup status
1146480fae85SJeremy L Thompson 
1147480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1148480fae85SJeremy L Thompson 
1149480fae85SJeremy L Thompson   @ref Backend
1150480fae85SJeremy L Thompson **/
11512b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsSetup(CeedQFunctionAssemblyData data, bool *is_setup) {
1152480fae85SJeremy L Thompson   *is_setup = data->is_setup;
1153480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1154480fae85SJeremy L Thompson }
1155480fae85SJeremy L Thompson 
1156480fae85SJeremy L Thompson /**
1157480fae85SJeremy L Thompson   @brief Set internal objects for CeedQFunctionAssemblyData
1158480fae85SJeremy L Thompson 
1159ea61e9acSJeremy L Thompson   @param[in,out] data CeedQFunctionAssemblyData to set objects
1160480fae85SJeremy L Thompson   @param[in]     vec  CeedVector to store assembled CeedQFunction at quadrature points
1161480fae85SJeremy L Thompson   @param[in]     rstr CeedElemRestriction for CeedVector containing assembled CeedQFunction
1162480fae85SJeremy L Thompson 
1163480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1164480fae85SJeremy L Thompson 
1165480fae85SJeremy L Thompson   @ref Backend
1166480fae85SJeremy L Thompson **/
11672b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetObjects(CeedQFunctionAssemblyData data, CeedVector vec, CeedElemRestriction rstr) {
11682b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(vec, &data->vec));
11692b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(rstr, &data->rstr));
1170480fae85SJeremy L Thompson 
1171480fae85SJeremy L Thompson   data->is_setup = true;
1172480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1173480fae85SJeremy L Thompson }
1174480fae85SJeremy L Thompson 
11754dd1a9d2SSebastian Grimberg /**
11764dd1a9d2SSebastian Grimberg   @brief Get internal objects for CeedQFunctionAssemblyData
11774dd1a9d2SSebastian Grimberg 
11784dd1a9d2SSebastian Grimberg   @param[in,out] data CeedQFunctionAssemblyData to set objects
11794dd1a9d2SSebastian Grimberg   @param[out]    vec  CeedVector to store assembled CeedQFunction at quadrature points
11804dd1a9d2SSebastian Grimberg   @param[out]    rstr CeedElemRestriction for CeedVector containing assembled CeedQFunction
11814dd1a9d2SSebastian Grimberg 
11824dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
11834dd1a9d2SSebastian Grimberg 
11844dd1a9d2SSebastian Grimberg   @ref Backend
11854dd1a9d2SSebastian Grimberg **/
11862b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataGetObjects(CeedQFunctionAssemblyData data, CeedVector *vec, CeedElemRestriction *rstr) {
11876574a04fSJeremy L Thompson   CeedCheck(data->is_setup, data->ceed, CEED_ERROR_INCOMPLETE, "Internal objects not set; must call CeedQFunctionAssemblyDataSetObjects first.");
1188480fae85SJeremy L Thompson 
11892b730f8bSJeremy L Thompson   CeedCall(CeedVectorReferenceCopy(data->vec, vec));
11902b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionReferenceCopy(data->rstr, rstr));
1191480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1192480fae85SJeremy L Thompson }
1193480fae85SJeremy L Thompson 
1194480fae85SJeremy L Thompson /**
1195480fae85SJeremy L Thompson   @brief Destroy CeedQFunctionAssemblyData
1196480fae85SJeremy L Thompson 
1197ea61e9acSJeremy L Thompson   @param[in,out] data  CeedQFunctionAssemblyData to destroy
1198480fae85SJeremy L Thompson 
1199480fae85SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1200480fae85SJeremy L Thompson 
1201480fae85SJeremy L Thompson   @ref Backend
1202480fae85SJeremy L Thompson **/
1203480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataDestroy(CeedQFunctionAssemblyData *data) {
1204ad6481ceSJeremy L Thompson   if (!*data || --(*data)->ref_count > 0) {
1205ad6481ceSJeremy L Thompson     *data = NULL;
1206ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1207ad6481ceSJeremy L Thompson   }
12082b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
12092b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&(*data)->vec));
12102b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&(*data)->rstr));
1211480fae85SJeremy L Thompson 
12122b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1213480fae85SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1214480fae85SJeremy L Thompson }
1215480fae85SJeremy L Thompson 
1216ed9e99e6SJeremy L Thompson /**
1217ed9e99e6SJeremy L Thompson   @brief Get CeedOperatorAssemblyData
1218ed9e99e6SJeremy L Thompson 
1219ed9e99e6SJeremy L Thompson   @param[in]  op   CeedOperator to assemble
1220ed9e99e6SJeremy L Thompson   @param[out] data CeedQFunctionAssemblyData
1221ed9e99e6SJeremy L Thompson 
1222ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1223ed9e99e6SJeremy L Thompson 
1224ed9e99e6SJeremy L Thompson   @ref Backend
1225ed9e99e6SJeremy L Thompson **/
12262b730f8bSJeremy L Thompson int CeedOperatorGetOperatorAssemblyData(CeedOperator op, CeedOperatorAssemblyData *data) {
1227ed9e99e6SJeremy L Thompson   if (!op->op_assembled) {
1228ed9e99e6SJeremy L Thompson     CeedOperatorAssemblyData data;
1229ed9e99e6SJeremy L Thompson 
12302b730f8bSJeremy L Thompson     CeedCall(CeedOperatorAssemblyDataCreate(op->ceed, op, &data));
1231ed9e99e6SJeremy L Thompson     op->op_assembled = data;
1232ed9e99e6SJeremy L Thompson   }
1233ed9e99e6SJeremy L Thompson   *data = op->op_assembled;
1234ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1235ed9e99e6SJeremy L Thompson }
1236ed9e99e6SJeremy L Thompson 
1237ed9e99e6SJeremy L Thompson /**
1238ba746a46SJeremy L Thompson   @brief Create object holding CeedOperator assembly data.
1239ba746a46SJeremy L Thompson 
1240ba746a46SJeremy L Thompson   The CeedOperatorAssemblyData holds an array with references to every active CeedBasis used in the CeedOperator.
1241ba746a46SJeremy L Thompson   An array with references to the corresponding active CeedElemRestrictions is also stored.
1242ba746a46SJeremy L Thompson   For each active CeedBasis, the CeedOperatorAssemblyData holds an array of all input and output CeedEvalModes for this CeedBasis.
1243ba746a46SJeremy L Thompson   The CeedOperatorAssemblyData holds an array of offsets for indexing into the assembled CeedQFunction arrays to the row representing each
1244ba746a46SJeremy L Thompson CeedEvalMode.
1245ba746a46SJeremy L Thompson   The number of input columns across all active bases for the assembled CeedQFunction is also stored.
1246ba746a46SJeremy L Thompson   Lastly, the CeedOperatorAssembly data holds assembled matrices representing the full action of the CeedBasis for all CeedEvalModes.
1247ed9e99e6SJeremy L Thompson 
1248ea61e9acSJeremy L Thompson   @param[in]  ceed Ceed object where the CeedOperatorAssemblyData will be created
1249ed9e99e6SJeremy L Thompson   @param[in]  op   CeedOperator to be assembled
1250ea61e9acSJeremy L Thompson   @param[out] data Address of the variable where the newly created CeedOperatorAssemblyData will be stored
1251ed9e99e6SJeremy L Thompson 
1252ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1253ed9e99e6SJeremy L Thompson 
1254ed9e99e6SJeremy L Thompson   @ref Backend
1255ed9e99e6SJeremy L Thompson **/
12562b730f8bSJeremy L Thompson int CeedOperatorAssemblyDataCreate(Ceed ceed, CeedOperator op, CeedOperatorAssemblyData *data) {
1257506b1a0cSSebastian Grimberg   CeedInt             num_active_bases_in = 0, num_active_bases_out = 0, offset = 0;
1258506b1a0cSSebastian Grimberg   CeedInt             num_input_fields, *num_eval_modes_in = NULL, num_output_fields, *num_eval_modes_out = NULL;
12591c66c397SJeremy L Thompson   CeedSize          **eval_mode_offsets_in = NULL, **eval_mode_offsets_out = NULL;
12601c66c397SJeremy L Thompson   CeedEvalMode      **eval_modes_in = NULL, **eval_modes_out = NULL;
12611c66c397SJeremy L Thompson   CeedQFunctionField *qf_fields;
12621c66c397SJeremy L Thompson   CeedQFunction       qf;
12631c66c397SJeremy L Thompson   CeedOperatorField  *op_fields;
126401f0e615SJames Wright   bool                is_composite;
126501f0e615SJames Wright 
126601f0e615SJames Wright   CeedCall(CeedOperatorIsComposite(op, &is_composite));
126701f0e615SJames Wright   CeedCheck(!is_composite, ceed, CEED_ERROR_INCOMPATIBLE, "Can only create CeedOperator assembly data for non-composite operators.");
1268437c7c90SJeremy L Thompson 
1269437c7c90SJeremy L Thompson   // Allocate
12702b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(1, data));
1271ed9e99e6SJeremy L Thompson   (*data)->ceed = ceed;
12722b730f8bSJeremy L Thompson   CeedCall(CeedReference(ceed));
1273ed9e99e6SJeremy L Thompson 
1274ed9e99e6SJeremy L Thompson   // Build OperatorAssembly data
12752b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
12762b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &qf_fields, NULL, NULL));
12772b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL));
1278ed9e99e6SJeremy L Thompson 
1279ed9e99e6SJeremy L Thompson   // Determine active input basis
1280ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
1281ed9e99e6SJeremy L Thompson     CeedVector vec;
12821c66c397SJeremy L Thompson 
12832b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1284ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
12857c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
12861c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
12871c66c397SJeremy L Thompson       CeedBasis    basis_in = NULL;
12881c66c397SJeremy L Thompson 
12892b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_in));
12902b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1291352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_in, &num_comp));
1292352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_in, eval_mode, &q_comp));
1293506b1a0cSSebastian Grimberg       for (CeedInt i = 0; i < num_active_bases_in; i++) {
1294506b1a0cSSebastian Grimberg         if ((*data)->active_bases_in[i] == basis_in) index = i;
1295437c7c90SJeremy L Thompson       }
1296437c7c90SJeremy L Thompson       if (index == -1) {
1297437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_in;
12981c66c397SJeremy L Thompson 
1299506b1a0cSSebastian Grimberg         index = num_active_bases_in;
1300506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_bases_in));
1301506b1a0cSSebastian Grimberg         (*data)->active_bases_in[num_active_bases_in] = NULL;
1302506b1a0cSSebastian Grimberg         CeedCall(CeedBasisReferenceCopy(basis_in, &(*data)->active_bases_in[num_active_bases_in]));
1303506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_elem_rstrs_in));
1304506b1a0cSSebastian Grimberg         (*data)->active_elem_rstrs_in[num_active_bases_in] = NULL;
1305437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_in));
1306506b1a0cSSebastian Grimberg         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_in, &(*data)->active_elem_rstrs_in[num_active_bases_in]));
1307506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &num_eval_modes_in));
1308437c7c90SJeremy L Thompson         num_eval_modes_in[index] = 0;
1309506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_modes_in));
1310437c7c90SJeremy L Thompson         eval_modes_in[index] = NULL;
1311506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_mode_offsets_in));
1312437c7c90SJeremy L Thompson         eval_mode_offsets_in[index] = NULL;
1313506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->assembled_bases_in));
1314437c7c90SJeremy L Thompson         (*data)->assembled_bases_in[index] = NULL;
1315506b1a0cSSebastian Grimberg         num_active_bases_in++;
1316437c7c90SJeremy L Thompson       }
1317352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1318352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1319352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_modes_in[index]));
1320352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_mode_offsets_in[index]));
1321352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1322437c7c90SJeremy L Thompson           eval_modes_in[index][num_eval_modes_in[index] + d]        = eval_mode;
1323437c7c90SJeremy L Thompson           eval_mode_offsets_in[index][num_eval_modes_in[index] + d] = offset;
1324352a5e7cSSebastian Grimberg           offset += num_comp;
1325ed9e99e6SJeremy L Thompson         }
1326352a5e7cSSebastian Grimberg         num_eval_modes_in[index] += q_comp;
1327ed9e99e6SJeremy L Thompson       }
1328ed9e99e6SJeremy L Thompson     }
1329ed9e99e6SJeremy L Thompson   }
1330ed9e99e6SJeremy L Thompson 
1331ed9e99e6SJeremy L Thompson   // Determine active output basis
13322b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, NULL, &num_output_fields, &qf_fields));
13332b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields));
1334437c7c90SJeremy L Thompson   offset = 0;
1335ed9e99e6SJeremy L Thompson   for (CeedInt i = 0; i < num_output_fields; i++) {
1336ed9e99e6SJeremy L Thompson     CeedVector vec;
13371c66c397SJeremy L Thompson 
13382b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
1339ed9e99e6SJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
13407c1dbaffSSebastian Grimberg       CeedInt      index = -1, num_comp, q_comp;
13411c66c397SJeremy L Thompson       CeedEvalMode eval_mode;
13421c66c397SJeremy L Thompson       CeedBasis    basis_out = NULL;
13431c66c397SJeremy L Thompson 
1344437c7c90SJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_out));
13452b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
1346352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumComponents(basis_out, &num_comp));
1347352a5e7cSSebastian Grimberg       CeedCall(CeedBasisGetNumQuadratureComponents(basis_out, eval_mode, &q_comp));
1348506b1a0cSSebastian Grimberg       for (CeedInt i = 0; i < num_active_bases_out; i++) {
1349506b1a0cSSebastian Grimberg         if ((*data)->active_bases_out[i] == basis_out) index = i;
1350437c7c90SJeremy L Thompson       }
1351437c7c90SJeremy L Thompson       if (index == -1) {
1352437c7c90SJeremy L Thompson         CeedElemRestriction elem_rstr_out;
13531c66c397SJeremy L Thompson 
1354506b1a0cSSebastian Grimberg         index = num_active_bases_out;
1355506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_bases_out));
1356506b1a0cSSebastian Grimberg         (*data)->active_bases_out[num_active_bases_out] = NULL;
1357506b1a0cSSebastian Grimberg         CeedCall(CeedBasisReferenceCopy(basis_out, &(*data)->active_bases_out[num_active_bases_out]));
1358506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_elem_rstrs_out));
1359506b1a0cSSebastian Grimberg         (*data)->active_elem_rstrs_out[num_active_bases_out] = NULL;
1360437c7c90SJeremy L Thompson         CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_out));
1361506b1a0cSSebastian Grimberg         CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_out, &(*data)->active_elem_rstrs_out[num_active_bases_out]));
1362506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &num_eval_modes_out));
1363437c7c90SJeremy L Thompson         num_eval_modes_out[index] = 0;
1364506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_modes_out));
1365437c7c90SJeremy L Thompson         eval_modes_out[index] = NULL;
1366506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_mode_offsets_out));
1367437c7c90SJeremy L Thompson         eval_mode_offsets_out[index] = NULL;
1368506b1a0cSSebastian Grimberg         CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->assembled_bases_out));
1369437c7c90SJeremy L Thompson         (*data)->assembled_bases_out[index] = NULL;
1370506b1a0cSSebastian Grimberg         num_active_bases_out++;
1371437c7c90SJeremy L Thompson       }
1372352a5e7cSSebastian Grimberg       if (eval_mode != CEED_EVAL_WEIGHT) {
1373352a5e7cSSebastian Grimberg         // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly
1374352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_modes_out[index]));
1375352a5e7cSSebastian Grimberg         CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_mode_offsets_out[index]));
1376352a5e7cSSebastian Grimberg         for (CeedInt d = 0; d < q_comp; d++) {
1377437c7c90SJeremy L Thompson           eval_modes_out[index][num_eval_modes_out[index] + d]        = eval_mode;
1378437c7c90SJeremy L Thompson           eval_mode_offsets_out[index][num_eval_modes_out[index] + d] = offset;
1379352a5e7cSSebastian Grimberg           offset += num_comp;
1380ed9e99e6SJeremy L Thompson         }
1381352a5e7cSSebastian Grimberg         num_eval_modes_out[index] += q_comp;
1382ed9e99e6SJeremy L Thompson       }
1383ed9e99e6SJeremy L Thompson     }
1384ed9e99e6SJeremy L Thompson   }
1385506b1a0cSSebastian Grimberg   (*data)->num_active_bases_in   = num_active_bases_in;
138627789c4aSJed Brown   (*data)->num_eval_modes_in     = num_eval_modes_in;
138727789c4aSJed Brown   (*data)->eval_modes_in         = eval_modes_in;
138827789c4aSJed Brown   (*data)->eval_mode_offsets_in  = eval_mode_offsets_in;
1389506b1a0cSSebastian Grimberg   (*data)->num_active_bases_out  = num_active_bases_out;
1390437c7c90SJeremy L Thompson   (*data)->num_eval_modes_out    = num_eval_modes_out;
1391437c7c90SJeremy L Thompson   (*data)->eval_modes_out        = eval_modes_out;
1392437c7c90SJeremy L Thompson   (*data)->eval_mode_offsets_out = eval_mode_offsets_out;
1393506b1a0cSSebastian Grimberg   (*data)->num_output_components = offset;
1394ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1395ed9e99e6SJeremy L Thompson }
1396ed9e99e6SJeremy L Thompson 
1397ed9e99e6SJeremy L Thompson /**
1398ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedEvalModes for assembly.
1399ba746a46SJeremy L Thompson 
1400ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1401ed9e99e6SJeremy L Thompson 
1402ed9e99e6SJeremy L Thompson   @param[in]  data                  CeedOperatorAssemblyData
1403506b1a0cSSebastian Grimberg   @param[out] num_active_bases_in   Total number of active bases for input
1404c5d0f995SJed Brown   @param[out] num_eval_modes_in     Pointer to hold array of numbers of input CeedEvalModes, or NULL.
1405ba746a46SJeremy L Thompson                                       `eval_modes_in[0]` holds an array of eval modes for the first active basis.
1406c5d0f995SJed Brown   @param[out] eval_modes_in         Pointer to hold arrays of input CeedEvalModes, or NULL.
1407ba746a46SJeremy L Thompson   @param[out] eval_mode_offsets_in  Pointer to hold arrays of input offsets at each quadrature point.
1408506b1a0cSSebastian Grimberg   @param[out] num_active_bases_out  Total number of active bases for output
1409c5d0f995SJed Brown   @param[out] num_eval_modes_out    Pointer to hold array of numbers of output CeedEvalModes, or NULL
1410c5d0f995SJed Brown   @param[out] eval_modes_out        Pointer to hold arrays of output CeedEvalModes, or NULL.
1411437c7c90SJeremy L Thompson   @param[out] eval_mode_offsets_out Pointer to hold arrays of output offsets at each quadrature point
1412ba746a46SJeremy L Thompson   @param[out] num_output_components The number of columns in the assembled CeedQFunction matrix for each quadrature point,
1413ba746a46SJeremy L Thompson                                       including contributions of all active bases
1414ed9e99e6SJeremy L Thompson 
1415ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1416ed9e99e6SJeremy L Thompson 
1417ed9e99e6SJeremy L Thompson   @ref Backend
1418ed9e99e6SJeremy L Thompson **/
1419506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetEvalModes(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedInt **num_eval_modes_in,
1420506b1a0cSSebastian Grimberg                                          const CeedEvalMode ***eval_modes_in, CeedSize ***eval_mode_offsets_in, CeedInt *num_active_bases_out,
1421506b1a0cSSebastian Grimberg                                          CeedInt **num_eval_modes_out, const CeedEvalMode ***eval_modes_out, CeedSize ***eval_mode_offsets_out,
1422506b1a0cSSebastian Grimberg                                          CeedSize *num_output_components) {
1423506b1a0cSSebastian Grimberg   if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in;
1424437c7c90SJeremy L Thompson   if (num_eval_modes_in) *num_eval_modes_in = data->num_eval_modes_in;
1425437c7c90SJeremy L Thompson   if (eval_modes_in) *eval_modes_in = (const CeedEvalMode **)data->eval_modes_in;
1426437c7c90SJeremy L Thompson   if (eval_mode_offsets_in) *eval_mode_offsets_in = data->eval_mode_offsets_in;
1427506b1a0cSSebastian Grimberg   if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out;
1428437c7c90SJeremy L Thompson   if (num_eval_modes_out) *num_eval_modes_out = data->num_eval_modes_out;
1429437c7c90SJeremy L Thompson   if (eval_modes_out) *eval_modes_out = (const CeedEvalMode **)data->eval_modes_out;
1430437c7c90SJeremy L Thompson   if (eval_mode_offsets_out) *eval_mode_offsets_out = data->eval_mode_offsets_out;
1431437c7c90SJeremy L Thompson   if (num_output_components) *num_output_components = data->num_output_components;
1432ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1433ed9e99e6SJeremy L Thompson }
1434ed9e99e6SJeremy L Thompson 
1435ed9e99e6SJeremy L Thompson /**
1436ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedBasis data for assembly.
1437ba746a46SJeremy L Thompson 
1438ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1439ed9e99e6SJeremy L Thompson 
1440ed9e99e6SJeremy L Thompson   @param[in]  data                 CeedOperatorAssemblyData
1441506b1a0cSSebastian Grimberg   @param[out] num_active_bases_in  Number of active input bases, or NULL
1442506b1a0cSSebastian Grimberg   @param[out] active_bases_in      Pointer to hold active input CeedBasis, or NULL
1443437c7c90SJeremy L Thompson   @param[out] assembled_bases_in   Pointer to hold assembled active input B, or NULL
1444506b1a0cSSebastian Grimberg   @param[out] num_active_bases_out Number of active output bases, or NULL
1445506b1a0cSSebastian Grimberg   @param[out] active_bases_out     Pointer to hold active output CeedBasis, or NULL
1446437c7c90SJeremy L Thompson   @param[out] assembled_bases_out  Pointer to hold assembled active output B, or NULL
1447ed9e99e6SJeremy L Thompson 
1448ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1449ed9e99e6SJeremy L Thompson 
1450ed9e99e6SJeremy L Thompson   @ref Backend
1451ed9e99e6SJeremy L Thompson **/
1452506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetBases(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedBasis **active_bases_in,
1453506b1a0cSSebastian Grimberg                                      const CeedScalar ***assembled_bases_in, CeedInt *num_active_bases_out, CeedBasis **active_bases_out,
1454506b1a0cSSebastian Grimberg                                      const CeedScalar ***assembled_bases_out) {
1455ed9e99e6SJeremy L Thompson   // Assemble B_in, B_out if needed
1456437c7c90SJeremy L Thompson   if (assembled_bases_in && !data->assembled_bases_in[0]) {
1457437c7c90SJeremy L Thompson     CeedInt num_qpts;
1458437c7c90SJeremy L Thompson 
1459506b1a0cSSebastian Grimberg     if (data->active_bases_in[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[0], &num_qpts));
1460506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_in[0], &num_qpts));
1461506b1a0cSSebastian Grimberg     for (CeedInt b = 0; b < data->num_active_bases_in; b++) {
14621c66c397SJeremy L Thompson       bool        has_eval_none = false;
1463352a5e7cSSebastian Grimberg       CeedInt     num_nodes;
1464437c7c90SJeremy L Thompson       CeedScalar *B_in = NULL, *identity = NULL;
1465ed9e99e6SJeremy L Thompson 
1466506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[b], &num_nodes));
1467352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_in[b], &B_in));
1468ed9e99e6SJeremy L Thompson 
1469437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_in[b]; i++) {
1470437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_in[b][i] == CEED_EVAL_NONE);
1471ed9e99e6SJeremy L Thompson       }
1472ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1473352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1474352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1475352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1476ed9e99e6SJeremy L Thompson         }
1477ed9e99e6SJeremy L Thompson       }
1478ed9e99e6SJeremy L Thompson 
1479ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1480352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1481352a5e7cSSebastian Grimberg           CeedInt      d_in              = 0, q_comp_in;
1482352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE;
14831c66c397SJeremy L Thompson 
1484437c7c90SJeremy L Thompson           for (CeedInt e_in = 0; e_in < data->num_eval_modes_in[b]; e_in++) {
1485437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_in[b] * q;
1486437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
14871c66c397SJeremy L Thompson 
1488506b1a0cSSebastian Grimberg             CeedCall(CeedOperatorGetBasisPointer(data->active_bases_in[b], data->eval_modes_in[b][e_in], identity, &B));
1489506b1a0cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_in[b], data->eval_modes_in[b][e_in], &q_comp_in));
1490352a5e7cSSebastian Grimberg             if (q_comp_in > 1) {
1491352a5e7cSSebastian Grimberg               if (e_in == 0 || data->eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0;
1492352a5e7cSSebastian Grimberg               else B = &B[(++d_in) * num_qpts * num_nodes];
1493352a5e7cSSebastian Grimberg             }
1494352a5e7cSSebastian Grimberg             eval_mode_in_prev                 = data->eval_modes_in[b][e_in];
1495352a5e7cSSebastian Grimberg             B_in[(qq + e_in) * num_nodes + n] = B[q * num_nodes + n];
1496ed9e99e6SJeremy L Thompson           }
1497ed9e99e6SJeremy L Thompson         }
1498ed9e99e6SJeremy L Thompson       }
14997c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1500437c7c90SJeremy L Thompson       data->assembled_bases_in[b] = B_in;
1501437c7c90SJeremy L Thompson     }
1502ed9e99e6SJeremy L Thompson   }
1503ed9e99e6SJeremy L Thompson 
1504437c7c90SJeremy L Thompson   if (assembled_bases_out && !data->assembled_bases_out[0]) {
1505437c7c90SJeremy L Thompson     CeedInt num_qpts;
1506437c7c90SJeremy L Thompson 
1507506b1a0cSSebastian Grimberg     if (data->active_bases_out[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[0], &num_qpts));
1508506b1a0cSSebastian Grimberg     else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_out[0], &num_qpts));
1509506b1a0cSSebastian Grimberg     for (CeedInt b = 0; b < data->num_active_bases_out; b++) {
1510ed9e99e6SJeremy L Thompson       bool        has_eval_none = false;
15111c66c397SJeremy L Thompson       CeedInt     num_nodes;
1512437c7c90SJeremy L Thompson       CeedScalar *B_out = NULL, *identity = NULL;
1513ed9e99e6SJeremy L Thompson 
1514506b1a0cSSebastian Grimberg       CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[b], &num_nodes));
1515352a5e7cSSebastian Grimberg       CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_out[b], &B_out));
1516ed9e99e6SJeremy L Thompson 
1517437c7c90SJeremy L Thompson       for (CeedInt i = 0; i < data->num_eval_modes_out[b]; i++) {
1518437c7c90SJeremy L Thompson         has_eval_none = has_eval_none || (data->eval_modes_out[b][i] == CEED_EVAL_NONE);
1519ed9e99e6SJeremy L Thompson       }
1520ed9e99e6SJeremy L Thompson       if (has_eval_none) {
1521352a5e7cSSebastian Grimberg         CeedCall(CeedCalloc(num_qpts * num_nodes, &identity));
1522352a5e7cSSebastian Grimberg         for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) {
1523352a5e7cSSebastian Grimberg           identity[i * num_nodes + i] = 1.0;
1524ed9e99e6SJeremy L Thompson         }
1525ed9e99e6SJeremy L Thompson       }
1526ed9e99e6SJeremy L Thompson 
1527ed9e99e6SJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
1528352a5e7cSSebastian Grimberg         for (CeedInt n = 0; n < num_nodes; n++) {
1529352a5e7cSSebastian Grimberg           CeedInt      d_out              = 0, q_comp_out;
1530352a5e7cSSebastian Grimberg           CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE;
15311c66c397SJeremy L Thompson 
1532437c7c90SJeremy L Thompson           for (CeedInt e_out = 0; e_out < data->num_eval_modes_out[b]; e_out++) {
1533437c7c90SJeremy L Thompson             const CeedInt     qq = data->num_eval_modes_out[b] * q;
1534437c7c90SJeremy L Thompson             const CeedScalar *B  = NULL;
15351c66c397SJeremy L Thompson 
1536506b1a0cSSebastian Grimberg             CeedCall(CeedOperatorGetBasisPointer(data->active_bases_out[b], data->eval_modes_out[b][e_out], identity, &B));
1537506b1a0cSSebastian Grimberg             CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_out[b], data->eval_modes_out[b][e_out], &q_comp_out));
1538352a5e7cSSebastian Grimberg             if (q_comp_out > 1) {
1539352a5e7cSSebastian Grimberg               if (e_out == 0 || data->eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0;
1540352a5e7cSSebastian Grimberg               else B = &B[(++d_out) * num_qpts * num_nodes];
1541352a5e7cSSebastian Grimberg             }
1542352a5e7cSSebastian Grimberg             eval_mode_out_prev                  = data->eval_modes_out[b][e_out];
1543352a5e7cSSebastian Grimberg             B_out[(qq + e_out) * num_nodes + n] = B[q * num_nodes + n];
1544ed9e99e6SJeremy L Thompson           }
1545ed9e99e6SJeremy L Thompson         }
1546ed9e99e6SJeremy L Thompson       }
15477c1dbaffSSebastian Grimberg       if (identity) CeedCall(CeedFree(&identity));
1548437c7c90SJeremy L Thompson       data->assembled_bases_out[b] = B_out;
1549437c7c90SJeremy L Thompson     }
1550ed9e99e6SJeremy L Thompson   }
1551ed9e99e6SJeremy L Thompson 
1552437c7c90SJeremy L Thompson   // Pass out assembled data
1553506b1a0cSSebastian Grimberg   if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in;
1554506b1a0cSSebastian Grimberg   if (active_bases_in) *active_bases_in = data->active_bases_in;
1555437c7c90SJeremy L Thompson   if (assembled_bases_in) *assembled_bases_in = (const CeedScalar **)data->assembled_bases_in;
1556506b1a0cSSebastian Grimberg   if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out;
1557506b1a0cSSebastian Grimberg   if (active_bases_out) *active_bases_out = data->active_bases_out;
1558437c7c90SJeremy L Thompson   if (assembled_bases_out) *assembled_bases_out = (const CeedScalar **)data->assembled_bases_out;
1559437c7c90SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1560437c7c90SJeremy L Thompson }
1561437c7c90SJeremy L Thompson 
1562437c7c90SJeremy L Thompson /**
1563ba746a46SJeremy L Thompson   @brief Get CeedOperator CeedBasis data for assembly.
1564ba746a46SJeremy L Thompson 
1565ba746a46SJeremy L Thompson   Note: See CeedOperatorAssemblyDataCreate for a full description of the data stored in this object.
1566437c7c90SJeremy L Thompson 
1567437c7c90SJeremy L Thompson   @param[in]  data                      CeedOperatorAssemblyData
1568506b1a0cSSebastian Grimberg   @param[out] num_active_elem_rstrs_in  Number of active input element restrictions, or NULL
1569506b1a0cSSebastian Grimberg   @param[out] active_elem_rstrs_in      Pointer to hold active input CeedElemRestrictions, or NULL
1570506b1a0cSSebastian Grimberg   @param[out] num_active_elem_rstrs_out Number of active output element restrictions, or NULL
1571506b1a0cSSebastian Grimberg   @param[out] active_elem_rstrs_out     Pointer to hold active output CeedElemRestrictions, or NULL
1572437c7c90SJeremy L Thompson 
1573437c7c90SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1574437c7c90SJeremy L Thompson 
1575437c7c90SJeremy L Thompson   @ref Backend
1576437c7c90SJeremy L Thompson **/
1577506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetElemRestrictions(CeedOperatorAssemblyData data, CeedInt *num_active_elem_rstrs_in,
1578506b1a0cSSebastian Grimberg                                                 CeedElemRestriction **active_elem_rstrs_in, CeedInt *num_active_elem_rstrs_out,
1579506b1a0cSSebastian Grimberg                                                 CeedElemRestriction **active_elem_rstrs_out) {
1580506b1a0cSSebastian Grimberg   if (num_active_elem_rstrs_in) *num_active_elem_rstrs_in = data->num_active_bases_in;
1581506b1a0cSSebastian Grimberg   if (active_elem_rstrs_in) *active_elem_rstrs_in = data->active_elem_rstrs_in;
1582506b1a0cSSebastian Grimberg   if (num_active_elem_rstrs_out) *num_active_elem_rstrs_out = data->num_active_bases_out;
1583506b1a0cSSebastian Grimberg   if (active_elem_rstrs_out) *active_elem_rstrs_out = data->active_elem_rstrs_out;
1584ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1585ed9e99e6SJeremy L Thompson }
1586ed9e99e6SJeremy L Thompson 
1587ed9e99e6SJeremy L Thompson /**
1588ed9e99e6SJeremy L Thompson   @brief Destroy CeedOperatorAssemblyData
1589ed9e99e6SJeremy L Thompson 
1590ea61e9acSJeremy L Thompson   @param[in,out] data CeedOperatorAssemblyData to destroy
1591ed9e99e6SJeremy L Thompson 
1592ed9e99e6SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1593ed9e99e6SJeremy L Thompson 
1594ed9e99e6SJeremy L Thompson   @ref Backend
1595ed9e99e6SJeremy L Thompson **/
1596ed9e99e6SJeremy L Thompson int CeedOperatorAssemblyDataDestroy(CeedOperatorAssemblyData *data) {
1597ad6481ceSJeremy L Thompson   if (!*data) {
1598ad6481ceSJeremy L Thompson     *data = NULL;
1599ad6481ceSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1600ad6481ceSJeremy L Thompson   }
16012b730f8bSJeremy L Thompson   CeedCall(CeedDestroy(&(*data)->ceed));
1602506b1a0cSSebastian Grimberg   for (CeedInt b = 0; b < (*data)->num_active_bases_in; b++) {
1603506b1a0cSSebastian Grimberg     CeedCall(CeedBasisDestroy(&(*data)->active_bases_in[b]));
1604506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_in[b]));
1605437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_modes_in[b]));
1606437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->eval_mode_offsets_in[b]));
1607437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_in[b]));
1608506b1a0cSSebastian Grimberg   }
1609506b1a0cSSebastian Grimberg   for (CeedInt b = 0; b < (*data)->num_active_bases_out; b++) {
1610506b1a0cSSebastian Grimberg     CeedCall(CeedBasisDestroy(&(*data)->active_bases_out[b]));
1611506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_out[b]));
1612506b1a0cSSebastian Grimberg     CeedCall(CeedFree(&(*data)->eval_modes_out[b]));
1613506b1a0cSSebastian Grimberg     CeedCall(CeedFree(&(*data)->eval_mode_offsets_out[b]));
1614437c7c90SJeremy L Thompson     CeedCall(CeedFree(&(*data)->assembled_bases_out[b]));
1615437c7c90SJeremy L Thompson   }
1616506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_bases_in));
1617506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_bases_out));
1618506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_elem_rstrs_in));
1619506b1a0cSSebastian Grimberg   CeedCall(CeedFree(&(*data)->active_elem_rstrs_out));
1620437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_in));
1621437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->num_eval_modes_out));
1622437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_in));
1623437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_modes_out));
1624437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_in));
1625437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->eval_mode_offsets_out));
1626437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_in));
1627437c7c90SJeremy L Thompson   CeedCall(CeedFree(&(*data)->assembled_bases_out));
1628ed9e99e6SJeremy L Thompson 
16292b730f8bSJeremy L Thompson   CeedCall(CeedFree(data));
1630ed9e99e6SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1631ed9e99e6SJeremy L Thompson }
1632ed9e99e6SJeremy L Thompson 
16334dd1a9d2SSebastian Grimberg /**
16344dd1a9d2SSebastian Grimberg   @brief Retrieve fallback CeedOperator with a reference Ceed for advanced CeedOperator functionality
16354dd1a9d2SSebastian Grimberg 
16364dd1a9d2SSebastian Grimberg   @param[in]  op          CeedOperator to retrieve fallback for
16374dd1a9d2SSebastian Grimberg   @param[out] op_fallback Fallback CeedOperator
16384dd1a9d2SSebastian Grimberg 
16394dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
16404dd1a9d2SSebastian Grimberg 
16414dd1a9d2SSebastian Grimberg   @ref Backend
16424dd1a9d2SSebastian Grimberg **/
16434dd1a9d2SSebastian Grimberg int CeedOperatorGetFallback(CeedOperator op, CeedOperator *op_fallback) {
16444dd1a9d2SSebastian Grimberg   // Create if needed
16454dd1a9d2SSebastian Grimberg   if (!op->op_fallback) CeedCall(CeedOperatorCreateFallback(op));
16464dd1a9d2SSebastian Grimberg   if (op->op_fallback) {
16474dd1a9d2SSebastian Grimberg     bool is_debug;
16484dd1a9d2SSebastian Grimberg 
16494dd1a9d2SSebastian Grimberg     CeedCall(CeedIsDebug(op->ceed, &is_debug));
16504dd1a9d2SSebastian Grimberg     if (is_debug) {
16514dd1a9d2SSebastian Grimberg       Ceed        ceed, ceed_fallback;
16524dd1a9d2SSebastian Grimberg       const char *resource, *resource_fallback;
16534dd1a9d2SSebastian Grimberg 
16544dd1a9d2SSebastian Grimberg       CeedCall(CeedOperatorGetCeed(op, &ceed));
16554dd1a9d2SSebastian Grimberg       CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback));
16564dd1a9d2SSebastian Grimberg       CeedCall(CeedGetResource(ceed, &resource));
16574dd1a9d2SSebastian Grimberg       CeedCall(CeedGetResource(ceed_fallback, &resource_fallback));
16584dd1a9d2SSebastian Grimberg 
16594dd1a9d2SSebastian Grimberg       CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "---------- CeedOperator Fallback ----------\n");
16604dd1a9d2SSebastian Grimberg       CeedDebug(ceed, "Falling back from %s operator at address %ld to %s operator at address %ld\n", resource, op, resource_fallback,
16614dd1a9d2SSebastian Grimberg                 op->op_fallback);
16624dd1a9d2SSebastian Grimberg     }
16634dd1a9d2SSebastian Grimberg   }
16644dd1a9d2SSebastian Grimberg   *op_fallback = op->op_fallback;
16654dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
16664dd1a9d2SSebastian Grimberg }
16674dd1a9d2SSebastian Grimberg 
16684dd1a9d2SSebastian Grimberg /**
16694dd1a9d2SSebastian Grimberg   @brief Get the parent CeedOperator for a fallback CeedOperator
16704dd1a9d2SSebastian Grimberg 
16714dd1a9d2SSebastian Grimberg   @param[in]  op     CeedOperator context
16724dd1a9d2SSebastian Grimberg   @param[out] parent Variable to store parent CeedOperator context
16734dd1a9d2SSebastian Grimberg 
16744dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
16754dd1a9d2SSebastian Grimberg 
16764dd1a9d2SSebastian Grimberg   @ref Backend
16774dd1a9d2SSebastian Grimberg **/
16784dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParent(CeedOperator op, CeedOperator *parent) {
16794dd1a9d2SSebastian Grimberg   *parent = op->op_fallback_parent ? op->op_fallback_parent : NULL;
16804dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
16814dd1a9d2SSebastian Grimberg }
16824dd1a9d2SSebastian Grimberg 
16834dd1a9d2SSebastian Grimberg /**
16844dd1a9d2SSebastian Grimberg   @brief Get the Ceed context of the parent CeedOperator for a fallback CeedOperator
16854dd1a9d2SSebastian Grimberg 
16864dd1a9d2SSebastian Grimberg   @param[in]  op     CeedOperator context
16874dd1a9d2SSebastian Grimberg   @param[out] parent Variable to store parent Ceed context
16884dd1a9d2SSebastian Grimberg 
16894dd1a9d2SSebastian Grimberg   @return An error code: 0 - success, otherwise - failure
16904dd1a9d2SSebastian Grimberg 
16914dd1a9d2SSebastian Grimberg   @ref Backend
16924dd1a9d2SSebastian Grimberg **/
16934dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParentCeed(CeedOperator op, Ceed *parent) {
16944dd1a9d2SSebastian Grimberg   *parent = op->op_fallback_parent ? op->op_fallback_parent->ceed : op->ceed;
16954dd1a9d2SSebastian Grimberg   return CEED_ERROR_SUCCESS;
16964dd1a9d2SSebastian Grimberg }
16974dd1a9d2SSebastian Grimberg 
1698480fae85SJeremy L Thompson /// @}
1699480fae85SJeremy L Thompson 
1700480fae85SJeremy L Thompson /// ----------------------------------------------------------------------------
1701eaf62fffSJeremy L Thompson /// CeedOperator Public API
1702eaf62fffSJeremy L Thompson /// ----------------------------------------------------------------------------
1703eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorUser
1704eaf62fffSJeremy L Thompson /// @{
1705eaf62fffSJeremy L Thompson 
1706eaf62fffSJeremy L Thompson /**
1707eaf62fffSJeremy L Thompson   @brief Assemble a linear CeedQFunction associated with a CeedOperator
1708eaf62fffSJeremy L Thompson 
1709ea61e9acSJeremy L Thompson   This returns a CeedVector containing a matrix at each quadrature point providing the action of the CeedQFunction associated with the CeedOperator.
1710859c15bbSJames Wright   The vector `assembled` is of shape `[num_elements, num_input_fields, num_output_fields, num_quad_points]` and contains column-major matrices
1711859c15bbSJames Wright representing the action of the CeedQFunction for a corresponding quadrature point on an element.
1712859c15bbSJames Wright 
17139fd66db6SSebastian Grimberg   Inputs and outputs are in the order provided by the user when adding CeedOperator fields.
17149fd66db6SSebastian 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
17159fd66db6SSebastian 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].
1716eaf62fffSJeremy L Thompson 
1717ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1718f04ea552SJeremy L Thompson 
1719ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1720ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedQFunction at quadrature points
1721ea61e9acSJeremy L Thompson   @param[out] rstr      CeedElemRestriction for CeedVector containing assembled CeedQFunction
1722ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1723eaf62fffSJeremy L Thompson 
1724eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1725eaf62fffSJeremy L Thompson 
1726eaf62fffSJeremy L Thompson   @ref User
1727eaf62fffSJeremy L Thompson **/
17282b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunction(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
17292b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1730eaf62fffSJeremy L Thompson 
1731eaf62fffSJeremy L Thompson   if (op->LinearAssembleQFunction) {
1732d04bbc78SJeremy L Thompson     // Backend version
17332b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleQFunction(op, assembled, rstr, request));
1734eaf62fffSJeremy L Thompson   } else {
1735d04bbc78SJeremy L Thompson     // Operator fallback
1736d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1737d04bbc78SJeremy L Thompson 
17382b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
17396574a04fSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunction(op_fallback, assembled, rstr, request));
17406574a04fSJeremy L Thompson     else return CeedError(op->ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunction");
174170a7ffb3SJeremy L Thompson   }
1742eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1743eaf62fffSJeremy L Thompson }
174470a7ffb3SJeremy L Thompson 
174570a7ffb3SJeremy L Thompson /**
1746ea61e9acSJeremy L Thompson   @brief Assemble CeedQFunction and store result internally.
17474385fb7fSSebastian Grimberg 
1748ea61e9acSJeremy L Thompson   Return copied references of stored data to the caller.
1749ea61e9acSJeremy L Thompson   Caller is responsible for ownership and destruction of the copied references.
1750ea61e9acSJeremy L Thompson   See also @ref CeedOperatorLinearAssembleQFunction
175170a7ffb3SJeremy L Thompson 
1752c5f45aeaSJeremy 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.
1753c5f45aeaSJeremy L Thompson         These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object.
1754c5f45aeaSJeremy L Thompson 
1755ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1756ea61e9acSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedQFunction at quadrature points
1757ea61e9acSJeremy L Thompson   @param[out] rstr      CeedElemRestriction for CeedVector containing assembledCeedQFunction
1758ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
175970a7ffb3SJeremy L Thompson 
176070a7ffb3SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
176170a7ffb3SJeremy L Thompson 
176270a7ffb3SJeremy L Thompson   @ref User
176370a7ffb3SJeremy L Thompson **/
17642b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdate(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
1765b05f7e9fSJeremy L Thompson   int (*LinearAssembleQFunctionUpdate)(CeedOperator, CeedVector, CeedElemRestriction, CeedRequest *) = NULL;
1766b05f7e9fSJeremy L Thompson   CeedOperator op_assemble                                                                           = NULL;
1767bb229da9SJeremy L Thompson   CeedOperator op_fallback_parent                                                                    = NULL;
1768b05f7e9fSJeremy L Thompson 
17692b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
177070a7ffb3SJeremy L Thompson 
1771b05f7e9fSJeremy L Thompson   // Determine if fallback parent or operator has implementation
1772bb229da9SJeremy L Thompson   CeedCall(CeedOperatorGetFallbackParent(op, &op_fallback_parent));
1773bb229da9SJeremy L Thompson   if (op_fallback_parent && op_fallback_parent->LinearAssembleQFunctionUpdate) {
1774b05f7e9fSJeremy L Thompson     // -- Backend version for op fallback parent is faster, if it exists
1775bb229da9SJeremy L Thompson     LinearAssembleQFunctionUpdate = op_fallback_parent->LinearAssembleQFunctionUpdate;
1776bb229da9SJeremy L Thompson     op_assemble                   = op_fallback_parent;
1777b05f7e9fSJeremy L Thompson   } else if (op->LinearAssembleQFunctionUpdate) {
1778b05f7e9fSJeremy L Thompson     // -- Backend version for op
1779b05f7e9fSJeremy L Thompson     LinearAssembleQFunctionUpdate = op->LinearAssembleQFunctionUpdate;
1780b05f7e9fSJeremy L Thompson     op_assemble                   = op;
1781b05f7e9fSJeremy L Thompson   }
1782b05f7e9fSJeremy L Thompson 
1783b05f7e9fSJeremy L Thompson   // Assemble QFunction
1784b05f7e9fSJeremy L Thompson   if (LinearAssembleQFunctionUpdate) {
1785b05f7e9fSJeremy L Thompson     // Backend or fallback parent version
1786480fae85SJeremy L Thompson     bool                qf_assembled_is_setup;
17872efa2d85SJeremy L Thompson     CeedVector          assembled_vec  = NULL;
17882efa2d85SJeremy L Thompson     CeedElemRestriction assembled_rstr = NULL;
1789480fae85SJeremy L Thompson 
17902b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataIsSetup(op->qf_assembled, &qf_assembled_is_setup));
1791480fae85SJeremy L Thompson     if (qf_assembled_is_setup) {
1792d04bbc78SJeremy L Thompson       bool update_needed;
1793d04bbc78SJeremy L Thompson 
17942b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataGetObjects(op->qf_assembled, &assembled_vec, &assembled_rstr));
17952b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataIsUpdateNeeded(op->qf_assembled, &update_needed));
1796b05f7e9fSJeremy L Thompson       if (update_needed) CeedCall(LinearAssembleQFunctionUpdate(op_assemble, assembled_vec, assembled_rstr, request));
179770a7ffb3SJeremy L Thompson     } else {
1798b05f7e9fSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleQFunction(op_assemble, &assembled_vec, &assembled_rstr, request));
17992b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionAssemblyDataSetObjects(op->qf_assembled, assembled_vec, assembled_rstr));
180070a7ffb3SJeremy L Thompson     }
18012b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionAssemblyDataSetUpdateNeeded(op->qf_assembled, false));
18022efa2d85SJeremy L Thompson 
1803d04bbc78SJeremy L Thompson     // Copy reference from internally held copy
18042b730f8bSJeremy L Thompson     CeedCall(CeedVectorReferenceCopy(assembled_vec, assembled));
18052b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionReferenceCopy(assembled_rstr, rstr));
1806c5f45aeaSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled_vec));
18072b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&assembled_rstr));
180870a7ffb3SJeremy L Thompson   } else {
1809d04bbc78SJeremy L Thompson     // Operator fallback
1810d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1811d04bbc78SJeremy L Thompson 
18122b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
18136574a04fSJeremy L Thompson     if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op_fallback, assembled, rstr, request));
18146574a04fSJeremy L Thompson     else return CeedError(op->ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunctionUpdate");
181570a7ffb3SJeremy L Thompson   }
181670a7ffb3SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1817eaf62fffSJeremy L Thompson }
1818eaf62fffSJeremy L Thompson 
1819eaf62fffSJeremy L Thompson /**
1820eaf62fffSJeremy L Thompson   @brief Assemble the diagonal of a square linear CeedOperator
1821eaf62fffSJeremy L Thompson 
1822eaf62fffSJeremy L Thompson   This overwrites a CeedVector with the diagonal of a linear CeedOperator.
1823eaf62fffSJeremy L Thompson 
1824ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1825eaf62fffSJeremy L Thompson 
1826ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1827f04ea552SJeremy L Thompson 
1828ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1829eaf62fffSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator diagonal
1830ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1831eaf62fffSJeremy L Thompson 
1832eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1833eaf62fffSJeremy L Thompson 
1834eaf62fffSJeremy L Thompson   @ref User
1835eaf62fffSJeremy L Thompson **/
18362b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1837f3d47e36SJeremy L Thompson   bool     is_composite;
18381c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
18391c66c397SJeremy L Thompson 
18402b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1841f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1842eaf62fffSJeremy L Thompson 
18432b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
18446574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1845c9366a6bSJeremy L Thompson 
1846f3d47e36SJeremy L Thompson   // Early exit for empty operator
1847f3d47e36SJeremy L Thompson   if (!is_composite) {
1848f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1849f3d47e36SJeremy L Thompson 
1850f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1851f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1852f3d47e36SJeremy L Thompson   }
1853f3d47e36SJeremy L Thompson 
1854eaf62fffSJeremy L Thompson   if (op->LinearAssembleDiagonal) {
1855d04bbc78SJeremy L Thompson     // Backend version
18562b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleDiagonal(op, assembled, request));
1857eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1858eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddDiagonal) {
1859d04bbc78SJeremy L Thompson     // Backend version with zeroing first
18602b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
18612b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
1862eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1863eaf62fffSJeremy L Thompson   } else {
1864d04bbc78SJeremy L Thompson     // Operator fallback
1865d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1866d04bbc78SJeremy L Thompson 
18672b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1868d04bbc78SJeremy L Thompson     if (op_fallback) {
18692b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleDiagonal(op_fallback, assembled, request));
1870eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1871eaf62fffSJeremy L Thompson     }
1872eaf62fffSJeremy L Thompson   }
1873eaf62fffSJeremy L Thompson   // Default interface implementation
18742b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
18752b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddDiagonal(op, assembled, request));
1876eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
1877eaf62fffSJeremy L Thompson }
1878eaf62fffSJeremy L Thompson 
1879eaf62fffSJeremy L Thompson /**
1880eaf62fffSJeremy L Thompson   @brief Assemble the diagonal of a square linear CeedOperator
1881eaf62fffSJeremy L Thompson 
1882eaf62fffSJeremy L Thompson   This sums into a CeedVector the diagonal of a linear CeedOperator.
1883eaf62fffSJeremy L Thompson 
1884ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
1885eaf62fffSJeremy L Thompson 
1886ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
1887f04ea552SJeremy L Thompson 
1888ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
1889eaf62fffSJeremy L Thompson   @param[out] assembled CeedVector to store assembled CeedOperator diagonal
1890ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
1891eaf62fffSJeremy L Thompson 
1892eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
1893eaf62fffSJeremy L Thompson 
1894eaf62fffSJeremy L Thompson   @ref User
1895eaf62fffSJeremy L Thompson **/
18962b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
1897f3d47e36SJeremy L Thompson   bool     is_composite;
18981c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
18991c66c397SJeremy L Thompson 
19002b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
1901f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
1902eaf62fffSJeremy L Thompson 
19032b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
19046574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
1905c9366a6bSJeremy L Thompson 
1906f3d47e36SJeremy L Thompson   // Early exit for empty operator
1907f3d47e36SJeremy L Thompson   if (!is_composite) {
1908f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
1909f3d47e36SJeremy L Thompson 
1910f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
1911f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
1912f3d47e36SJeremy L Thompson   }
1913f3d47e36SJeremy L Thompson 
1914eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddDiagonal) {
1915d04bbc78SJeremy L Thompson     // Backend version
19162b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request));
1917eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
1918eaf62fffSJeremy L Thompson   } else {
1919d04bbc78SJeremy L Thompson     // Operator fallback
1920d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
1921d04bbc78SJeremy L Thompson 
19222b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
1923d04bbc78SJeremy L Thompson     if (op_fallback) {
19242b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddDiagonal(op_fallback, assembled, request));
1925eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
1926eaf62fffSJeremy L Thompson     }
1927eaf62fffSJeremy L Thompson   }
1928eaf62fffSJeremy L Thompson   // Default interface implementation
1929eaf62fffSJeremy L Thompson   if (is_composite) {
19302b730f8bSJeremy L Thompson     CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, false, assembled));
1931eaf62fffSJeremy L Thompson   } else {
19322b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleAddDiagonal_Core(op, request, false, assembled));
1933eaf62fffSJeremy L Thompson   }
1934d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
1935eaf62fffSJeremy L Thompson }
1936eaf62fffSJeremy L Thompson 
1937eaf62fffSJeremy L Thompson /**
193801f0e615SJames Wright    @brief Fully assemble the point-block diagonal pattern of a linear operator.
193901f0e615SJames Wright 
194001f0e615SJames Wright    Expected to be used in conjunction with CeedOperatorLinearAssemblePointBlockDiagonal().
194101f0e615SJames Wright 
194201f0e615SJames Wright    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
194301f0e615SJames Wright matrix in entry (i, j).
194401f0e615SJames Wright   Note that the (i, j) pairs are unique.
194501f0e615SJames Wright   This function returns the number of entries and their (i, j) locations, while CeedOperatorLinearAssemblePointBlockDiagonal() provides the values in
194601f0e615SJames Wright the same ordering.
194701f0e615SJames Wright 
194801f0e615SJames Wright    This will generally be slow unless your operator is low-order.
194901f0e615SJames Wright 
195001f0e615SJames Wright    Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
195101f0e615SJames Wright 
195201f0e615SJames Wright    @param[in]  op          CeedOperator to assemble
195301f0e615SJames Wright    @param[out] num_entries Number of entries in coordinate nonzero pattern
195401f0e615SJames Wright    @param[out] rows        Row number for each entry
195501f0e615SJames Wright    @param[out] cols        Column number for each entry
195601f0e615SJames Wright 
195701f0e615SJames Wright    @ref User
195801f0e615SJames Wright **/
195901f0e615SJames Wright int CeedOperatorLinearAssemblePointBlockDiagonalSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) {
196001f0e615SJames Wright   Ceed          ceed;
196101f0e615SJames Wright   bool          is_composite;
196201f0e615SJames Wright   CeedInt       num_active_components, num_sub_operators;
196301f0e615SJames Wright   CeedOperator *sub_operators;
196401f0e615SJames Wright 
196501f0e615SJames Wright   CeedCall(CeedOperatorGetCeed(op, &ceed));
196601f0e615SJames Wright   CeedCall(CeedOperatorIsComposite(op, &is_composite));
196701f0e615SJames Wright 
196801f0e615SJames Wright   CeedSize input_size = 0, output_size = 0;
196901f0e615SJames Wright   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
197001f0e615SJames Wright   CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square");
197101f0e615SJames Wright 
197201f0e615SJames Wright   if (is_composite) {
197301f0e615SJames Wright     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub_operators));
197401f0e615SJames Wright     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
197501f0e615SJames Wright   } else {
197601f0e615SJames Wright     sub_operators     = &op;
197701f0e615SJames Wright     num_sub_operators = 1;
197801f0e615SJames Wright   }
197901f0e615SJames Wright 
1980506b1a0cSSebastian Grimberg   // Verify operator can be assembled correctly
1981506b1a0cSSebastian Grimberg   {
198201f0e615SJames Wright     CeedOperatorAssemblyData data;
1983506b1a0cSSebastian Grimberg     CeedInt                  num_active_elem_rstrs, comp_stride;
198401f0e615SJames Wright     CeedElemRestriction     *active_elem_rstrs;
198501f0e615SJames Wright 
198601f0e615SJames Wright     // Get initial values to check against
198701f0e615SJames Wright     CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[0], &data));
1988506b1a0cSSebastian Grimberg     CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL));
198901f0e615SJames Wright     CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[0], &comp_stride));
199001f0e615SJames Wright     CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[0], &num_active_components));
199101f0e615SJames Wright 
1992506b1a0cSSebastian Grimberg     // Verify that all active element restrictions have same component stride and number of components
199301f0e615SJames Wright     for (CeedInt k = 0; k < num_sub_operators; k++) {
199401f0e615SJames Wright       CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[k], &data));
1995506b1a0cSSebastian Grimberg       CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL));
199601f0e615SJames Wright       for (CeedInt i = 0; i < num_active_elem_rstrs; i++) {
1997506b1a0cSSebastian Grimberg         CeedInt comp_stride_sub, num_active_components_sub;
1998506b1a0cSSebastian Grimberg 
199901f0e615SJames Wright         CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[i], &comp_stride_sub));
200001f0e615SJames Wright         CeedCheck(comp_stride == comp_stride_sub, ceed, CEED_ERROR_DIMENSION,
200101f0e615SJames Wright                   "Active element restrictions must have the same component stride: %d vs %d", comp_stride, comp_stride_sub);
200201f0e615SJames Wright         CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[i], &num_active_components_sub));
200301f0e615SJames Wright         CeedCheck(num_active_components == num_active_components_sub, ceed, CEED_ERROR_INCOMPATIBLE,
200401f0e615SJames Wright                   "All suboperators must have the same number of output components");
200501f0e615SJames Wright       }
200601f0e615SJames Wright     }
200701f0e615SJames Wright   }
200801f0e615SJames Wright   *num_entries = input_size * num_active_components;
200901f0e615SJames Wright   CeedCall(CeedCalloc(*num_entries, rows));
201001f0e615SJames Wright   CeedCall(CeedCalloc(*num_entries, cols));
201101f0e615SJames Wright 
201201f0e615SJames Wright   for (CeedInt o = 0; o < num_sub_operators; o++) {
2013506b1a0cSSebastian Grimberg     CeedElemRestriction active_elem_rstr, point_block_active_elem_rstr;
201401f0e615SJames Wright     CeedInt             comp_stride, num_elem, elem_size;
2015506b1a0cSSebastian Grimberg     const CeedInt      *offsets, *point_block_offsets;
201601f0e615SJames Wright 
201701f0e615SJames Wright     CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[o], &active_elem_rstr));
201801f0e615SJames Wright     CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstr, &comp_stride));
201901f0e615SJames Wright     CeedCall(CeedElemRestrictionGetNumElements(active_elem_rstr, &num_elem));
202001f0e615SJames Wright     CeedCall(CeedElemRestrictionGetElementSize(active_elem_rstr, &elem_size));
202101f0e615SJames Wright     CeedCall(CeedElemRestrictionGetOffsets(active_elem_rstr, CEED_MEM_HOST, &offsets));
202201f0e615SJames Wright 
2023506b1a0cSSebastian Grimberg     CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstr, &point_block_active_elem_rstr));
2024506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionGetOffsets(point_block_active_elem_rstr, CEED_MEM_HOST, &point_block_offsets));
202501f0e615SJames Wright 
202601f0e615SJames Wright     for (CeedSize i = 0; i < num_elem * elem_size; i++) {
202701f0e615SJames Wright       for (CeedInt c_out = 0; c_out < num_active_components; c_out++) {
202801f0e615SJames Wright         for (CeedInt c_in = 0; c_in < num_active_components; c_in++) {
2029506b1a0cSSebastian Grimberg           (*rows)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_out * comp_stride;
2030506b1a0cSSebastian Grimberg           (*cols)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_in * comp_stride;
203101f0e615SJames Wright         }
203201f0e615SJames Wright       }
203301f0e615SJames Wright     }
203401f0e615SJames Wright 
203501f0e615SJames Wright     CeedCall(CeedElemRestrictionRestoreOffsets(active_elem_rstr, &offsets));
2036506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionRestoreOffsets(point_block_active_elem_rstr, &point_block_offsets));
2037506b1a0cSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&point_block_active_elem_rstr));
203801f0e615SJames Wright   }
203901f0e615SJames Wright   return CEED_ERROR_SUCCESS;
204001f0e615SJames Wright }
204101f0e615SJames Wright 
204201f0e615SJames Wright /**
2043eaf62fffSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear CeedOperator
2044eaf62fffSJeremy L Thompson 
2045ea61e9acSJeremy L Thompson   This overwrites a CeedVector with the point block diagonal of a linear CeedOperator.
2046eaf62fffSJeremy L Thompson 
2047ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
2048eaf62fffSJeremy L Thompson 
2049ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2050f04ea552SJeremy L Thompson 
2051ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
2052ea61e9acSJeremy 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
2053ea61e9acSJeremy 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,
2054ea61e9acSJeremy L Thompson component in].
2055ea61e9acSJeremy L Thompson   @param[in]  request   Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2056eaf62fffSJeremy L Thompson 
2057eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2058eaf62fffSJeremy L Thompson 
2059eaf62fffSJeremy L Thompson   @ref User
2060eaf62fffSJeremy L Thompson **/
20612b730f8bSJeremy L Thompson int CeedOperatorLinearAssemblePointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2062f3d47e36SJeremy L Thompson   bool     is_composite;
20631c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
20641c66c397SJeremy L Thompson 
20652b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2066f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2067eaf62fffSJeremy L Thompson 
20682b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
20696574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
2070c9366a6bSJeremy L Thompson 
2071f3d47e36SJeremy L Thompson   // Early exit for empty operator
2072f3d47e36SJeremy L Thompson   if (!is_composite) {
2073f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2074f3d47e36SJeremy L Thompson 
2075f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2076f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2077f3d47e36SJeremy L Thompson   }
2078f3d47e36SJeremy L Thompson 
2079eaf62fffSJeremy L Thompson   if (op->LinearAssemblePointBlockDiagonal) {
2080d04bbc78SJeremy L Thompson     // Backend version
20812b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemblePointBlockDiagonal(op, assembled, request));
2082eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2083eaf62fffSJeremy L Thompson   } else if (op->LinearAssembleAddPointBlockDiagonal) {
2084d04bbc78SJeremy L Thompson     // Backend version with zeroing first
20852b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(assembled, 0.0));
20862b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
2087eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2088eaf62fffSJeremy L Thompson   } else {
2089d04bbc78SJeremy L Thompson     // Operator fallback
2090d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2091d04bbc78SJeremy L Thompson 
20922b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2093d04bbc78SJeremy L Thompson     if (op_fallback) {
20942b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemblePointBlockDiagonal(op_fallback, assembled, request));
2095eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2096eaf62fffSJeremy L Thompson     }
2097eaf62fffSJeremy L Thompson   }
2098eaf62fffSJeremy L Thompson   // Default interface implementation
20992b730f8bSJeremy L Thompson   CeedCall(CeedVectorSetValue(assembled, 0.0));
21002b730f8bSJeremy L Thompson   CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request));
2101eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2102eaf62fffSJeremy L Thompson }
2103eaf62fffSJeremy L Thompson 
2104eaf62fffSJeremy L Thompson /**
2105eaf62fffSJeremy L Thompson   @brief Assemble the point block diagonal of a square linear CeedOperator
2106eaf62fffSJeremy L Thompson 
2107ea61e9acSJeremy L Thompson   This sums into a CeedVector with the point block diagonal of a linear CeedOperator.
2108eaf62fffSJeremy L Thompson 
2109ea61e9acSJeremy L Thompson   Note: Currently only non-composite CeedOperators with a single field and composite CeedOperators with single field sub-operators are supported.
2110eaf62fffSJeremy L Thompson 
2111ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2112f04ea552SJeremy L Thompson 
2113ea61e9acSJeremy L Thompson   @param[in]  op        CeedOperator to assemble CeedQFunction
2114ea61e9acSJeremy 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
2115ea61e9acSJeremy 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,
2116ea61e9acSJeremy L Thompson component in].
2117ea61e9acSJeremy L Thompson   @param[in]  request Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2118eaf62fffSJeremy L Thompson 
2119eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2120eaf62fffSJeremy L Thompson 
2121eaf62fffSJeremy L Thompson   @ref User
2122eaf62fffSJeremy L Thompson **/
21232b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddPointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) {
2124f3d47e36SJeremy L Thompson   bool     is_composite;
21251c66c397SJeremy L Thompson   CeedSize input_size = 0, output_size = 0;
21261c66c397SJeremy L Thompson 
21272b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2128f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2129eaf62fffSJeremy L Thompson 
21302b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size));
21316574a04fSJeremy L Thompson   CeedCheck(input_size == output_size, op->ceed, CEED_ERROR_DIMENSION, "Operator must be square");
2132c9366a6bSJeremy L Thompson 
2133f3d47e36SJeremy L Thompson   // Early exit for empty operator
2134f3d47e36SJeremy L Thompson   if (!is_composite) {
2135f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2136f3d47e36SJeremy L Thompson 
2137f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2138f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2139f3d47e36SJeremy L Thompson   }
2140f3d47e36SJeremy L Thompson 
2141eaf62fffSJeremy L Thompson   if (op->LinearAssembleAddPointBlockDiagonal) {
2142d04bbc78SJeremy L Thompson     // Backend version
21432b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleAddPointBlockDiagonal(op, assembled, request));
2144eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2145eaf62fffSJeremy L Thompson   } else {
2146d04bbc78SJeremy L Thompson     // Operator fallback
2147d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2148d04bbc78SJeremy L Thompson 
21492b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2150d04bbc78SJeremy L Thompson     if (op_fallback) {
21512b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op_fallback, assembled, request));
2152eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2153eaf62fffSJeremy L Thompson     }
2154eaf62fffSJeremy L Thompson   }
2155ea61e9acSJeremy L Thompson   // Default interface implementation
2156eaf62fffSJeremy L Thompson   if (is_composite) {
21572b730f8bSJeremy L Thompson     CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, true, assembled));
2158eaf62fffSJeremy L Thompson   } else {
21592b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleAddDiagonal_Core(op, request, true, assembled));
2160eaf62fffSJeremy L Thompson   }
2161d04bbc78SJeremy L Thompson   return CEED_ERROR_SUCCESS;
2162eaf62fffSJeremy L Thompson }
2163eaf62fffSJeremy L Thompson 
2164eaf62fffSJeremy L Thompson /**
2165eaf62fffSJeremy L Thompson    @brief Fully assemble the nonzero pattern of a linear operator.
2166eaf62fffSJeremy L Thompson 
2167ea61e9acSJeremy L Thompson    Expected to be used in conjunction with CeedOperatorLinearAssemble().
2168eaf62fffSJeremy L Thompson 
2169ea61e9acSJeremy 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
21709fd66db6SSebastian Grimberg matrix in entry (i, j).
21719fd66db6SSebastian Grimberg   Note that the (i, j) pairs are not unique and may repeat.
21729fd66db6SSebastian Grimberg   This function returns the number of entries and their (i, j) locations, while CeedOperatorLinearAssemble() provides the values in the same ordering.
2173eaf62fffSJeremy L Thompson 
2174eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
2175eaf62fffSJeremy L Thompson 
2176ea61e9acSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2177f04ea552SJeremy L Thompson 
2178eaf62fffSJeremy L Thompson    @param[in]  op          CeedOperator to assemble
2179eaf62fffSJeremy L Thompson    @param[out] num_entries Number of entries in coordinate nonzero pattern
2180eaf62fffSJeremy L Thompson    @param[out] rows        Row number for each entry
2181eaf62fffSJeremy L Thompson    @param[out] cols        Column number for each entry
2182eaf62fffSJeremy L Thompson 
2183eaf62fffSJeremy L Thompson    @ref User
2184eaf62fffSJeremy L Thompson **/
21852b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) {
21861c66c397SJeremy L Thompson   bool          is_composite;
21871c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
2188b94338b9SJed Brown   CeedSize      single_entries;
2189eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
21901c66c397SJeremy L Thompson 
21912b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2192f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2193eaf62fffSJeremy L Thompson 
2194eaf62fffSJeremy L Thompson   if (op->LinearAssembleSymbolic) {
2195d04bbc78SJeremy L Thompson     // Backend version
21962b730f8bSJeremy L Thompson     CeedCall(op->LinearAssembleSymbolic(op, num_entries, rows, cols));
2197eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2198eaf62fffSJeremy L Thompson   } else {
2199d04bbc78SJeremy L Thompson     // Operator fallback
2200d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2201d04bbc78SJeremy L Thompson 
22022b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2203d04bbc78SJeremy L Thompson     if (op_fallback) {
22042b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssembleSymbolic(op_fallback, num_entries, rows, cols));
2205eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2206eaf62fffSJeremy L Thompson     }
2207eaf62fffSJeremy L Thompson   }
2208eaf62fffSJeremy L Thompson 
2209eaf62fffSJeremy L Thompson   // Default interface implementation
2210eaf62fffSJeremy L Thompson 
2211506b1a0cSSebastian Grimberg   // Count entries and allocate rows, cols arrays
2212eaf62fffSJeremy L Thompson   *num_entries = 0;
2213eaf62fffSJeremy L Thompson   if (is_composite) {
2214c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2215c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
221692ae7e47SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; ++k) {
22172b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
2218eaf62fffSJeremy L Thompson       *num_entries += single_entries;
2219eaf62fffSJeremy L Thompson     }
2220eaf62fffSJeremy L Thompson   } else {
22212b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssemblyCountEntries(op, &single_entries));
2222eaf62fffSJeremy L Thompson     *num_entries += single_entries;
2223eaf62fffSJeremy L Thompson   }
22242b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, rows));
22252b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(*num_entries, cols));
2226eaf62fffSJeremy L Thompson 
2227506b1a0cSSebastian Grimberg   // Assemble nonzero locations
2228eaf62fffSJeremy L Thompson   if (is_composite) {
2229c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2230c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
223192ae7e47SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; ++k) {
22322b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssembleSymbolic(sub_operators[k], offset, *rows, *cols));
22332b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
2234eaf62fffSJeremy L Thompson       offset += single_entries;
2235eaf62fffSJeremy L Thompson     }
2236eaf62fffSJeremy L Thompson   } else {
22372b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssembleSymbolic(op, offset, *rows, *cols));
2238eaf62fffSJeremy L Thompson   }
2239eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2240eaf62fffSJeremy L Thompson }
2241eaf62fffSJeremy L Thompson 
2242eaf62fffSJeremy L Thompson /**
2243eaf62fffSJeremy L Thompson    @brief Fully assemble the nonzero entries of a linear operator.
2244eaf62fffSJeremy L Thompson 
2245ea61e9acSJeremy L Thompson    Expected to be used in conjunction with CeedOperatorLinearAssembleSymbolic().
2246eaf62fffSJeremy L Thompson 
2247ea61e9acSJeremy 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
22489fd66db6SSebastian Grimberg matrix in entry (i, j).
22499fd66db6SSebastian Grimberg   Note that the (i, j) pairs are not unique and may repeat.
22509fd66db6SSebastian Grimberg   This function returns the values of the nonzero entries to be added, their (i, j) locations are provided by CeedOperatorLinearAssembleSymbolic()
2251eaf62fffSJeremy L Thompson 
2252eaf62fffSJeremy L Thompson    This will generally be slow unless your operator is low-order.
2253eaf62fffSJeremy L Thompson 
2254ea61e9acSJeremy L Thompson    Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2255f04ea552SJeremy L Thompson 
2256eaf62fffSJeremy L Thompson    @param[in]  op     CeedOperator to assemble
2257eaf62fffSJeremy L Thompson    @param[out] values Values to assemble into matrix
2258eaf62fffSJeremy L Thompson 
2259eaf62fffSJeremy L Thompson    @ref User
2260eaf62fffSJeremy L Thompson **/
2261eaf62fffSJeremy L Thompson int CeedOperatorLinearAssemble(CeedOperator op, CeedVector values) {
22621c66c397SJeremy L Thompson   bool          is_composite;
22631c66c397SJeremy L Thompson   CeedInt       num_suboperators, offset = 0;
2264b94338b9SJed Brown   CeedSize      single_entries = 0;
2265eaf62fffSJeremy L Thompson   CeedOperator *sub_operators;
22661c66c397SJeremy L Thompson 
22672b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2268f3d47e36SJeremy L Thompson   CeedCall(CeedOperatorIsComposite(op, &is_composite));
2269f3d47e36SJeremy L Thompson 
2270f3d47e36SJeremy L Thompson   // Early exit for empty operator
2271f3d47e36SJeremy L Thompson   if (!is_composite) {
2272f3d47e36SJeremy L Thompson     CeedInt num_elem = 0;
2273f3d47e36SJeremy L Thompson 
2274f3d47e36SJeremy L Thompson     CeedCall(CeedOperatorGetNumElements(op, &num_elem));
2275f3d47e36SJeremy L Thompson     if (num_elem == 0) return CEED_ERROR_SUCCESS;
2276f3d47e36SJeremy L Thompson   }
2277eaf62fffSJeremy L Thompson 
2278eaf62fffSJeremy L Thompson   if (op->LinearAssemble) {
2279d04bbc78SJeremy L Thompson     // Backend version
22802b730f8bSJeremy L Thompson     CeedCall(op->LinearAssemble(op, values));
2281eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2282eaf62fffSJeremy L Thompson   } else {
2283d04bbc78SJeremy L Thompson     // Operator fallback
2284d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2285d04bbc78SJeremy L Thompson 
22862b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2287d04bbc78SJeremy L Thompson     if (op_fallback) {
22882b730f8bSJeremy L Thompson       CeedCall(CeedOperatorLinearAssemble(op_fallback, values));
2289eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2290eaf62fffSJeremy L Thompson     }
2291eaf62fffSJeremy L Thompson   }
2292eaf62fffSJeremy L Thompson 
2293eaf62fffSJeremy L Thompson   // Default interface implementation
229428ec399dSJeremy L Thompson   CeedCall(CeedVectorSetValue(values, 0.0));
2295eaf62fffSJeremy L Thompson   if (is_composite) {
2296c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2297c6ebc35dSJeremy L Thompson     CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
2298cefa2673SJeremy L Thompson     for (CeedInt k = 0; k < num_suboperators; k++) {
22992b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemble(sub_operators[k], offset, values));
23002b730f8bSJeremy L Thompson       CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries));
2301eaf62fffSJeremy L Thompson       offset += single_entries;
2302eaf62fffSJeremy L Thompson     }
2303eaf62fffSJeremy L Thompson   } else {
23042b730f8bSJeremy L Thompson     CeedCall(CeedSingleOperatorAssemble(op, offset, values));
2305eaf62fffSJeremy L Thompson   }
2306eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2307eaf62fffSJeremy L Thompson }
2308eaf62fffSJeremy L Thompson 
2309eaf62fffSJeremy L Thompson /**
231075f0d5a4SJeremy L Thompson   @brief Get the multiplicity of nodes across suboperators in a composite CeedOperator
231175f0d5a4SJeremy L Thompson 
231275f0d5a4SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
231375f0d5a4SJeremy L Thompson 
231475f0d5a4SJeremy L Thompson   @param[in]  op               Composite CeedOperator
231575f0d5a4SJeremy L Thompson   @param[in]  num_skip_indices Number of suboperators to skip
231675f0d5a4SJeremy L Thompson   @param[in]  skip_indices     Array of indices of suboperators to skip
231775f0d5a4SJeremy L Thompson   @param[out] mult             Vector to store multiplicity (of size l_size)
231875f0d5a4SJeremy L Thompson 
231975f0d5a4SJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
232075f0d5a4SJeremy L Thompson 
232175f0d5a4SJeremy L Thompson   @ref User
232275f0d5a4SJeremy L Thompson **/
232375f0d5a4SJeremy L Thompson int CeedCompositeOperatorGetMultiplicity(CeedOperator op, CeedInt num_skip_indices, CeedInt *skip_indices, CeedVector mult) {
232475f0d5a4SJeremy L Thompson   Ceed                ceed;
2325b275c451SJeremy L Thompson   CeedInt             num_suboperators;
232675f0d5a4SJeremy L Thompson   CeedSize            l_vec_len;
232775f0d5a4SJeremy L Thompson   CeedScalar         *mult_array;
232875f0d5a4SJeremy L Thompson   CeedVector          ones_l_vec;
23297c1dbaffSSebastian Grimberg   CeedElemRestriction elem_rstr, mult_elem_rstr;
2330b275c451SJeremy L Thompson   CeedOperator       *sub_operators;
233175f0d5a4SJeremy L Thompson 
23321c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
23331c66c397SJeremy L Thompson 
233475f0d5a4SJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
233575f0d5a4SJeremy L Thompson 
233675f0d5a4SJeremy L Thompson   // Zero mult vector
233775f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(mult, 0.0));
233875f0d5a4SJeremy L Thompson 
233975f0d5a4SJeremy L Thompson   // Get suboperators
2340b275c451SJeremy L Thompson   CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators));
2341b275c451SJeremy L Thompson   CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators));
2342b275c451SJeremy L Thompson   if (num_suboperators == 0) return CEED_ERROR_SUCCESS;
234375f0d5a4SJeremy L Thompson 
234475f0d5a4SJeremy L Thompson   // Work vector
234575f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetLength(mult, &l_vec_len));
234675f0d5a4SJeremy L Thompson   CeedCall(CeedVectorCreate(ceed, l_vec_len, &ones_l_vec));
234775f0d5a4SJeremy L Thompson   CeedCall(CeedVectorSetValue(ones_l_vec, 1.0));
234875f0d5a4SJeremy L Thompson   CeedCall(CeedVectorGetArray(mult, CEED_MEM_HOST, &mult_array));
234975f0d5a4SJeremy L Thompson 
235075f0d5a4SJeremy L Thompson   // Compute multiplicity across suboperators
2351b275c451SJeremy L Thompson   for (CeedInt i = 0; i < num_suboperators; i++) {
235275f0d5a4SJeremy L Thompson     const CeedScalar *sub_mult_array;
235375f0d5a4SJeremy L Thompson     CeedVector        sub_mult_l_vec, ones_e_vec;
235475f0d5a4SJeremy L Thompson 
235575f0d5a4SJeremy L Thompson     // -- Check for suboperator to skip
235675f0d5a4SJeremy L Thompson     for (CeedInt j = 0; j < num_skip_indices; j++) {
235775f0d5a4SJeremy L Thompson       if (skip_indices[j] == i) continue;
235875f0d5a4SJeremy L Thompson     }
235975f0d5a4SJeremy L Thompson 
236075f0d5a4SJeremy L Thompson     // -- Sub operator multiplicity
2361437c7c90SJeremy L Thompson     CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[i], &elem_rstr));
23627c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr, &mult_elem_rstr));
23637c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateVector(mult_elem_rstr, &sub_mult_l_vec, &ones_e_vec));
236475f0d5a4SJeremy L Thompson     CeedCall(CeedVectorSetValue(sub_mult_l_vec, 0.0));
23657c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_NOTRANSPOSE, ones_l_vec, ones_e_vec, CEED_REQUEST_IMMEDIATE));
23667c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_TRANSPOSE, ones_e_vec, sub_mult_l_vec, CEED_REQUEST_IMMEDIATE));
236775f0d5a4SJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(sub_mult_l_vec, CEED_MEM_HOST, &sub_mult_array));
236875f0d5a4SJeremy L Thompson     // ---- Flag every node present in the current suboperator
236975f0d5a4SJeremy L Thompson     for (CeedInt j = 0; j < l_vec_len; j++) {
237075f0d5a4SJeremy L Thompson       if (sub_mult_array[j] > 0.0) mult_array[j] += 1.0;
237175f0d5a4SJeremy L Thompson     }
237275f0d5a4SJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(sub_mult_l_vec, &sub_mult_array));
237375f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&sub_mult_l_vec));
237475f0d5a4SJeremy L Thompson     CeedCall(CeedVectorDestroy(&ones_e_vec));
23757c1dbaffSSebastian Grimberg     CeedCall(CeedElemRestrictionDestroy(&mult_elem_rstr));
237675f0d5a4SJeremy L Thompson   }
237775f0d5a4SJeremy L Thompson   CeedCall(CeedVectorRestoreArray(mult, &mult_array));
2378811d0ccfSJeremy L Thompson   CeedCall(CeedVectorDestroy(&ones_l_vec));
237975f0d5a4SJeremy L Thompson   return CEED_ERROR_SUCCESS;
238075f0d5a4SJeremy L Thompson }
238175f0d5a4SJeremy L Thompson 
238275f0d5a4SJeremy L Thompson /**
2383ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator, creating the prolongation basis from the fine and coarse
2384ea61e9acSJeremy L Thompson grid interpolation
2385eaf62fffSJeremy L Thompson 
238658e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2387f04ea552SJeremy L Thompson 
2388eaf62fffSJeremy L Thompson   @param[in]  op_fine      Fine grid operator
238985bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine  L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2390eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse  Coarse grid restriction
2391eaf62fffSJeremy L Thompson   @param[in]  basis_coarse Coarse grid active vector basis
2392eaf62fffSJeremy L Thompson   @param[out] op_coarse    Coarse grid operator
239385bb9dcfSJeremy L Thompson   @param[out] op_prolong   Coarse to fine operator, or NULL
23947758292fSSebastian Grimberg   @param[out] op_restrict  Fine to coarse operator, or NULL
2395eaf62fffSJeremy L Thompson 
2396eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2397eaf62fffSJeremy L Thompson 
2398eaf62fffSJeremy L Thompson   @ref User
2399eaf62fffSJeremy L Thompson **/
24002b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreate(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
24017758292fSSebastian Grimberg                                      CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) {
24021c66c397SJeremy L Thompson   CeedBasis basis_c_to_f = NULL;
24031c66c397SJeremy L Thompson 
24042b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
2405eaf62fffSJeremy L Thompson 
240683d6adf3SZach Atkins   // Build prolongation matrix, if required
24077758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
240883d6adf3SZach Atkins     CeedBasis basis_fine;
24091c66c397SJeremy L Thompson 
24102b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
24112b730f8bSJeremy L Thompson     CeedCall(CeedBasisCreateProjection(basis_coarse, basis_fine, &basis_c_to_f));
241283d6adf3SZach Atkins   }
2413eaf62fffSJeremy L Thompson 
2414f113e5dcSJeremy L Thompson   // Core code
24157758292fSSebastian Grimberg   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2416eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2417eaf62fffSJeremy L Thompson }
2418eaf62fffSJeremy L Thompson 
2419eaf62fffSJeremy L Thompson /**
2420ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator with a tensor basis for the active basis
2421eaf62fffSJeremy L Thompson 
242258e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2423f04ea552SJeremy L Thompson 
2424eaf62fffSJeremy L Thompson   @param[in]  op_fine       Fine grid operator
242585bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2426eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid restriction
2427eaf62fffSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector basis
242885bb9dcfSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
2429eaf62fffSJeremy L Thompson   @param[out] op_coarse     Coarse grid operator
243085bb9dcfSJeremy L Thompson   @param[out] op_prolong    Coarse to fine operator, or NULL
24317758292fSSebastian Grimberg   @param[out] op_restrict   Fine to coarse operator, or NULL
2432eaf62fffSJeremy L Thompson 
2433eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2434eaf62fffSJeremy L Thompson 
2435eaf62fffSJeremy L Thompson   @ref User
2436eaf62fffSJeremy L Thompson **/
24372b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateTensorH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
24382b730f8bSJeremy L Thompson                                              const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
24397758292fSSebastian Grimberg                                              CeedOperator *op_restrict) {
2440eaf62fffSJeremy L Thompson   Ceed      ceed;
24411c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
24421c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
24431c66c397SJeremy L Thompson 
24441c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
24452b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2446eaf62fffSJeremy L Thompson 
2447eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
24482b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
24492b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
24502b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
24516574a04fSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces");
2452eaf62fffSJeremy L Thompson 
245383d6adf3SZach Atkins   // Create coarse to fine basis, if required
24547758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
24551c66c397SJeremy L Thompson     CeedInt     dim, num_comp, num_nodes_c, P_1d_f, P_1d_c;
24561c66c397SJeremy L Thompson     CeedScalar *q_ref, *q_weight, *grad;
24571c66c397SJeremy L Thompson 
245883d6adf3SZach Atkins     // Check if interpolation matrix is provided
24596574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
24606574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
24612b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
24622b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
24632b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes1D(basis_fine, &P_1d_f));
24642b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
24652b730f8bSJeremy L Thompson     P_1d_c = dim == 1 ? num_nodes_c : dim == 2 ? sqrt(num_nodes_c) : cbrt(num_nodes_c);
24662b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_ref));
24672b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f, &q_weight));
24682b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d_f * P_1d_c * dim, &grad));
24692b730f8bSJeremy 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));
24702b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
24712b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
24722b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
247383d6adf3SZach Atkins   }
2474eaf62fffSJeremy L Thompson 
2475eaf62fffSJeremy L Thompson   // Core code
24767758292fSSebastian Grimberg   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2477eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2478eaf62fffSJeremy L Thompson }
2479eaf62fffSJeremy L Thompson 
2480eaf62fffSJeremy L Thompson /**
2481ea61e9acSJeremy L Thompson   @brief Create a multigrid coarse operator and level transfer operators for a CeedOperator with a non-tensor basis for the active vector
2482eaf62fffSJeremy L Thompson 
248358e4b056SJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets all four CeedOperators as immutable.
2484f04ea552SJeremy L Thompson 
2485eaf62fffSJeremy L Thompson   @param[in]  op_fine       Fine grid operator
248685bb9dcfSJeremy L Thompson   @param[in]  p_mult_fine   L-vector multiplicity in parallel gather/scatter, or NULL if not creating prolongation/restriction operators
2487eaf62fffSJeremy L Thompson   @param[in]  rstr_coarse   Coarse grid restriction
2488eaf62fffSJeremy L Thompson   @param[in]  basis_coarse  Coarse grid active vector basis
248985bb9dcfSJeremy L Thompson   @param[in]  interp_c_to_f Matrix for coarse to fine interpolation, or NULL if not creating prolongation/restriction operators
2490eaf62fffSJeremy L Thompson   @param[out] op_coarse     Coarse grid operator
249185bb9dcfSJeremy L Thompson   @param[out] op_prolong    Coarse to fine operator, or NULL
24927758292fSSebastian Grimberg   @param[out] op_restrict   Fine to coarse operator, or NULL
2493eaf62fffSJeremy L Thompson 
2494eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2495eaf62fffSJeremy L Thompson 
2496eaf62fffSJeremy L Thompson   @ref User
2497eaf62fffSJeremy L Thompson **/
24982b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse,
24997758292fSSebastian Grimberg                                        const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong,
25007758292fSSebastian Grimberg                                        CeedOperator *op_restrict) {
2501eaf62fffSJeremy L Thompson   Ceed      ceed;
25021c66c397SJeremy L Thompson   CeedInt   Q_f, Q_c;
25031c66c397SJeremy L Thompson   CeedBasis basis_fine, basis_c_to_f = NULL;
25041c66c397SJeremy L Thompson 
25051c66c397SJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op_fine));
25062b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op_fine, &ceed));
2507eaf62fffSJeremy L Thompson 
2508eaf62fffSJeremy L Thompson   // Check for compatible quadrature spaces
25092b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine));
25102b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f));
25112b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c));
25126574a04fSJeremy L Thompson   CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces");
2513eaf62fffSJeremy L Thompson 
2514eaf62fffSJeremy L Thompson   // Coarse to fine basis
25157758292fSSebastian Grimberg   if (op_prolong || op_restrict) {
25161c66c397SJeremy L Thompson     CeedInt          dim, num_comp, num_nodes_c, num_nodes_f;
25171c66c397SJeremy L Thompson     CeedScalar      *q_ref, *q_weight, *grad;
25181c66c397SJeremy L Thompson     CeedElemTopology topo;
25191c66c397SJeremy L Thompson 
252083d6adf3SZach Atkins     // Check if interpolation matrix is provided
25216574a04fSJeremy L Thompson     CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE,
25226574a04fSJeremy L Thompson               "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix");
25232b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetTopology(basis_fine, &topo));
25242b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetDimension(basis_fine, &dim));
25252b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp));
25262b730f8bSJeremy L Thompson     CeedCall(CeedBasisGetNumNodes(basis_fine, &num_nodes_f));
25272b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c));
25282b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * dim, &q_ref));
25292b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f, &q_weight));
25302b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_nodes_f * num_nodes_c * dim, &grad));
25312b730f8bSJeremy 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));
25322b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref));
25332b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight));
25342b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad));
253583d6adf3SZach Atkins   }
2536eaf62fffSJeremy L Thompson 
2537eaf62fffSJeremy L Thompson   // Core code
25387758292fSSebastian Grimberg   CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict));
2539eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2540eaf62fffSJeremy L Thompson }
2541eaf62fffSJeremy L Thompson 
2542eaf62fffSJeremy L Thompson /**
2543ea61e9acSJeremy L Thompson   @brief Build a FDM based approximate inverse for each element for a CeedOperator
2544eaf62fffSJeremy L Thompson 
2545ea61e9acSJeremy L Thompson   This returns a CeedOperator and CeedVector to apply a Fast Diagonalization Method based approximate inverse.
2546859c15bbSJames 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$.
2547859c15bbSJames Wright   The assembled QFunction is used to modify the eigenvalues from simultaneous diagonalization and obtain an approximate inverse of the form \f$V^T
25489fd66db6SSebastian Grimberg \hat S V\f$.
25499fd66db6SSebastian Grimberg   The CeedOperator must be linear and non-composite.
25509fd66db6SSebastian Grimberg   The associated CeedQFunction must therefore also be linear.
2551eaf62fffSJeremy L Thompson 
2552ea61e9acSJeremy L Thompson   Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable.
2553f04ea552SJeremy L Thompson 
2554ea61e9acSJeremy L Thompson   @param[in]  op      CeedOperator to create element inverses
2555ea61e9acSJeremy L Thompson   @param[out] fdm_inv CeedOperator to apply the action of a FDM based inverse for each element
2556ea61e9acSJeremy L Thompson   @param[in]  request Address of CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE
2557eaf62fffSJeremy L Thompson 
2558eaf62fffSJeremy L Thompson   @return An error code: 0 - success, otherwise - failure
2559eaf62fffSJeremy L Thompson 
2560480fae85SJeremy L Thompson   @ref User
2561eaf62fffSJeremy L Thompson **/
25622b730f8bSJeremy L Thompson int CeedOperatorCreateFDMElementInverse(CeedOperator op, CeedOperator *fdm_inv, CeedRequest *request) {
25631c66c397SJeremy L Thompson   Ceed                 ceed, ceed_parent;
25641c66c397SJeremy L Thompson   bool                 interp = false, grad = false, is_tensor_basis = true;
25651c66c397SJeremy L Thompson   CeedInt              num_input_fields, P_1d, Q_1d, num_nodes, num_qpts, dim, num_comp = 1, num_elem = 1;
25661c66c397SJeremy L Thompson   CeedSize             l_size = 1;
25671c66c397SJeremy L Thompson   CeedScalar          *mass, *laplace, *x, *fdm_interp, *lambda, *elem_avg;
25681c66c397SJeremy L Thompson   const CeedScalar    *interp_1d, *grad_1d, *q_weight_1d;
25691c66c397SJeremy L Thompson   CeedVector           q_data;
25701c66c397SJeremy L Thompson   CeedElemRestriction  rstr  = NULL, rstr_qd_i;
25711c66c397SJeremy L Thompson   CeedBasis            basis = NULL, fdm_basis;
25721c66c397SJeremy L Thompson   CeedQFunctionContext ctx_fdm;
25731c66c397SJeremy L Thompson   CeedQFunctionField  *qf_fields;
25741c66c397SJeremy L Thompson   CeedQFunction        qf, qf_fdm;
25751c66c397SJeremy L Thompson   CeedOperatorField   *op_fields;
25761c66c397SJeremy L Thompson 
25772b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCheckReady(op));
2578eaf62fffSJeremy L Thompson 
2579eaf62fffSJeremy L Thompson   if (op->CreateFDMElementInverse) {
2580d04bbc78SJeremy L Thompson     // Backend version
25812b730f8bSJeremy L Thompson     CeedCall(op->CreateFDMElementInverse(op, fdm_inv, request));
2582eaf62fffSJeremy L Thompson     return CEED_ERROR_SUCCESS;
2583eaf62fffSJeremy L Thompson   } else {
2584d04bbc78SJeremy L Thompson     // Operator fallback
2585d04bbc78SJeremy L Thompson     CeedOperator op_fallback;
2586d04bbc78SJeremy L Thompson 
25872b730f8bSJeremy L Thompson     CeedCall(CeedOperatorGetFallback(op, &op_fallback));
2588d04bbc78SJeremy L Thompson     if (op_fallback) {
25892b730f8bSJeremy L Thompson       CeedCall(CeedOperatorCreateFDMElementInverse(op_fallback, fdm_inv, request));
2590eaf62fffSJeremy L Thompson       return CEED_ERROR_SUCCESS;
2591eaf62fffSJeremy L Thompson     }
2592eaf62fffSJeremy L Thompson   }
2593eaf62fffSJeremy L Thompson 
2594d04bbc78SJeremy L Thompson   // Default interface implementation
25952b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetCeed(op, &ceed));
2596bb229da9SJeremy L Thompson   CeedCall(CeedOperatorGetFallbackParentCeed(op, &ceed_parent));
25972b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetQFunction(op, &qf));
2598eaf62fffSJeremy L Thompson 
2599eaf62fffSJeremy L Thompson   // Determine active input basis
26002b730f8bSJeremy L Thompson   CeedCall(CeedOperatorGetFields(op, &num_input_fields, &op_fields, NULL, NULL));
26012b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL));
2602eaf62fffSJeremy L Thompson   for (CeedInt i = 0; i < num_input_fields; i++) {
2603eaf62fffSJeremy L Thompson     CeedVector vec;
26041c66c397SJeremy L Thompson 
26052b730f8bSJeremy L Thompson     CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec));
2606eaf62fffSJeremy L Thompson     if (vec == CEED_VECTOR_ACTIVE) {
2607eaf62fffSJeremy L Thompson       CeedEvalMode eval_mode;
26081c66c397SJeremy L Thompson 
26092b730f8bSJeremy L Thompson       CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
2610eaf62fffSJeremy L Thompson       interp = interp || eval_mode == CEED_EVAL_INTERP;
2611eaf62fffSJeremy L Thompson       grad   = grad || eval_mode == CEED_EVAL_GRAD;
26122b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis));
26132b730f8bSJeremy L Thompson       CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &rstr));
2614eaf62fffSJeremy L Thompson     }
2615eaf62fffSJeremy L Thompson   }
26166574a04fSJeremy L Thompson   CeedCheck(basis, ceed, CEED_ERROR_BACKEND, "No active field set");
26172b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumNodes1D(basis, &P_1d));
2618352a5e7cSSebastian Grimberg   CeedCall(CeedBasisGetNumNodes(basis, &num_nodes));
26192b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints1D(basis, &Q_1d));
26202b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumQuadraturePoints(basis, &num_qpts));
26212b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetDimension(basis, &dim));
26222b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetNumComponents(basis, &num_comp));
26232b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem));
26242b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size));
2625eaf62fffSJeremy L Thompson 
2626eaf62fffSJeremy L Thompson   // Build and diagonalize 1D Mass and Laplacian
26276574a04fSJeremy L Thompson   CeedCall(CeedBasisIsTensor(basis, &is_tensor_basis));
26286574a04fSJeremy L Thompson   CeedCheck(is_tensor_basis, ceed, CEED_ERROR_BACKEND, "FDMElementInverse only supported for tensor bases");
26292b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &mass));
26302b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &laplace));
26312b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &x));
26322b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d * P_1d, &fdm_interp));
26332b730f8bSJeremy L Thompson   CeedCall(CeedCalloc(P_1d, &lambda));
2634eaf62fffSJeremy L Thompson   // -- Build matrices
26352b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetInterp1D(basis, &interp_1d));
26362b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetGrad1D(basis, &grad_1d));
26372b730f8bSJeremy L Thompson   CeedCall(CeedBasisGetQWeights(basis, &q_weight_1d));
26382b730f8bSJeremy L Thompson   CeedCall(CeedBuildMassLaplace(interp_1d, grad_1d, q_weight_1d, P_1d, Q_1d, dim, mass, laplace));
2639eaf62fffSJeremy L Thompson 
2640eaf62fffSJeremy L Thompson   // -- Diagonalize
26412b730f8bSJeremy L Thompson   CeedCall(CeedSimultaneousDiagonalization(ceed, laplace, mass, x, lambda, P_1d));
26422b730f8bSJeremy L Thompson   CeedCall(CeedFree(&mass));
26432b730f8bSJeremy L Thompson   CeedCall(CeedFree(&laplace));
26442b730f8bSJeremy L Thompson   for (CeedInt i = 0; i < P_1d; i++) {
26452b730f8bSJeremy L Thompson     for (CeedInt j = 0; j < P_1d; j++) fdm_interp[i + j * P_1d] = x[j + i * P_1d];
26462b730f8bSJeremy L Thompson   }
26472b730f8bSJeremy L Thompson   CeedCall(CeedFree(&x));
2648eaf62fffSJeremy L Thompson 
26491c66c397SJeremy L Thompson   {
26501c66c397SJeremy L Thompson     CeedInt             layout[3], num_modes = (interp ? 1 : 0) + (grad ? dim : 0);
26511c66c397SJeremy L Thompson     CeedScalar          max_norm = 0;
26521c66c397SJeremy L Thompson     const CeedScalar   *assembled_array, *q_weight_array;
26531c66c397SJeremy L Thompson     CeedVector          assembled = NULL, q_weight;
2654c5f45aeaSJeremy L Thompson     CeedElemRestriction rstr_qf   = NULL;
26551c66c397SJeremy L Thompson 
26561c66c397SJeremy L Thompson     // Assemble QFunction
26572b730f8bSJeremy L Thompson     CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled, &rstr_qf, request));
26582b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionGetELayout(rstr_qf, &layout));
26592b730f8bSJeremy L Thompson     CeedCall(CeedElemRestrictionDestroy(&rstr_qf));
26602b730f8bSJeremy L Thompson     CeedCall(CeedVectorNorm(assembled, CEED_NORM_MAX, &max_norm));
2661eaf62fffSJeremy L Thompson 
2662eaf62fffSJeremy L Thompson     // Calculate element averages
26632b730f8bSJeremy L Thompson     CeedCall(CeedVectorCreate(ceed_parent, num_qpts, &q_weight));
26642b730f8bSJeremy L Thompson     CeedCall(CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_weight));
26652b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(assembled, CEED_MEM_HOST, &assembled_array));
26662b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayRead(q_weight, CEED_MEM_HOST, &q_weight_array));
26672b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(num_elem, &elem_avg));
2668eaf62fffSJeremy L Thompson     const CeedScalar qf_value_bound = max_norm * 100 * CEED_EPSILON;
26691c66c397SJeremy L Thompson 
2670eaf62fffSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
2671eaf62fffSJeremy L Thompson       CeedInt count = 0;
26721c66c397SJeremy L Thompson 
26732b730f8bSJeremy L Thompson       for (CeedInt q = 0; q < num_qpts; q++) {
26742b730f8bSJeremy L Thompson         for (CeedInt i = 0; i < num_comp * num_comp * num_modes * num_modes; i++) {
26752b730f8bSJeremy L Thompson           if (fabs(assembled_array[q * layout[0] + i * layout[1] + e * layout[2]]) > qf_value_bound) {
26762b730f8bSJeremy L Thompson             elem_avg[e] += assembled_array[q * layout[0] + i * layout[1] + e * layout[2]] / q_weight_array[q];
2677eaf62fffSJeremy L Thompson             count++;
2678eaf62fffSJeremy L Thompson           }
26792b730f8bSJeremy L Thompson         }
26802b730f8bSJeremy L Thompson       }
2681eaf62fffSJeremy L Thompson       if (count) {
2682eaf62fffSJeremy L Thompson         elem_avg[e] /= count;
2683eaf62fffSJeremy L Thompson       } else {
2684eaf62fffSJeremy L Thompson         elem_avg[e] = 1.0;
2685eaf62fffSJeremy L Thompson       }
2686eaf62fffSJeremy L Thompson     }
26872b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(assembled, &assembled_array));
26882b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&assembled));
26892b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArrayRead(q_weight, &q_weight_array));
26902b730f8bSJeremy L Thompson     CeedCall(CeedVectorDestroy(&q_weight));
26911c66c397SJeremy L Thompson   }
2692eaf62fffSJeremy L Thompson 
2693eaf62fffSJeremy L Thompson   // Build FDM diagonal
26941c66c397SJeremy L Thompson   {
2695eaf62fffSJeremy L Thompson     CeedScalar *q_data_array, *fdm_diagonal;
26961c66c397SJeremy L Thompson 
2697352a5e7cSSebastian Grimberg     CeedCall(CeedCalloc(num_comp * num_nodes, &fdm_diagonal));
2698352a5e7cSSebastian Grimberg     const CeedScalar fdm_diagonal_bound = num_nodes * CEED_EPSILON;
26992b730f8bSJeremy L Thompson     for (CeedInt c = 0; c < num_comp; c++) {
2700352a5e7cSSebastian Grimberg       for (CeedInt n = 0; n < num_nodes; n++) {
2701352a5e7cSSebastian Grimberg         if (interp) fdm_diagonal[c * num_nodes + n] = 1.0;
27022b730f8bSJeremy L Thompson         if (grad) {
2703eaf62fffSJeremy L Thompson           for (CeedInt d = 0; d < dim; d++) {
2704eaf62fffSJeremy L Thompson             CeedInt i = (n / CeedIntPow(P_1d, d)) % P_1d;
2705352a5e7cSSebastian Grimberg             fdm_diagonal[c * num_nodes + n] += lambda[i];
2706eaf62fffSJeremy L Thompson           }
2707eaf62fffSJeremy L Thompson         }
2708352a5e7cSSebastian Grimberg         if (fabs(fdm_diagonal[c * num_nodes + n]) < fdm_diagonal_bound) fdm_diagonal[c * num_nodes + n] = fdm_diagonal_bound;
27092b730f8bSJeremy L Thompson       }
27102b730f8bSJeremy L Thompson     }
2711352a5e7cSSebastian Grimberg     CeedCall(CeedVectorCreate(ceed_parent, num_elem * num_comp * num_nodes, &q_data));
27122b730f8bSJeremy L Thompson     CeedCall(CeedVectorSetValue(q_data, 0.0));
27132b730f8bSJeremy L Thompson     CeedCall(CeedVectorGetArrayWrite(q_data, CEED_MEM_HOST, &q_data_array));
27142b730f8bSJeremy L Thompson     for (CeedInt e = 0; e < num_elem; e++) {
27152b730f8bSJeremy L Thompson       for (CeedInt c = 0; c < num_comp; c++) {
27161c66c397SJeremy L Thompson         for (CeedInt n = 0; n < num_nodes; n++)
27171c66c397SJeremy L Thompson           q_data_array[(e * num_comp + c) * num_nodes + n] = 1. / (elem_avg[e] * fdm_diagonal[c * num_nodes + n]);
27182b730f8bSJeremy L Thompson       }
27192b730f8bSJeremy L Thompson     }
27202b730f8bSJeremy L Thompson     CeedCall(CeedFree(&elem_avg));
27212b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_diagonal));
27222b730f8bSJeremy L Thompson     CeedCall(CeedVectorRestoreArray(q_data, &q_data_array));
27231c66c397SJeremy L Thompson   }
2724eaf62fffSJeremy L Thompson 
2725eaf62fffSJeremy L Thompson   // Setup FDM operator
2726eaf62fffSJeremy L Thompson   // -- Basis
27271c66c397SJeremy L Thompson   {
2728eaf62fffSJeremy L Thompson     CeedScalar *grad_dummy, *q_ref_dummy, *q_weight_dummy;
27291c66c397SJeremy L Thompson 
27302b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d * P_1d, &grad_dummy));
27312b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_ref_dummy));
27322b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(P_1d, &q_weight_dummy));
27332b730f8bSJeremy 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));
27342b730f8bSJeremy L Thompson     CeedCall(CeedFree(&fdm_interp));
27352b730f8bSJeremy L Thompson     CeedCall(CeedFree(&grad_dummy));
27362b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_ref_dummy));
27372b730f8bSJeremy L Thompson     CeedCall(CeedFree(&q_weight_dummy));
27382b730f8bSJeremy L Thompson     CeedCall(CeedFree(&lambda));
27391c66c397SJeremy L Thompson   }
2740eaf62fffSJeremy L Thompson 
2741eaf62fffSJeremy L Thompson   // -- Restriction
27421c66c397SJeremy L Thompson   {
2743352a5e7cSSebastian Grimberg     CeedInt strides[3] = {1, num_nodes, num_nodes * num_comp};
2744352a5e7cSSebastian Grimberg     CeedCall(CeedElemRestrictionCreateStrided(ceed_parent, num_elem, num_nodes, num_comp, num_elem * num_comp * num_nodes, strides, &rstr_qd_i));
27451c66c397SJeremy L Thompson   }
27461c66c397SJeremy L Thompson 
2747eaf62fffSJeremy L Thompson   // -- QFunction
27482b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionCreateInteriorByName(ceed_parent, "Scale", &qf_fdm));
27492b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "input", num_comp, CEED_EVAL_INTERP));
27502b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddInput(qf_fdm, "scale", num_comp, CEED_EVAL_NONE));
27512b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionAddOutput(qf_fdm, "output", num_comp, CEED_EVAL_INTERP));
27522b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_fdm, num_comp));
27531c66c397SJeremy L Thompson 
2754eaf62fffSJeremy L Thompson   // -- QFunction context
27551c66c397SJeremy L Thompson   {
2756eaf62fffSJeremy L Thompson     CeedInt *num_comp_data;
27571c66c397SJeremy L Thompson 
27582b730f8bSJeremy L Thompson     CeedCall(CeedCalloc(1, &num_comp_data));
2759eaf62fffSJeremy L Thompson     num_comp_data[0] = num_comp;
27602b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextCreate(ceed, &ctx_fdm));
27612b730f8bSJeremy L Thompson     CeedCall(CeedQFunctionContextSetData(ctx_fdm, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_data), num_comp_data));
27621c66c397SJeremy L Thompson   }
27632b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionSetContext(qf_fdm, ctx_fdm));
27642b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionContextDestroy(&ctx_fdm));
27651c66c397SJeremy L Thompson 
2766eaf62fffSJeremy L Thompson   // -- Operator
27672b730f8bSJeremy L Thompson   CeedCall(CeedOperatorCreate(ceed_parent, qf_fdm, NULL, NULL, fdm_inv));
27682b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "input", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
2769356036faSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "scale", rstr_qd_i, CEED_BASIS_NONE, q_data));
27702b730f8bSJeremy L Thompson   CeedCall(CeedOperatorSetField(*fdm_inv, "output", rstr, fdm_basis, CEED_VECTOR_ACTIVE));
2771eaf62fffSJeremy L Thompson 
2772eaf62fffSJeremy L Thompson   // Cleanup
27732b730f8bSJeremy L Thompson   CeedCall(CeedVectorDestroy(&q_data));
27742b730f8bSJeremy L Thompson   CeedCall(CeedBasisDestroy(&fdm_basis));
27752b730f8bSJeremy L Thompson   CeedCall(CeedElemRestrictionDestroy(&rstr_qd_i));
27762b730f8bSJeremy L Thompson   CeedCall(CeedQFunctionDestroy(&qf_fdm));
2777eaf62fffSJeremy L Thompson   return CEED_ERROR_SUCCESS;
2778eaf62fffSJeremy L Thompson }
2779eaf62fffSJeremy L Thompson 
2780eaf62fffSJeremy L Thompson /// @}
2781