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