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