xref: /libCEED/backends/opt/ceed-opt-operator.c (revision a550dd668ad5fdaeaade4afb48509e4b41c51584)
1 // Copyright (c) 2017-2022, Lawrence Livermore National Security, LLC and other CEED contributors.
2 // All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
3 //
4 // SPDX-License-Identifier: BSD-2-Clause
5 //
6 // This file is part of CEED:  http://github.com/ceed
7 
8 #include <ceed.h>
9 #include <ceed/backend.h>
10 #include <stdbool.h>
11 #include <stdint.h>
12 #include <string.h>
13 
14 #include "ceed-opt.h"
15 
16 //------------------------------------------------------------------------------
17 // Setup Input/Output Fields
18 //------------------------------------------------------------------------------
19 static int CeedOperatorSetupFields_Opt(CeedQFunction qf, CeedOperator op, bool is_input, const CeedInt blk_size, CeedElemRestriction *blk_restr,
20                                        CeedVector *e_vecs_full, CeedVector *e_vecs, CeedVector *q_vecs, CeedInt start_e, CeedInt num_fields,
21                                        CeedInt Q) {
22   CeedInt  num_comp, size, P;
23   CeedSize e_size, q_size;
24   Ceed     ceed;
25   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
26   CeedBasis           basis;
27   CeedElemRestriction r;
28   CeedOperatorField  *op_fields;
29   CeedQFunctionField *qf_fields;
30   if (is_input) {
31     CeedCallBackend(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL));
32     CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL));
33   } else {
34     CeedCallBackend(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields));
35     CeedCallBackend(CeedQFunctionGetFields(qf, NULL, NULL, NULL, &qf_fields));
36   }
37 
38   // Loop over fields
39   for (CeedInt i = 0; i < num_fields; i++) {
40     CeedEvalMode eval_mode;
41     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode));
42 
43     if (eval_mode != CEED_EVAL_WEIGHT) {
44       CeedCallBackend(CeedOperatorFieldGetElemRestriction(op_fields[i], &r));
45       Ceed ceed;
46       CeedCallBackend(CeedElemRestrictionGetCeed(r, &ceed));
47       CeedSize l_size;
48       CeedInt  num_elem, elem_size, comp_stride;
49       CeedCallBackend(CeedElemRestrictionGetNumElements(r, &num_elem));
50       CeedCallBackend(CeedElemRestrictionGetElementSize(r, &elem_size));
51       CeedCallBackend(CeedElemRestrictionGetLVectorSize(r, &l_size));
52       CeedCallBackend(CeedElemRestrictionGetNumComponents(r, &num_comp));
53 
54       bool strided;
55       CeedCallBackend(CeedElemRestrictionIsStrided(r, &strided));
56       if (strided) {
57         CeedInt strides[3];
58         CeedCallBackend(CeedElemRestrictionGetStrides(r, &strides));
59         CeedCallBackend(
60             CeedElemRestrictionCreateBlockedStrided(ceed, num_elem, elem_size, blk_size, num_comp, l_size, strides, &blk_restr[i + start_e]));
61       } else {
62         const CeedInt *offsets = NULL;
63         CeedCallBackend(CeedElemRestrictionGetOffsets(r, CEED_MEM_HOST, &offsets));
64         CeedCallBackend(CeedElemRestrictionGetCompStride(r, &comp_stride));
65         CeedCallBackend(CeedElemRestrictionCreateBlocked(ceed, num_elem, elem_size, blk_size, num_comp, comp_stride, l_size, CEED_MEM_HOST,
66                                                          CEED_COPY_VALUES, offsets, &blk_restr[i + start_e]));
67         CeedCallBackend(CeedElemRestrictionRestoreOffsets(r, &offsets));
68       }
69       CeedCallBackend(CeedElemRestrictionCreateVector(blk_restr[i + start_e], NULL, &e_vecs_full[i + start_e]));
70     }
71 
72     switch (eval_mode) {
73       case CEED_EVAL_NONE:
74         CeedCallBackend(CeedQFunctionFieldGetSize(qf_fields[i], &size));
75         e_size = (CeedSize)Q * size * blk_size;
76         CeedCallBackend(CeedVectorCreate(ceed, e_size, &e_vecs[i]));
77         q_size = (CeedSize)Q * size * blk_size;
78         CeedCallBackend(CeedVectorCreate(ceed, q_size, &q_vecs[i]));
79         break;
80       case CEED_EVAL_INTERP:
81       case CEED_EVAL_GRAD:
82       case CEED_EVAL_DIV:
83       case CEED_EVAL_CURL:
84         CeedCallBackend(CeedOperatorFieldGetBasis(op_fields[i], &basis));
85         CeedCallBackend(CeedQFunctionFieldGetSize(qf_fields[i], &size));
86         CeedCallBackend(CeedBasisGetNumNodes(basis, &P));
87         CeedCallBackend(CeedBasisGetNumComponents(basis, &num_comp));
88         e_size = (CeedSize)P * num_comp * blk_size;
89         CeedCallBackend(CeedVectorCreate(ceed, e_size, &e_vecs[i]));
90         q_size = (CeedSize)Q * size * blk_size;
91         CeedCallBackend(CeedVectorCreate(ceed, q_size, &q_vecs[i]));
92         break;
93       case CEED_EVAL_WEIGHT:  // Only on input fields
94         CeedCallBackend(CeedOperatorFieldGetBasis(op_fields[i], &basis));
95         q_size = (CeedSize)Q * blk_size;
96         CeedCallBackend(CeedVectorCreate(ceed, q_size, &q_vecs[i]));
97         CeedCallBackend(CeedBasisApply(basis, blk_size, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_vecs[i]));
98         break;
99     }
100     if (is_input && !!e_vecs[i]) {
101       CeedCallBackend(CeedVectorSetArray(e_vecs[i], CEED_MEM_HOST, CEED_COPY_VALUES, NULL));
102     }
103   }
104   return CEED_ERROR_SUCCESS;
105 }
106 
107 //------------------------------------------------------------------------------
108 // Setup Operator
109 //------------------------------------------------------------------------------
110 static int CeedOperatorSetup_Opt(CeedOperator op) {
111   bool is_setup_done;
112   CeedCallBackend(CeedOperatorIsSetupDone(op, &is_setup_done));
113   if (is_setup_done) return CEED_ERROR_SUCCESS;
114   Ceed ceed;
115   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
116   Ceed_Opt *ceed_impl;
117   CeedCallBackend(CeedGetData(ceed, &ceed_impl));
118   const CeedInt     blk_size = ceed_impl->blk_size;
119   CeedOperator_Opt *impl;
120   CeedCallBackend(CeedOperatorGetData(op, &impl));
121   CeedQFunction qf;
122   CeedCallBackend(CeedOperatorGetQFunction(op, &qf));
123   CeedInt Q, num_input_fields, num_output_fields;
124   CeedCallBackend(CeedOperatorGetNumQuadraturePoints(op, &Q));
125   CeedCallBackend(CeedQFunctionIsIdentity(qf, &impl->is_identity_qf));
126   CeedOperatorField *op_input_fields, *op_output_fields;
127   CeedCallBackend(CeedOperatorGetFields(op, &num_input_fields, &op_input_fields, &num_output_fields, &op_output_fields));
128   CeedQFunctionField *qf_input_fields, *qf_output_fields;
129   CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &qf_input_fields, NULL, &qf_output_fields));
130 
131   // Allocate
132   CeedCallBackend(CeedCalloc(num_input_fields + num_output_fields, &impl->blk_restr));
133   CeedCallBackend(CeedCalloc(num_input_fields + num_output_fields, &impl->e_vecs_full));
134 
135   CeedCallBackend(CeedCalloc(CEED_FIELD_MAX, &impl->input_states));
136   CeedCallBackend(CeedCalloc(CEED_FIELD_MAX, &impl->e_vecs_in));
137   CeedCallBackend(CeedCalloc(CEED_FIELD_MAX, &impl->e_vecs_out));
138   CeedCallBackend(CeedCalloc(CEED_FIELD_MAX, &impl->q_vecs_in));
139   CeedCallBackend(CeedCalloc(CEED_FIELD_MAX, &impl->q_vecs_out));
140 
141   impl->num_inputs  = num_input_fields;
142   impl->num_outputs = num_output_fields;
143 
144   // Set up infield and outfield pointer arrays
145   // Infields
146   CeedCallBackend(CeedOperatorSetupFields_Opt(qf, op, true, blk_size, impl->blk_restr, impl->e_vecs_full, impl->e_vecs_in, impl->q_vecs_in, 0,
147                                               num_input_fields, Q));
148   // Outfields
149   CeedCallBackend(CeedOperatorSetupFields_Opt(qf, op, false, blk_size, impl->blk_restr, impl->e_vecs_full, impl->e_vecs_out, impl->q_vecs_out,
150                                               num_input_fields, num_output_fields, Q));
151 
152   // Identity QFunctions
153   if (impl->is_identity_qf) {
154     CeedEvalMode        in_mode, out_mode;
155     CeedQFunctionField *in_fields, *out_fields;
156     CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &in_fields, NULL, &out_fields));
157     CeedCallBackend(CeedQFunctionFieldGetEvalMode(in_fields[0], &in_mode));
158     CeedCallBackend(CeedQFunctionFieldGetEvalMode(out_fields[0], &out_mode));
159 
160     if (in_mode == CEED_EVAL_NONE && out_mode == CEED_EVAL_NONE) {
161       impl->is_identity_restr_op = true;
162     } else {
163       CeedCallBackend(CeedVectorDestroy(&impl->q_vecs_out[0]));
164       impl->q_vecs_out[0] = impl->q_vecs_in[0];
165       CeedCallBackend(CeedVectorAddReference(impl->q_vecs_in[0]));
166     }
167   }
168 
169   CeedCallBackend(CeedOperatorSetSetupDone(op));
170 
171   return CEED_ERROR_SUCCESS;
172 }
173 
174 //------------------------------------------------------------------------------
175 // Setup Input Fields
176 //------------------------------------------------------------------------------
177 static inline int CeedOperatorSetupInputs_Opt(CeedInt num_input_fields, CeedQFunctionField *qf_input_fields, CeedOperatorField *op_input_fields,
178                                               CeedVector in_vec, CeedScalar *e_data[2 * CEED_FIELD_MAX], CeedOperator_Opt *impl,
179                                               CeedRequest *request) {
180   CeedEvalMode eval_mode;
181   CeedVector   vec;
182   uint64_t     state;
183 
184   for (CeedInt i = 0; i < num_input_fields; i++) {
185     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_input_fields[i], &eval_mode));
186     if (eval_mode == CEED_EVAL_WEIGHT) {  // Skip
187     } else {
188       // Get input vector
189       CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
190       if (vec != CEED_VECTOR_ACTIVE) {
191         // Restrict
192         CeedCallBackend(CeedVectorGetState(vec, &state));
193         if (state != impl->input_states[i]) {
194           CeedCallBackend(CeedElemRestrictionApply(impl->blk_restr[i], CEED_NOTRANSPOSE, vec, impl->e_vecs_full[i], request));
195           impl->input_states[i] = state;
196         }
197         // Get evec
198         CeedCallBackend(CeedVectorGetArrayRead(impl->e_vecs_full[i], CEED_MEM_HOST, (const CeedScalar **)&e_data[i]));
199       } else {
200         // Set Qvec for CEED_EVAL_NONE
201         if (eval_mode == CEED_EVAL_NONE) {
202           CeedCallBackend(CeedVectorGetArrayRead(impl->e_vecs_in[i], CEED_MEM_HOST, (const CeedScalar **)&e_data[i]));
203           CeedCallBackend(CeedVectorSetArray(impl->q_vecs_in[i], CEED_MEM_HOST, CEED_USE_POINTER, e_data[i]));
204           CeedCallBackend(CeedVectorRestoreArrayRead(impl->e_vecs_in[i], (const CeedScalar **)&e_data[i]));
205         }
206       }
207     }
208   }
209   return CEED_ERROR_SUCCESS;
210 }
211 
212 //------------------------------------------------------------------------------
213 // Input Basis Action
214 //------------------------------------------------------------------------------
215 static inline int CeedOperatorInputBasis_Opt(CeedInt e, CeedInt Q, CeedQFunctionField *qf_input_fields, CeedOperatorField *op_input_fields,
216                                              CeedInt num_input_fields, CeedInt blk_size, CeedVector in_vec, bool skip_active,
217                                              CeedScalar *e_data[2 * CEED_FIELD_MAX], CeedOperator_Opt *impl, CeedRequest *request) {
218   CeedInt             elem_size, size, num_comp;
219   CeedElemRestriction elem_restr;
220   CeedEvalMode        eval_mode;
221   CeedBasis           basis;
222   CeedVector          vec;
223 
224   for (CeedInt i = 0; i < num_input_fields; i++) {
225     CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
226     // Skip active input
227     if (skip_active) {
228       if (vec == CEED_VECTOR_ACTIVE) continue;
229     }
230 
231     CeedInt active_in = 0;
232     // Get elem_size, eval_mode, size
233     CeedCallBackend(CeedOperatorFieldGetElemRestriction(op_input_fields[i], &elem_restr));
234     CeedCallBackend(CeedElemRestrictionGetElementSize(elem_restr, &elem_size));
235     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_input_fields[i], &eval_mode));
236     CeedCallBackend(CeedQFunctionFieldGetSize(qf_input_fields[i], &size));
237     // Restrict block active input
238     if (vec == CEED_VECTOR_ACTIVE) {
239       CeedCallBackend(CeedElemRestrictionApplyBlock(impl->blk_restr[i], e / blk_size, CEED_NOTRANSPOSE, in_vec, impl->e_vecs_in[i], request));
240       active_in = 1;
241     }
242     // Basis action
243     switch (eval_mode) {
244       case CEED_EVAL_NONE:
245         if (!active_in) {
246           CeedCallBackend(CeedVectorSetArray(impl->q_vecs_in[i], CEED_MEM_HOST, CEED_USE_POINTER, &e_data[i][e * Q * size]));
247         }
248         break;
249       case CEED_EVAL_INTERP:
250       case CEED_EVAL_GRAD:
251       case CEED_EVAL_DIV:
252       case CEED_EVAL_CURL:
253         CeedCallBackend(CeedOperatorFieldGetBasis(op_input_fields[i], &basis));
254         if (!active_in) {
255           CeedCallBackend(CeedBasisGetNumComponents(basis, &num_comp));
256           CeedCallBackend(CeedVectorSetArray(impl->e_vecs_in[i], CEED_MEM_HOST, CEED_USE_POINTER, &e_data[i][e * elem_size * num_comp]));
257         }
258         CeedCallBackend(CeedBasisApply(basis, blk_size, CEED_NOTRANSPOSE, eval_mode, impl->e_vecs_in[i], impl->q_vecs_in[i]));
259         break;
260       case CEED_EVAL_WEIGHT:
261         break;  // No action
262     }
263   }
264   return CEED_ERROR_SUCCESS;
265 }
266 
267 //------------------------------------------------------------------------------
268 // Output Basis Action
269 //------------------------------------------------------------------------------
270 static inline int CeedOperatorOutputBasis_Opt(CeedInt e, CeedInt Q, CeedQFunctionField *qf_output_fields, CeedOperatorField *op_output_fields,
271                                               CeedInt blk_size, CeedInt num_input_fields, CeedInt num_output_fields, CeedOperator op,
272                                               CeedVector out_vec, CeedOperator_Opt *impl, CeedRequest *request) {
273   CeedElemRestriction elem_restr;
274   CeedEvalMode        eval_mode;
275   CeedBasis           basis;
276   CeedVector          vec;
277 
278   for (CeedInt i = 0; i < num_output_fields; i++) {
279     // Get elem_size, eval_mode, size
280     CeedCallBackend(CeedOperatorFieldGetElemRestriction(op_output_fields[i], &elem_restr));
281     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_output_fields[i], &eval_mode));
282     // Basis action
283     switch (eval_mode) {
284       case CEED_EVAL_NONE:
285         break;  // No action
286       case CEED_EVAL_INTERP:
287       case CEED_EVAL_GRAD:
288       case CEED_EVAL_DIV:
289       case CEED_EVAL_CURL:
290         CeedCallBackend(CeedOperatorFieldGetBasis(op_output_fields[i], &basis));
291         CeedCallBackend(CeedBasisApply(basis, blk_size, CEED_TRANSPOSE, eval_mode, impl->q_vecs_out[i], impl->e_vecs_out[i]));
292         break;
293       // LCOV_EXCL_START
294       case CEED_EVAL_WEIGHT: {
295         Ceed ceed;
296         CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
297         return CeedError(ceed, CEED_ERROR_BACKEND,
298                          "CEED_EVAL_WEIGHT cannot be an output "
299                          "evaluation mode");
300         // LCOV_EXCL_STOP
301       }
302     }
303     // Restrict output block
304     // Get output vector
305     CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[i], &vec));
306     if (vec == CEED_VECTOR_ACTIVE) vec = out_vec;
307     // Restrict
308     CeedCallBackend(
309         CeedElemRestrictionApplyBlock(impl->blk_restr[i + impl->num_inputs], e / blk_size, CEED_TRANSPOSE, impl->e_vecs_out[i], vec, request));
310   }
311   return CEED_ERROR_SUCCESS;
312 }
313 
314 //------------------------------------------------------------------------------
315 // Restore Input Vectors
316 //------------------------------------------------------------------------------
317 static inline int CeedOperatorRestoreInputs_Opt(CeedInt num_input_fields, CeedQFunctionField *qf_input_fields, CeedOperatorField *op_input_fields,
318                                                 CeedScalar *e_data[2 * CEED_FIELD_MAX], CeedOperator_Opt *impl) {
319   for (CeedInt i = 0; i < num_input_fields; i++) {
320     CeedEvalMode eval_mode;
321     CeedVector   vec;
322     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_input_fields[i], &eval_mode));
323     CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
324     if (eval_mode != CEED_EVAL_WEIGHT && vec != CEED_VECTOR_ACTIVE) {
325       CeedCallBackend(CeedVectorRestoreArrayRead(impl->e_vecs_full[i], (const CeedScalar **)&e_data[i]));
326     }
327   }
328   return CEED_ERROR_SUCCESS;
329 }
330 
331 //------------------------------------------------------------------------------
332 // Operator Apply
333 //------------------------------------------------------------------------------
334 static int CeedOperatorApplyAdd_Opt(CeedOperator op, CeedVector in_vec, CeedVector out_vec, CeedRequest *request) {
335   Ceed ceed;
336   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
337   Ceed_Opt *ceed_impl;
338   CeedCallBackend(CeedGetData(ceed, &ceed_impl));
339   CeedInt           blk_size = ceed_impl->blk_size;
340   CeedOperator_Opt *impl;
341   CeedCallBackend(CeedOperatorGetData(op, &impl));
342   CeedInt Q, num_input_fields, num_output_fields, num_elem;
343   CeedCallBackend(CeedOperatorGetNumElements(op, &num_elem));
344   CeedCallBackend(CeedOperatorGetNumQuadraturePoints(op, &Q));
345   CeedInt       num_blks = (num_elem / blk_size) + !!(num_elem % blk_size);
346   CeedQFunction qf;
347   CeedCallBackend(CeedOperatorGetQFunction(op, &qf));
348   CeedOperatorField *op_input_fields, *op_output_fields;
349   CeedCallBackend(CeedOperatorGetFields(op, &num_input_fields, &op_input_fields, &num_output_fields, &op_output_fields));
350   CeedQFunctionField *qf_input_fields, *qf_output_fields;
351   CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &qf_input_fields, NULL, &qf_output_fields));
352   CeedEvalMode eval_mode;
353   CeedScalar  *e_data[2 * CEED_FIELD_MAX] = {0};
354 
355   // Setup
356   CeedCallBackend(CeedOperatorSetup_Opt(op));
357 
358   // Restriction only operator
359   if (impl->is_identity_restr_op) {
360     for (CeedInt b = 0; b < num_blks; b++) {
361       CeedCallBackend(CeedElemRestrictionApplyBlock(impl->blk_restr[0], b, CEED_NOTRANSPOSE, in_vec, impl->e_vecs_in[0], request));
362       CeedCallBackend(CeedElemRestrictionApplyBlock(impl->blk_restr[1], b, CEED_TRANSPOSE, impl->e_vecs_in[0], out_vec, request));
363     }
364     return CEED_ERROR_SUCCESS;
365   }
366 
367   // Input Evecs and Restriction
368   CeedCallBackend(CeedOperatorSetupInputs_Opt(num_input_fields, qf_input_fields, op_input_fields, in_vec, e_data, impl, request));
369 
370   // Output Lvecs, Evecs, and Qvecs
371   for (CeedInt i = 0; i < num_output_fields; i++) {
372     // Set Qvec if needed
373     CeedCallBackend(CeedQFunctionFieldGetEvalMode(qf_output_fields[i], &eval_mode));
374     if (eval_mode == CEED_EVAL_NONE) {
375       // Set qvec to single block evec
376       CeedCallBackend(CeedVectorGetArrayWrite(impl->e_vecs_out[i], CEED_MEM_HOST, &e_data[i + num_input_fields]));
377       CeedCallBackend(CeedVectorSetArray(impl->q_vecs_out[i], CEED_MEM_HOST, CEED_USE_POINTER, e_data[i + num_input_fields]));
378       CeedCallBackend(CeedVectorRestoreArray(impl->e_vecs_out[i], &e_data[i + num_input_fields]));
379     }
380   }
381 
382   // Loop through elements
383   for (CeedInt e = 0; e < num_blks * blk_size; e += blk_size) {
384     // Input basis apply
385     CeedCallBackend(
386         CeedOperatorInputBasis_Opt(e, Q, qf_input_fields, op_input_fields, num_input_fields, blk_size, in_vec, false, e_data, impl, request));
387 
388     // Q function
389     if (!impl->is_identity_qf) {
390       CeedCallBackend(CeedQFunctionApply(qf, Q * blk_size, impl->q_vecs_in, impl->q_vecs_out));
391     }
392 
393     // Output basis apply and restrict
394     CeedCallBackend(CeedOperatorOutputBasis_Opt(e, Q, qf_output_fields, op_output_fields, blk_size, num_input_fields, num_output_fields, op, out_vec,
395                                                 impl, request));
396   }
397 
398   // Restore input arrays
399   CeedCallBackend(CeedOperatorRestoreInputs_Opt(num_input_fields, qf_input_fields, op_input_fields, e_data, impl));
400 
401   return CEED_ERROR_SUCCESS;
402 }
403 
404 //------------------------------------------------------------------------------
405 // Core code for linear QFunction assembly
406 //------------------------------------------------------------------------------
407 static inline int CeedOperatorLinearAssembleQFunctionCore_Opt(CeedOperator op, bool build_objects, CeedVector *assembled, CeedElemRestriction *rstr,
408                                                               CeedRequest *request) {
409   Ceed ceed;
410   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
411   Ceed_Opt *ceed_impl;
412   CeedCallBackend(CeedGetData(ceed, &ceed_impl));
413   const CeedInt     blk_size = ceed_impl->blk_size;
414   CeedSize          q_size;
415   CeedOperator_Opt *impl;
416   CeedCallBackend(CeedOperatorGetData(op, &impl));
417   CeedInt Q, num_input_fields, num_output_fields, num_elem, size;
418   CeedCallBackend(CeedOperatorGetNumElements(op, &num_elem));
419   CeedCallBackend(CeedOperatorGetNumQuadraturePoints(op, &Q));
420   CeedInt       num_blks = (num_elem / blk_size) + !!(num_elem % blk_size);
421   CeedQFunction qf;
422   CeedCallBackend(CeedOperatorGetQFunction(op, &qf));
423   CeedOperatorField *op_input_fields, *op_output_fields;
424   CeedCallBackend(CeedOperatorGetFields(op, &num_input_fields, &op_input_fields, &num_output_fields, &op_output_fields));
425   CeedQFunctionField *qf_input_fields, *qf_output_fields;
426   CeedCallBackend(CeedQFunctionGetFields(qf, NULL, &qf_input_fields, NULL, &qf_output_fields));
427   CeedVector  vec, l_vec = impl->qf_l_vec;
428   CeedInt     num_active_in = impl->num_active_in, num_active_out = impl->num_active_out;
429   CeedVector *active_in = impl->qf_active_in;
430   CeedScalar *a, *tmp;
431   CeedScalar *e_data[2 * CEED_FIELD_MAX] = {0};
432 
433   // Setup
434   CeedCallBackend(CeedOperatorSetup_Opt(op));
435 
436   // Check for identity
437   if (impl->is_identity_qf) {
438     // LCOV_EXCL_START
439     return CeedError(ceed, CEED_ERROR_BACKEND, "Assembling identity qfunctions not supported");
440     // LCOV_EXCL_STOP
441   }
442 
443   // Input Evecs and Restriction
444   CeedCallBackend(CeedOperatorSetupInputs_Opt(num_input_fields, qf_input_fields, op_input_fields, NULL, e_data, impl, request));
445 
446   // Count number of active input fields
447   if (!num_active_in) {
448     for (CeedInt i = 0; i < num_input_fields; i++) {
449       // Get input vector
450       CeedCallBackend(CeedOperatorFieldGetVector(op_input_fields[i], &vec));
451       // Check if active input
452       if (vec == CEED_VECTOR_ACTIVE) {
453         CeedCallBackend(CeedQFunctionFieldGetSize(qf_input_fields[i], &size));
454         CeedCallBackend(CeedVectorSetValue(impl->q_vecs_in[i], 0.0));
455         CeedCallBackend(CeedVectorGetArray(impl->q_vecs_in[i], CEED_MEM_HOST, &tmp));
456         CeedCallBackend(CeedRealloc(num_active_in + size, &active_in));
457         for (CeedInt field = 0; field < size; field++) {
458           q_size = (CeedSize)Q * blk_size;
459           CeedCallBackend(CeedVectorCreate(ceed, q_size, &active_in[num_active_in + field]));
460           CeedCallBackend(CeedVectorSetArray(active_in[num_active_in + field], CEED_MEM_HOST, CEED_USE_POINTER, &tmp[field * Q * blk_size]));
461         }
462         num_active_in += size;
463         CeedCallBackend(CeedVectorRestoreArray(impl->q_vecs_in[i], &tmp));
464       }
465     }
466     impl->num_active_in = num_active_in;
467     impl->qf_active_in  = active_in;
468   }
469 
470   // Count number of active output fields
471   if (!num_active_out) {
472     for (CeedInt i = 0; i < num_output_fields; i++) {
473       // Get output vector
474       CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[i], &vec));
475       // Check if active output
476       if (vec == CEED_VECTOR_ACTIVE) {
477         CeedCallBackend(CeedQFunctionFieldGetSize(qf_output_fields[i], &size));
478         num_active_out += size;
479       }
480     }
481     impl->num_active_out = num_active_out;
482   }
483 
484   // Check sizes
485   if (!num_active_in || !num_active_out) {
486     // LCOV_EXCL_START
487     return CeedError(ceed, CEED_ERROR_BACKEND, "Cannot assemble QFunction without active inputs and outputs");
488     // LCOV_EXCL_STOP
489   }
490 
491   // Setup l_vec
492   if (!l_vec) {
493     CeedSize l_size = (CeedSize)blk_size * Q * num_active_in * num_active_out;
494     CeedCallBackend(CeedVectorCreate(ceed, l_size, &l_vec));
495     CeedCallBackend(CeedVectorSetValue(l_vec, 0.0));
496     impl->qf_l_vec = l_vec;
497   }
498 
499   // Build objects if needed
500   CeedInt strides[3] = {1, Q, num_active_in * num_active_out * Q};
501   if (build_objects) {
502     // Create output restriction
503     CeedCallBackend(CeedElemRestrictionCreateStrided(ceed, num_elem, Q, num_active_in * num_active_out, num_active_in * num_active_out * num_elem * Q,
504                                                      strides, rstr));
505     // Create assembled vector
506     CeedSize l_size = (CeedSize)num_elem * Q * num_active_in * num_active_out;
507     CeedCallBackend(CeedVectorCreate(ceed, l_size, assembled));
508   }
509 
510   // Output blocked restriction
511   CeedElemRestriction blk_rstr = impl->qf_blk_rstr;
512   if (!blk_rstr) {
513     CeedCallBackend(CeedElemRestrictionCreateBlockedStrided(ceed, num_elem, Q, blk_size, num_active_in * num_active_out,
514                                                             num_active_in * num_active_out * num_elem * Q, strides, &blk_rstr));
515     impl->qf_blk_rstr = blk_rstr;
516   }
517 
518   // Loop through elements
519   CeedCallBackend(CeedVectorSetValue(*assembled, 0.0));
520   for (CeedInt e = 0; e < num_blks * blk_size; e += blk_size) {
521     CeedCallBackend(CeedVectorGetArray(l_vec, CEED_MEM_HOST, &a));
522 
523     // Input basis apply
524     CeedCallBackend(
525         CeedOperatorInputBasis_Opt(e, Q, qf_input_fields, op_input_fields, num_input_fields, blk_size, NULL, true, e_data, impl, request));
526 
527     // Assemble QFunction
528     for (CeedInt in = 0; in < num_active_in; in++) {
529       // Set Inputs
530       CeedCallBackend(CeedVectorSetValue(active_in[in], 1.0));
531       if (num_active_in > 1) {
532         CeedCallBackend(CeedVectorSetValue(active_in[(in + num_active_in - 1) % num_active_in], 0.0));
533       }
534       // Set Outputs
535       for (CeedInt out = 0; out < num_output_fields; out++) {
536         // Get output vector
537         CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[out], &vec));
538         // Check if active output
539         if (vec == CEED_VECTOR_ACTIVE) {
540           CeedCallBackend(CeedVectorSetArray(impl->q_vecs_out[out], CEED_MEM_HOST, CEED_USE_POINTER, a));
541           CeedCallBackend(CeedQFunctionFieldGetSize(qf_output_fields[out], &size));
542           a += size * Q * blk_size;  // Advance the pointer by the size of the output
543         }
544       }
545       // Apply QFunction
546       CeedCallBackend(CeedQFunctionApply(qf, Q * blk_size, impl->q_vecs_in, impl->q_vecs_out));
547     }
548 
549     // Assemble into assembled vector
550     CeedCallBackend(CeedVectorRestoreArray(l_vec, &a));
551     CeedCallBackend(CeedElemRestrictionApplyBlock(blk_rstr, e / blk_size, CEED_TRANSPOSE, l_vec, *assembled, request));
552   }
553 
554   // Un-set output Qvecs to prevent accidental overwrite of Assembled
555   for (CeedInt out = 0; out < num_output_fields; out++) {
556     // Get output vector
557     CeedCallBackend(CeedOperatorFieldGetVector(op_output_fields[out], &vec));
558     // Check if active output
559     if (vec == CEED_VECTOR_ACTIVE) {
560       CeedCallBackend(CeedVectorSetArray(impl->q_vecs_out[out], CEED_MEM_HOST, CEED_COPY_VALUES, NULL));
561     }
562   }
563 
564   // Restore input arrays
565   CeedCallBackend(CeedOperatorRestoreInputs_Opt(num_input_fields, qf_input_fields, op_input_fields, e_data, impl));
566 
567   return CEED_ERROR_SUCCESS;
568 }
569 
570 //------------------------------------------------------------------------------
571 // Assemble Linear QFunction
572 //------------------------------------------------------------------------------
573 static int CeedOperatorLinearAssembleQFunction_Opt(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
574   return CeedOperatorLinearAssembleQFunctionCore_Opt(op, true, assembled, rstr, request);
575 }
576 
577 //------------------------------------------------------------------------------
578 // Update Assembled Linear QFunction
579 //------------------------------------------------------------------------------
580 static int CeedOperatorLinearAssembleQFunctionUpdate_Opt(CeedOperator op, CeedVector assembled, CeedElemRestriction rstr, CeedRequest *request) {
581   return CeedOperatorLinearAssembleQFunctionCore_Opt(op, false, &assembled, &rstr, request);
582 }
583 
584 //------------------------------------------------------------------------------
585 // Operator Destroy
586 //------------------------------------------------------------------------------
587 static int CeedOperatorDestroy_Opt(CeedOperator op) {
588   CeedOperator_Opt *impl;
589   CeedCallBackend(CeedOperatorGetData(op, &impl));
590 
591   for (CeedInt i = 0; i < impl->num_inputs + impl->num_outputs; i++) {
592     CeedCallBackend(CeedElemRestrictionDestroy(&impl->blk_restr[i]));
593     CeedCallBackend(CeedVectorDestroy(&impl->e_vecs_full[i]));
594   }
595   CeedCallBackend(CeedFree(&impl->blk_restr));
596   CeedCallBackend(CeedFree(&impl->e_vecs_full));
597   CeedCallBackend(CeedFree(&impl->input_states));
598 
599   for (CeedInt i = 0; i < impl->num_inputs; i++) {
600     CeedCallBackend(CeedVectorDestroy(&impl->e_vecs_in[i]));
601     CeedCallBackend(CeedVectorDestroy(&impl->q_vecs_in[i]));
602   }
603   CeedCallBackend(CeedFree(&impl->e_vecs_in));
604   CeedCallBackend(CeedFree(&impl->q_vecs_in));
605 
606   for (CeedInt i = 0; i < impl->num_outputs; i++) {
607     CeedCallBackend(CeedVectorDestroy(&impl->e_vecs_out[i]));
608     CeedCallBackend(CeedVectorDestroy(&impl->q_vecs_out[i]));
609   }
610   CeedCallBackend(CeedFree(&impl->e_vecs_out));
611   CeedCallBackend(CeedFree(&impl->q_vecs_out));
612 
613   // QFunction assembly data
614   for (CeedInt i = 0; i < impl->num_active_in; i++) {
615     CeedCallBackend(CeedVectorDestroy(&impl->qf_active_in[i]));
616   }
617   CeedCallBackend(CeedFree(&impl->qf_active_in));
618   CeedCallBackend(CeedVectorDestroy(&impl->qf_l_vec));
619   CeedCallBackend(CeedElemRestrictionDestroy(&impl->qf_blk_rstr));
620 
621   CeedCallBackend(CeedFree(&impl));
622   return CEED_ERROR_SUCCESS;
623 }
624 
625 //------------------------------------------------------------------------------
626 // Operator Create
627 //------------------------------------------------------------------------------
628 int CeedOperatorCreate_Opt(CeedOperator op) {
629   Ceed ceed;
630   CeedCallBackend(CeedOperatorGetCeed(op, &ceed));
631   Ceed_Opt *ceed_impl;
632   CeedCallBackend(CeedGetData(ceed, &ceed_impl));
633   CeedInt           blk_size = ceed_impl->blk_size;
634   CeedOperator_Opt *impl;
635 
636   CeedCallBackend(CeedCalloc(1, &impl));
637   CeedCallBackend(CeedOperatorSetData(op, impl));
638 
639   if (blk_size != 1 && blk_size != 8) {
640     // LCOV_EXCL_START
641     return CeedError(ceed, CEED_ERROR_BACKEND, "Opt backend cannot use blocksize: %" CeedInt_FMT, blk_size);
642     // LCOV_EXCL_STOP
643   }
644 
645   CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "LinearAssembleQFunction", CeedOperatorLinearAssembleQFunction_Opt));
646   CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "LinearAssembleQFunctionUpdate", CeedOperatorLinearAssembleQFunctionUpdate_Opt));
647   CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "ApplyAdd", CeedOperatorApplyAdd_Opt));
648   CeedCallBackend(CeedSetBackendFunction(ceed, "Operator", op, "Destroy", CeedOperatorDestroy_Opt));
649   return CEED_ERROR_SUCCESS;
650 }
651 
652 //------------------------------------------------------------------------------
653