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