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