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