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