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