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