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