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