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