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