xref: /libCEED/backends/ref/ceed-ref-operator.c (revision 7172caad75bd388183c6aa46b2472fa01d320a20) 
1 // Copyright (c) 2017-2018, Lawrence Livermore National Security, LLC.
2 // Produced at the Lawrence Livermore National Laboratory. LLNL-CODE-734707.
3 // All Rights reserved. See files LICENSE and NOTICE for details.
4 //
5 // This file is part of CEED, a collection of benchmarks, miniapps, software
6 // libraries and APIs for efficient high-order finite element and spectral
7 // element discretizations for exascale applications. For more information and
8 // source code availability see http://github.com/ceed.
9 //
10 // The CEED research is supported by the Exascale Computing Project 17-SC-20-SC,
11 // a collaborative effort of two U.S. Department of Energy organizations (Office
12 // of Science and the National Nuclear Security Administration) responsible for
13 // the planning and preparation of a capable exascale ecosystem, including
14 // software, applications, hardware, advanced system engineering and early
15 // testbed platforms, in support of the nation's exascale computing imperative.
16 
17 #include "ceed-ref.h"
18 
19 static int CeedOperatorDestroy_Ref(CeedOperator op) {
20   int ierr;
21   CeedOperator_Ref *impl;
22   ierr = CeedOperatorGetData(op, (void *)&impl); CeedChk(ierr);
23 
24   for (CeedInt i=0; i<impl->numein+impl->numeout; i++) {
25     ierr = CeedVectorDestroy(&impl->evecs[i]); CeedChk(ierr);
26   }
27   ierr = CeedFree(&impl->evecs); CeedChk(ierr);
28   ierr = CeedFree(&impl->edata); CeedChk(ierr);
29   ierr = CeedFree(&impl->inputstate); CeedChk(ierr);
30 
31   for (CeedInt i=0; i<impl->numein; i++) {
32     ierr = CeedVectorDestroy(&impl->evecsin[i]); CeedChk(ierr);
33     ierr = CeedVectorDestroy(&impl->qvecsin[i]); CeedChk(ierr);
34   }
35   ierr = CeedFree(&impl->evecsin); CeedChk(ierr);
36   ierr = CeedFree(&impl->qvecsin); CeedChk(ierr);
37 
38   for (CeedInt i=0; i<impl->numeout; i++) {
39     ierr = CeedVectorDestroy(&impl->evecsout[i]); CeedChk(ierr);
40     ierr = CeedVectorDestroy(&impl->qvecsout[i]); CeedChk(ierr);
41   }
42   ierr = CeedFree(&impl->evecsout); CeedChk(ierr);
43   ierr = CeedFree(&impl->qvecsout); CeedChk(ierr);
44 
45   ierr = CeedFree(&impl); CeedChk(ierr);
46   return 0;
47 }
48 
49 /*
50   Setup infields or outfields
51  */
52 static int CeedOperatorSetupFields_Ref(CeedQFunction qf, CeedOperator op,
53                                        bool inOrOut,
54                                        CeedVector *fullevecs, CeedVector *evecs,
55                                        CeedVector *qvecs, CeedInt starte,
56                                        CeedInt numfields, CeedInt Q) {
57   CeedInt dim, ierr, size, P;
58   Ceed ceed;
59   ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
60   CeedBasis basis;
61   CeedElemRestriction Erestrict;
62   CeedOperatorField *opfields;
63   CeedQFunctionField *qffields;
64   if (inOrOut) {
65     ierr = CeedOperatorGetFields(op, NULL, &opfields); CeedChk(ierr);
66     ierr = CeedQFunctionGetFields(qf, NULL, &qffields); CeedChk(ierr);
67   } else {
68     ierr = CeedOperatorGetFields(op, &opfields, NULL); CeedChk(ierr);
69     ierr = CeedQFunctionGetFields(qf, &qffields, NULL); CeedChk(ierr);
70   }
71 
72   // Loop over fields
73   for (CeedInt i=0; i<numfields; i++) {
74     CeedEvalMode emode;
75     ierr = CeedQFunctionFieldGetEvalMode(qffields[i], &emode); CeedChk(ierr);
76 
77     if (emode != CEED_EVAL_WEIGHT) {
78       ierr = CeedOperatorFieldGetElemRestriction(opfields[i], &Erestrict);
79       CeedChk(ierr);
80       ierr = CeedElemRestrictionCreateVector(Erestrict, NULL,
81                                              &fullevecs[i+starte]);
82       CeedChk(ierr);
83     }
84 
85     switch(emode) {
86     case CEED_EVAL_NONE:
87       ierr = CeedQFunctionFieldGetSize(qffields[i], &size); CeedChk(ierr);
88       ierr = CeedVectorCreate(ceed, Q*size, &qvecs[i]); CeedChk(ierr);
89       break;
90     case CEED_EVAL_INTERP:
91       ierr = CeedQFunctionFieldGetSize(qffields[i], &size); CeedChk(ierr);
92       ierr = CeedElemRestrictionGetElementSize(Erestrict, &P);
93       CeedChk(ierr);
94       ierr = CeedVectorCreate(ceed, P*size, &evecs[i]); CeedChk(ierr);
95       ierr = CeedVectorCreate(ceed, Q*size, &qvecs[i]); CeedChk(ierr);
96       break;
97     case CEED_EVAL_GRAD:
98       ierr = CeedOperatorFieldGetBasis(opfields[i], &basis); CeedChk(ierr);
99       ierr = CeedQFunctionFieldGetSize(qffields[i], &size); CeedChk(ierr);
100       ierr = CeedBasisGetDimension(basis, &dim); CeedChk(ierr);
101       ierr = CeedElemRestrictionGetElementSize(Erestrict, &P);
102       CeedChk(ierr);
103       ierr = CeedVectorCreate(ceed, P*size/dim, &evecs[i]); CeedChk(ierr);
104       ierr = CeedVectorCreate(ceed, Q*size, &qvecs[i]); CeedChk(ierr);
105       break;
106     case CEED_EVAL_WEIGHT: // Only on input fields
107       ierr = CeedOperatorFieldGetBasis(opfields[i], &basis); CeedChk(ierr);
108       ierr = CeedVectorCreate(ceed, Q, &qvecs[i]); CeedChk(ierr);
109       ierr = CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT,
110                             CEED_VECTOR_NONE, qvecs[i]); CeedChk(ierr);
111       break;
112     case CEED_EVAL_DIV:
113       break; // Not implemented
114     case CEED_EVAL_CURL:
115       break; // Not implemented
116     }
117   }
118   return 0;
119 }
120 
121 /*
122   CeedOperator needs to connect all the named fields (be they active or passive)
123   to the named inputs and outputs of its CeedQFunction.
124  */
125 static int CeedOperatorSetup_Ref(CeedOperator op) {
126   int ierr;
127   bool setupdone;
128   ierr = CeedOperatorGetSetupStatus(op, &setupdone); CeedChk(ierr);
129   if (setupdone) return 0;
130   Ceed ceed;
131   ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
132   CeedOperator_Ref *impl;
133   ierr = CeedOperatorGetData(op, (void *)&impl); CeedChk(ierr);
134   CeedQFunction qf;
135   ierr = CeedOperatorGetQFunction(op, &qf); CeedChk(ierr);
136   CeedInt Q, numinputfields, numoutputfields;
137   ierr = CeedOperatorGetNumQuadraturePoints(op, &Q); CeedChk(ierr);
138   ierr = CeedQFunctionGetIdentityStatus(qf, &impl->identityqf); CeedChk(ierr);
139   ierr = CeedQFunctionGetNumArgs(qf, &numinputfields, &numoutputfields);
140   CeedChk(ierr);
141   CeedOperatorField *opinputfields, *opoutputfields;
142   ierr = CeedOperatorGetFields(op, &opinputfields, &opoutputfields);
143   CeedChk(ierr);
144   CeedQFunctionField *qfinputfields, *qfoutputfields;
145   ierr = CeedQFunctionGetFields(qf, &qfinputfields, &qfoutputfields);
146   CeedChk(ierr);
147 
148   // Allocate
149   ierr = CeedCalloc(numinputfields + numoutputfields, &impl->evecs);
150   CeedChk(ierr);
151   ierr = CeedCalloc(numinputfields + numoutputfields, &impl->edata);
152   CeedChk(ierr);
153 
154   ierr = CeedCalloc(16, &impl->inputstate); CeedChk(ierr);
155   ierr = CeedCalloc(16, &impl->evecsin); CeedChk(ierr);
156   ierr = CeedCalloc(16, &impl->evecsout); CeedChk(ierr);
157   ierr = CeedCalloc(16, &impl->qvecsin); CeedChk(ierr);
158   ierr = CeedCalloc(16, &impl->qvecsout); CeedChk(ierr);
159 
160   impl->numein = numinputfields; impl->numeout = numoutputfields;
161 
162   // Set up infield and outfield evecs and qvecs
163   // Infields
164   ierr = CeedOperatorSetupFields_Ref(qf, op, 0, impl->evecs,
165                                      impl->evecsin, impl->qvecsin, 0,
166                                      numinputfields, Q);
167   CeedChk(ierr);
168   // Outfields
169   ierr = CeedOperatorSetupFields_Ref(qf, op, 1, impl->evecs,
170                                      impl->evecsout, impl->qvecsout,
171                                      numinputfields, numoutputfields, Q);
172   CeedChk(ierr);
173 
174   // Identity QFunctions
175   if (impl->identityqf) {
176     CeedEvalMode inmode, outmode;
177     CeedQFunctionField *infields, *outfields;
178     ierr = CeedQFunctionGetFields(qf, &infields, &outfields); CeedChk(ierr);
179 
180     for (CeedInt i=0; i<numinputfields; i++) {
181       ierr = CeedQFunctionFieldGetEvalMode(infields[i], &inmode);
182       CeedChk(ierr);
183       ierr = CeedQFunctionFieldGetEvalMode(outfields[i], &outmode);
184       CeedChk(ierr);
185 
186       ierr = CeedVectorDestroy(&impl->qvecsout[i]); CeedChk(ierr);
187       impl->qvecsout[i] = impl->qvecsin[i];
188       ierr = CeedVectorAddReference(impl->qvecsin[i]); CeedChk(ierr);
189     }
190   }
191 
192   ierr = CeedOperatorSetSetupDone(op); CeedChk(ierr);
193 
194   return 0;
195 }
196 
197 // Setup Input fields
198 static inline int CeedOperatorSetupInputs_Ref(CeedInt numinputfields,
199     CeedQFunctionField *qfinputfields, CeedOperatorField *opinputfields,
200     CeedVector invec, const bool skipactive, CeedOperator_Ref *impl,
201     CeedRequest *request) {
202   CeedInt ierr;
203   CeedEvalMode emode;
204   CeedVector vec;
205   CeedElemRestriction Erestrict;
206   CeedTransposeMode lmode;
207   uint64_t state;
208 
209   for (CeedInt i=0; i<numinputfields; i++) {
210     // Get input vector
211     ierr = CeedOperatorFieldGetVector(opinputfields[i], &vec); CeedChk(ierr);
212     if (vec == CEED_VECTOR_ACTIVE) {
213       if (skipactive)
214         continue;
215       else
216         vec = invec;
217     }
218 
219     ierr = CeedQFunctionFieldGetEvalMode(qfinputfields[i], &emode);
220     CeedChk(ierr);
221     // Restrict and Evec
222     if (emode == CEED_EVAL_WEIGHT) { // Skip
223     } else {
224       // Restrict
225       ierr = CeedVectorGetState(vec, &state); CeedChk(ierr);
226       // Skip restriction if input is unchanged
227       if (state != impl->inputstate[i] || vec == invec) {
228         ierr = CeedOperatorFieldGetElemRestriction(opinputfields[i], &Erestrict);
229         CeedChk(ierr);
230         ierr = CeedOperatorFieldGetLMode(opinputfields[i], &lmode);
231         CeedChk(ierr);
232         ierr = CeedElemRestrictionApply(Erestrict, CEED_NOTRANSPOSE,
233                                         lmode, vec, impl->evecs[i],
234                                         request); CeedChk(ierr);
235         impl->inputstate[i] = state;
236       }
237       // Get evec
238       ierr = CeedVectorGetArrayRead(impl->evecs[i], CEED_MEM_HOST,
239                                     (const CeedScalar **) &impl->edata[i]);
240       CeedChk(ierr);
241     }
242   }
243   return 0;
244 }
245 
246 // Input basis action
247 static inline int CeedOperatorInputBasis_Ref(CeedInt e, CeedInt Q,
248     CeedQFunctionField *qfinputfields, CeedOperatorField *opinputfields,
249     CeedInt numinputfields, const bool skipactive, CeedOperator_Ref *impl) {
250   CeedInt ierr;
251   CeedInt dim, elemsize, size;
252   CeedElemRestriction Erestrict;
253   CeedEvalMode emode;
254   CeedBasis basis;
255 
256   for (CeedInt i=0; i<numinputfields; i++) {
257     // Skip active input
258     if (skipactive) {
259       CeedVector vec;
260       ierr = CeedOperatorFieldGetVector(opinputfields[i], &vec); CeedChk(ierr);
261       if (vec == CEED_VECTOR_ACTIVE)
262         continue;
263     }
264     // Get elemsize, emode, size
265     ierr = CeedOperatorFieldGetElemRestriction(opinputfields[i], &Erestrict);
266     CeedChk(ierr);
267     ierr = CeedElemRestrictionGetElementSize(Erestrict, &elemsize);
268     CeedChk(ierr);
269     ierr = CeedQFunctionFieldGetEvalMode(qfinputfields[i], &emode);
270     CeedChk(ierr);
271     ierr = CeedQFunctionFieldGetSize(qfinputfields[i], &size); CeedChk(ierr);
272     // Basis action
273     switch(emode) {
274     case CEED_EVAL_NONE:
275       ierr = CeedVectorSetArray(impl->qvecsin[i], CEED_MEM_HOST,
276                                 CEED_USE_POINTER,
277                                 &impl->edata[i][e*Q*size]); CeedChk(ierr);
278       break;
279     case CEED_EVAL_INTERP:
280       ierr = CeedOperatorFieldGetBasis(opinputfields[i], &basis); CeedChk(ierr);
281       ierr = CeedVectorSetArray(impl->evecsin[i], CEED_MEM_HOST,
282                                 CEED_USE_POINTER,
283                                 &impl->edata[i][e*elemsize*size]);
284       CeedChk(ierr);
285       ierr = CeedBasisApply(basis, 1, CEED_NOTRANSPOSE,
286                             CEED_EVAL_INTERP, impl->evecsin[i],
287                             impl->qvecsin[i]); CeedChk(ierr);
288       break;
289     case CEED_EVAL_GRAD:
290       ierr = CeedOperatorFieldGetBasis(opinputfields[i], &basis); CeedChk(ierr);
291       ierr = CeedBasisGetDimension(basis, &dim); CeedChk(ierr);
292       ierr = CeedVectorSetArray(impl->evecsin[i], CEED_MEM_HOST,
293                                 CEED_USE_POINTER,
294                                 &impl->edata[i][e*elemsize*size/dim]);
295       CeedChk(ierr);
296       ierr = CeedBasisApply(basis, 1, CEED_NOTRANSPOSE,
297                             CEED_EVAL_GRAD, impl->evecsin[i],
298                             impl->qvecsin[i]); CeedChk(ierr);
299       break;
300     case CEED_EVAL_WEIGHT:
301       break;  // No action
302     case CEED_EVAL_DIV:
303     case CEED_EVAL_CURL: {
304       // LCOV_EXCL_START
305       ierr = CeedOperatorFieldGetBasis(opinputfields[i], &basis);
306       CeedChk(ierr);
307       Ceed ceed;
308       ierr = CeedBasisGetCeed(basis, &ceed); CeedChk(ierr);
309       return CeedError(ceed, 1, "Ceed evaluation mode not implemented");
310       // LCOV_EXCL_STOP
311       break; // Not implemented
312     }
313     }
314   }
315   return 0;
316 }
317 
318 // Output basis action
319 static inline int CeedOperatorOutputBasis_Ref(CeedInt e, CeedInt Q,
320     CeedQFunctionField *qfoutputfields, CeedOperatorField *opoutputfields,
321     CeedInt numinputfields, CeedInt numoutputfields, CeedOperator op,
322     CeedOperator_Ref *impl) {
323   CeedInt ierr;
324   CeedInt dim, elemsize, size;
325   CeedElemRestriction Erestrict;
326   CeedEvalMode emode;
327   CeedBasis basis;
328 
329   for (CeedInt i=0; i<numoutputfields; i++) {
330     // Get elemsize, emode, size
331     ierr = CeedOperatorFieldGetElemRestriction(opoutputfields[i], &Erestrict);
332     CeedChk(ierr);
333     ierr = CeedElemRestrictionGetElementSize(Erestrict, &elemsize);
334     CeedChk(ierr);
335     ierr = CeedQFunctionFieldGetEvalMode(qfoutputfields[i], &emode);
336     CeedChk(ierr);
337     ierr = CeedQFunctionFieldGetSize(qfoutputfields[i], &size); CeedChk(ierr);
338     // Basis action
339     switch(emode) {
340     case CEED_EVAL_NONE:
341       break; // No action
342     case CEED_EVAL_INTERP:
343       ierr = CeedOperatorFieldGetBasis(opoutputfields[i], &basis);
344       CeedChk(ierr);
345       ierr = CeedVectorSetArray(impl->evecsout[i], CEED_MEM_HOST,
346                                 CEED_USE_POINTER,
347                                 &impl->edata[i + numinputfields][e*elemsize*size]);
348       CeedChk(ierr);
349       ierr = CeedBasisApply(basis, 1, CEED_TRANSPOSE,
350                             CEED_EVAL_INTERP, impl->qvecsout[i],
351                             impl->evecsout[i]); CeedChk(ierr);
352       break;
353     case CEED_EVAL_GRAD:
354       ierr = CeedOperatorFieldGetBasis(opoutputfields[i], &basis);
355       CeedChk(ierr);
356       ierr = CeedBasisGetDimension(basis, &dim); CeedChk(ierr);
357       ierr = CeedVectorSetArray(impl->evecsout[i], CEED_MEM_HOST,
358                                 CEED_USE_POINTER,
359                                 &impl->edata[i + numinputfields][e*elemsize*size/dim]);
360       CeedChk(ierr);
361       ierr = CeedBasisApply(basis, 1, CEED_TRANSPOSE,
362                             CEED_EVAL_GRAD, impl->qvecsout[i],
363                             impl->evecsout[i]); CeedChk(ierr);
364       break;
365     case CEED_EVAL_WEIGHT: {
366       // LCOV_EXCL_START
367       Ceed ceed;
368       ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
369       return CeedError(ceed, 1, "CEED_EVAL_WEIGHT cannot be an output "
370                        "evaluation mode");
371       // LCOV_EXCL_STOP
372       break; // Should not occur
373     }
374     case CEED_EVAL_DIV:
375     case CEED_EVAL_CURL: {
376       // LCOV_EXCL_START
377       Ceed ceed;
378       ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
379       return CeedError(ceed, 1, "Ceed evaluation mode not implemented");
380       // LCOV_EXCL_STOP
381       break; // Not implemented
382     }
383     }
384   }
385   return 0;
386 }
387 
388 // Restore Inputs
389 static inline int CeedOperatorRestoreInputs_Ref(CeedInt numinputfields,
390     CeedQFunctionField *qfinputfields, CeedOperatorField *opinputfields,
391     const bool skipactive, CeedOperator_Ref *impl) {
392   CeedInt ierr;
393   CeedEvalMode emode;
394 
395   for (CeedInt i=0; i<numinputfields; i++) {
396     // Skip active inputs
397     if (skipactive) {
398       CeedVector vec;
399       ierr = CeedOperatorFieldGetVector(opinputfields[i], &vec); CeedChk(ierr);
400       if (vec == CEED_VECTOR_ACTIVE)
401         continue;
402     }
403     // Restore input
404     ierr = CeedQFunctionFieldGetEvalMode(qfinputfields[i], &emode);
405     CeedChk(ierr);
406     if (emode == CEED_EVAL_WEIGHT) { // Skip
407     } else {
408       ierr = CeedVectorRestoreArrayRead(impl->evecs[i],
409                                         (const CeedScalar **) &impl->edata[i]);
410       CeedChk(ierr);
411     }
412   }
413   return 0;
414 }
415 
416 // Apply Operator
417 static int CeedOperatorApply_Ref(CeedOperator op, CeedVector invec,
418                                  CeedVector outvec, CeedRequest *request) {
419   int ierr;
420   CeedOperator_Ref *impl;
421   ierr = CeedOperatorGetData(op, (void *)&impl); CeedChk(ierr);
422   CeedQFunction qf;
423   ierr = CeedOperatorGetQFunction(op, &qf); CeedChk(ierr);
424   CeedInt Q, numelements, numinputfields, numoutputfields, size;
425   ierr = CeedOperatorGetNumQuadraturePoints(op, &Q); CeedChk(ierr);
426   ierr = CeedOperatorGetNumElements(op, &numelements); CeedChk(ierr);
427   ierr= CeedQFunctionGetNumArgs(qf, &numinputfields, &numoutputfields);
428   CeedChk(ierr);
429   CeedTransposeMode lmode;
430   CeedOperatorField *opinputfields, *opoutputfields;
431   ierr = CeedOperatorGetFields(op, &opinputfields, &opoutputfields);
432   CeedChk(ierr);
433   CeedQFunctionField *qfinputfields, *qfoutputfields;
434   ierr = CeedQFunctionGetFields(qf, &qfinputfields, &qfoutputfields);
435   CeedChk(ierr);
436   CeedEvalMode emode;
437   CeedVector vec;
438   CeedElemRestriction Erestrict;
439 
440   // Setup
441   ierr = CeedOperatorSetup_Ref(op); CeedChk(ierr);
442 
443   // Input Evecs and Restriction
444   ierr = CeedOperatorSetupInputs_Ref(numinputfields, qfinputfields,
445                                      opinputfields, invec, false, impl,
446                                      request); CeedChk(ierr);
447 
448   // Output Evecs
449   for (CeedInt i=0; i<numoutputfields; i++) {
450     ierr = CeedVectorGetArray(impl->evecs[i+impl->numein], CEED_MEM_HOST,
451                               &impl->edata[i + numinputfields]); CeedChk(ierr);
452   }
453 
454   // Loop through elements
455   for (CeedInt e=0; e<numelements; e++) {
456     // Output pointers
457     for (CeedInt i=0; i<numoutputfields; i++) {
458       ierr = CeedQFunctionFieldGetEvalMode(qfoutputfields[i], &emode);
459       CeedChk(ierr);
460       if (emode == CEED_EVAL_NONE) {
461         ierr = CeedQFunctionFieldGetSize(qfoutputfields[i], &size);
462         CeedChk(ierr);
463         ierr = CeedVectorSetArray(impl->qvecsout[i], CEED_MEM_HOST,
464                                   CEED_USE_POINTER,
465                                   &impl->edata[i + numinputfields][e*Q*size]);
466         CeedChk(ierr);
467       }
468     }
469 
470     // Input basis apply
471     ierr = CeedOperatorInputBasis_Ref(e, Q, qfinputfields, opinputfields,
472                                       numinputfields, false, impl);
473     CeedChk(ierr);
474 
475     // Q function
476     if (!impl->identityqf) {
477       ierr = CeedQFunctionApply(qf, Q, impl->qvecsin, impl->qvecsout);
478       CeedChk(ierr);
479     }
480 
481     // Output basis apply
482     ierr = CeedOperatorOutputBasis_Ref(e, Q, qfoutputfields, opoutputfields,
483                                        numinputfields, numoutputfields, op, impl);
484     CeedChk(ierr);
485   }
486 
487   // Output restriction
488   for (CeedInt i=0; i<numoutputfields; i++) {
489     // Restore evec
490     ierr = CeedVectorRestoreArray(impl->evecs[i+impl->numein],
491                                   &impl->edata[i + numinputfields]);
492     CeedChk(ierr);
493     // Get output vector
494     ierr = CeedOperatorFieldGetVector(opoutputfields[i], &vec); CeedChk(ierr);
495     // Active
496     if (vec == CEED_VECTOR_ACTIVE)
497       vec = outvec;
498     // Restrict
499     ierr = CeedOperatorFieldGetElemRestriction(opoutputfields[i], &Erestrict);
500     CeedChk(ierr);
501     ierr = CeedOperatorFieldGetLMode(opoutputfields[i], &lmode); CeedChk(ierr);
502     ierr = CeedElemRestrictionApply(Erestrict, CEED_TRANSPOSE,
503                                     lmode, impl->evecs[i+impl->numein], vec,
504                                     request); CeedChk(ierr);
505   }
506 
507   // Restore input arrays
508   ierr = CeedOperatorRestoreInputs_Ref(numinputfields, qfinputfields,
509                                        opinputfields, false, impl);
510   CeedChk(ierr);
511 
512   return 0;
513 }
514 
515 // Assemble Linear QFunction
516 static int CeedOperatorAssembleLinearQFunction_Ref(CeedOperator op,
517     CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) {
518   int ierr;
519   CeedOperator_Ref *impl;
520   ierr = CeedOperatorGetData(op, (void *)&impl); CeedChk(ierr);
521   CeedQFunction qf;
522   ierr = CeedOperatorGetQFunction(op, &qf); CeedChk(ierr);
523   CeedInt Q, numelements, numinputfields, numoutputfields, size;
524   ierr = CeedOperatorGetNumQuadraturePoints(op, &Q); CeedChk(ierr);
525   ierr = CeedOperatorGetNumElements(op, &numelements); CeedChk(ierr);
526   ierr= CeedQFunctionGetNumArgs(qf, &numinputfields, &numoutputfields);
527   CeedChk(ierr);
528   CeedOperatorField *opinputfields, *opoutputfields;
529   ierr = CeedOperatorGetFields(op, &opinputfields, &opoutputfields);
530   CeedChk(ierr);
531   CeedQFunctionField *qfinputfields, *qfoutputfields;
532   ierr = CeedQFunctionGetFields(qf, &qfinputfields, &qfoutputfields);
533   CeedChk(ierr);
534   CeedVector vec;
535   CeedInt numactivein = 0, numactiveout = 0;
536   CeedVector *activein = NULL;
537   CeedScalar *a, *tmp;
538   Ceed ceed, ceedparent;
539   ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
540   ierr = CeedGetOperatorFallbackParentCeed(ceed, &ceedparent); CeedChk(ierr);
541   ceedparent = ceedparent ? ceedparent : ceed;
542 
543   // Setup
544   ierr = CeedOperatorSetup_Ref(op); CeedChk(ierr);
545 
546   // Check for identity
547   if (impl->identityqf)
548     // LCOV_EXCL_START
549     return CeedError(ceed, 1, "Assembling identity qfunctions not supported");
550   // LCOV_EXCL_STOP
551 
552   // Input Evecs and Restriction
553   ierr = CeedOperatorSetupInputs_Ref(numinputfields, qfinputfields,
554                                      opinputfields, NULL, true, impl, request);
555   CeedChk(ierr);
556 
557   // Count number of active input fields
558   for (CeedInt i=0; i<numinputfields; i++) {
559     // Get input vector
560     ierr = CeedOperatorFieldGetVector(opinputfields[i], &vec); CeedChk(ierr);
561     // Check if active input
562     if (vec == CEED_VECTOR_ACTIVE) {
563       ierr = CeedQFunctionFieldGetSize(qfinputfields[i], &size); CeedChk(ierr);
564       ierr = CeedVectorSetValue(impl->qvecsin[i], 0.0); CeedChk(ierr);
565       ierr = CeedVectorGetArray(impl->qvecsin[i], CEED_MEM_HOST, &tmp);
566       CeedChk(ierr);
567       ierr = CeedRealloc(numactivein + size, &activein); CeedChk(ierr);
568       for (CeedInt field=0; field<size; field++) {
569         ierr = CeedVectorCreate(ceed, Q, &activein[numactivein+field]);
570         CeedChk(ierr);
571         ierr = CeedVectorSetArray(activein[numactivein+field], CEED_MEM_HOST,
572                                   CEED_USE_POINTER, &tmp[field*Q]);
573         CeedChk(ierr);
574       }
575       numactivein += size;
576       ierr = CeedVectorRestoreArray(impl->qvecsin[i], &tmp); CeedChk(ierr);
577     }
578   }
579 
580   // Count number of active output fields
581   for (CeedInt i=0; i<numoutputfields; i++) {
582     // Get output vector
583     ierr = CeedOperatorFieldGetVector(opoutputfields[i], &vec); CeedChk(ierr);
584     // Check if active output
585     if (vec == CEED_VECTOR_ACTIVE) {
586       ierr = CeedQFunctionFieldGetSize(qfoutputfields[i], &size); CeedChk(ierr);
587       numactiveout += size;
588     }
589   }
590 
591   // Check sizes
592   if (!numactivein || !numactiveout)
593     // LCOV_EXCL_START
594     return CeedError(ceed, 1, "Cannot assemble QFunction without active inputs "
595                      "and outputs");
596   // LCOV_EXCL_STOP
597 
598   // Create output restriction
599   ierr = CeedElemRestrictionCreateIdentity(ceedparent, numelements, Q,
600          numelements*Q, numactivein*numactiveout, rstr); CeedChk(ierr);
601   // Create assembled vector
602   ierr = CeedVectorCreate(ceedparent, numelements*Q*numactivein*numactiveout,
603                           assembled); CeedChk(ierr);
604   ierr = CeedVectorSetValue(*assembled, 0.0); CeedChk(ierr);
605   ierr = CeedVectorGetArray(*assembled, CEED_MEM_HOST, &a); CeedChk(ierr);
606 
607   // Loop through elements
608   for (CeedInt e=0; e<numelements; e++) {
609     // Input basis apply
610     ierr = CeedOperatorInputBasis_Ref(e, Q, qfinputfields, opinputfields,
611                                       numinputfields, true, impl);
612     CeedChk(ierr);
613 
614     // Assemble QFunction
615     for (CeedInt in=0; in<numactivein; in++) {
616       // Set Inputs
617       ierr = CeedVectorSetValue(activein[in], 1.0); CeedChk(ierr);
618       if (numactivein > 1) {
619         ierr = CeedVectorSetValue(activein[(in+numactivein-1)%numactivein],
620                                   0.0); CeedChk(ierr);
621       }
622       // Set Outputs
623       for (CeedInt out=0; out<numoutputfields; out++) {
624         // Get output vector
625         ierr = CeedOperatorFieldGetVector(opoutputfields[out], &vec);
626         CeedChk(ierr);
627         // Check if active output
628         if (vec == CEED_VECTOR_ACTIVE) {
629           CeedVectorSetArray(impl->qvecsout[out], CEED_MEM_HOST,
630                              CEED_USE_POINTER, a); CeedChk(ierr);
631           ierr = CeedQFunctionFieldGetSize(qfoutputfields[out], &size);
632           CeedChk(ierr);
633           a += size*Q; // Advance the pointer by the size of the output
634         }
635       }
636       // Apply QFunction
637       ierr = CeedQFunctionApply(qf, Q, impl->qvecsin, impl->qvecsout);
638       CeedChk(ierr);
639     }
640   }
641 
642   // Un-set output Qvecs to prevent accidental overwrite of Assembled
643   for (CeedInt out=0; out<numoutputfields; out++) {
644     // Get output vector
645     ierr = CeedOperatorFieldGetVector(opoutputfields[out], &vec);
646     CeedChk(ierr);
647     // Check if active output
648     if (vec == CEED_VECTOR_ACTIVE) {
649       CeedVectorSetArray(impl->qvecsout[out], CEED_MEM_HOST, CEED_COPY_VALUES,
650                          NULL); CeedChk(ierr);
651     }
652   }
653 
654   // Restore input arrays
655   ierr = CeedOperatorRestoreInputs_Ref(numinputfields, qfinputfields,
656                                        opinputfields, true, impl);
657   CeedChk(ierr);
658 
659   // Restore output
660   ierr = CeedVectorRestoreArray(*assembled, &a); CeedChk(ierr);
661 
662   // Cleanup
663   for (CeedInt i=0; i<numactivein; i++) {
664     ierr = CeedVectorDestroy(&activein[i]); CeedChk(ierr);
665   }
666   ierr = CeedFree(&activein); CeedChk(ierr);
667 
668   return 0;
669 }
670 
671 
672 // Assemble Linear Diagonal
673 static int CeedOperatorAssembleLinearDiagonal_Ref(CeedOperator op,
674     CeedVector *assembled, CeedRequest *request) {
675   int ierr;
676 
677   // Assemble QFunction
678   CeedQFunction qf;
679   ierr = CeedOperatorGetQFunction(op, &qf); CeedChk(ierr);
680   CeedInt numinputfields, numoutputfields;
681   ierr= CeedQFunctionGetNumArgs(qf, &numinputfields, &numoutputfields);
682   CeedChk(ierr);
683   CeedVector assembledqf;
684   CeedElemRestriction rstr;
685   ierr = CeedOperatorAssembleLinearQFunction(op,  &assembledqf, &rstr, request);
686   CeedChk(ierr);
687   ierr = CeedElemRestrictionDestroy(&rstr); CeedChk(ierr);
688 
689   // Determine active input basis
690   CeedOperatorField *opfields;
691   CeedQFunctionField *qffields;
692   ierr = CeedOperatorGetFields(op, &opfields, NULL); CeedChk(ierr);
693   ierr = CeedQFunctionGetFields(qf, &qffields, NULL); CeedChk(ierr);
694   CeedInt numemodein = 0, ncomp, dim = 1;
695   CeedEvalMode *emodein = NULL;
696   CeedBasis basisin = NULL;
697   CeedElemRestriction rstrin = NULL;
698   for (CeedInt i=0; i<numinputfields; i++) {
699     CeedVector vec;
700     ierr = CeedOperatorFieldGetVector(opfields[i], &vec); CeedChk(ierr);
701     if (vec == CEED_VECTOR_ACTIVE) {
702       ierr = CeedOperatorFieldGetBasis(opfields[i], &basisin);
703       CeedChk(ierr);
704       ierr = CeedBasisGetNumComponents(basisin, &ncomp); CeedChk(ierr);
705       ierr = CeedBasisGetDimension(basisin, &dim); CeedChk(ierr);
706       ierr = CeedOperatorFieldGetElemRestriction(opfields[i], &rstrin);
707       CeedChk(ierr);
708       CeedEvalMode emode;
709       ierr = CeedQFunctionFieldGetEvalMode(qffields[i], &emode);
710       CeedChk(ierr);
711       switch (emode) {
712       case CEED_EVAL_NONE:
713       case CEED_EVAL_INTERP:
714         ierr = CeedRealloc(numemodein + 1, &emodein); CeedChk(ierr);
715         emodein[numemodein] = emode;
716         numemodein += 1;
717         break;
718       case CEED_EVAL_GRAD:
719         ierr = CeedRealloc(numemodein + dim, &emodein); CeedChk(ierr);
720         for (CeedInt d=0; d<dim; d++)
721           emodein[numemodein+d] = emode;
722         numemodein += dim;
723         break;
724       case CEED_EVAL_WEIGHT:
725       case CEED_EVAL_DIV:
726       case CEED_EVAL_CURL:
727         break; // Caught by QF Assembly
728       }
729     }
730   }
731 
732   // Determine active output basis
733   ierr = CeedOperatorGetFields(op, NULL, &opfields); CeedChk(ierr);
734   ierr = CeedQFunctionGetFields(qf, NULL, &qffields); CeedChk(ierr);
735   CeedInt numemodeout = 0;
736   CeedEvalMode *emodeout = NULL;
737   CeedBasis basisout = NULL;
738   CeedElemRestriction rstrout = NULL;
739   CeedTransposeMode lmodeout = CEED_NOTRANSPOSE;
740   for (CeedInt i=0; i<numoutputfields; i++) {
741     CeedVector vec;
742     ierr = CeedOperatorFieldGetVector(opfields[i], &vec); CeedChk(ierr);
743     if (vec == CEED_VECTOR_ACTIVE) {
744       ierr = CeedOperatorFieldGetBasis(opfields[i], &basisout);
745       CeedChk(ierr);
746       ierr = CeedOperatorFieldGetElemRestriction(opfields[i], &rstrout);
747       CeedChk(ierr);
748       ierr = CeedOperatorFieldGetLMode(opfields[i], &lmodeout);
749       CeedChk(ierr);
750       CeedEvalMode emode;
751       ierr = CeedQFunctionFieldGetEvalMode(qffields[i], &emode);
752       CeedChk(ierr);
753       switch (emode) {
754       case CEED_EVAL_NONE:
755       case CEED_EVAL_INTERP:
756         ierr = CeedRealloc(numemodeout + 1, &emodeout); CeedChk(ierr);
757         emodeout[numemodeout] = emode;
758         numemodeout += 1;
759         break;
760       case CEED_EVAL_GRAD:
761         ierr = CeedRealloc(numemodeout + dim, &emodeout); CeedChk(ierr);
762         for (CeedInt d=0; d<dim; d++)
763           emodeout[numemodeout+d] = emode;
764         numemodeout += dim;
765         break;
766       case CEED_EVAL_WEIGHT:
767       case CEED_EVAL_DIV:
768       case CEED_EVAL_CURL:
769         break; // Caught by QF Assembly
770       }
771     }
772   }
773 
774   // Create diagonal vector
775   CeedVector elemdiag;
776   ierr = CeedElemRestrictionCreateVector(rstrin, assembled, &elemdiag);
777   CeedChk(ierr);
778 
779   // Assemble element operator diagonals
780   CeedScalar *elemdiagarray, *assembledqfarray;
781   ierr = CeedVectorSetValue(elemdiag, 0.0); CeedChk(ierr);
782   ierr = CeedVectorGetArray(elemdiag, CEED_MEM_HOST, &elemdiagarray);
783   CeedChk(ierr);
784   ierr = CeedVectorGetArray(assembledqf, CEED_MEM_HOST, &assembledqfarray);
785   CeedChk(ierr);
786   CeedInt nelem, nnodes, nqpts;
787   ierr = CeedElemRestrictionGetNumElements(rstrin, &nelem); CeedChk(ierr);
788   ierr = CeedBasisGetNumNodes(basisin, &nnodes); CeedChk(ierr);
789   ierr = CeedBasisGetNumQuadraturePoints(basisin, &nqpts); CeedChk(ierr);
790   // Compute the diagonal of B^T D B
791   // Each node, qpt pair
792   for (CeedInt n=0; n<nnodes; n++)
793     for (CeedInt q=0; q<nqpts; q++) {
794       CeedInt dout = -1;
795       // Each basis eval mode pair
796       for (CeedInt eout=0; eout<numemodeout; eout++) {
797         CeedScalar bt = 1.0;
798         if (emodeout[eout] == CEED_EVAL_GRAD)
799           dout += 1;
800         ierr = CeedBasisGetValue(basisout, emodeout[eout], q, n, dout, &bt);
801         CeedChk(ierr);
802         CeedInt din = -1;
803         for (CeedInt ein=0; ein<numemodein; ein++) {
804           CeedScalar b = 0.0;
805           if (emodein[ein] == CEED_EVAL_GRAD)
806             din += 1;
807           ierr = CeedBasisGetValue(basisin, emodein[ein], q, n, din, &b);
808           CeedChk(ierr);
809           // Each element and component
810           for (CeedInt e=0; e<nelem; e++)
811             for (CeedInt cout=0; cout<ncomp; cout++) {
812               CeedScalar db = 0.0;
813               for (CeedInt cin=0; cin<ncomp; cin++)
814                 db += assembledqfarray[((((e*numemodein+ein)*ncomp+cin)*
815                                          numemodeout+eout)*ncomp+cout)*nqpts+q]*b;
816               elemdiagarray[(e*ncomp+cout)*nnodes+n] += bt * db;
817             }
818         }
819       }
820     }
821 
822   ierr = CeedVectorRestoreArray(elemdiag, &elemdiagarray); CeedChk(ierr);
823   ierr = CeedVectorRestoreArray(assembledqf, &assembledqfarray); CeedChk(ierr);
824 
825   // Assemble local operator diagonal
826   ierr = CeedVectorSetValue(*assembled, 0.0); CeedChk(ierr);
827   ierr = CeedElemRestrictionApply(rstrout, CEED_TRANSPOSE, lmodeout, elemdiag,
828                                   *assembled, request); CeedChk(ierr);
829 
830   // Cleanup
831   ierr = CeedVectorDestroy(&assembledqf); CeedChk(ierr);
832   ierr = CeedVectorDestroy(&elemdiag); CeedChk(ierr);
833   ierr = CeedFree(&emodein); CeedChk(ierr);
834   ierr = CeedFree(&emodeout); CeedChk(ierr);
835 
836   return 0;
837 }
838 
839 int CeedOperatorCreate_Ref(CeedOperator op) {
840   int ierr;
841   Ceed ceed;
842   ierr = CeedOperatorGetCeed(op, &ceed); CeedChk(ierr);
843   CeedOperator_Ref *impl;
844 
845   ierr = CeedCalloc(1, &impl); CeedChk(ierr);
846   ierr = CeedOperatorSetData(op, (void *)&impl); CeedChk(ierr);
847 
848   ierr = CeedSetBackendFunction(ceed, "Operator", op, "AssembleLinearQFunction",
849                                 CeedOperatorAssembleLinearQFunction_Ref);
850   CeedChk(ierr);
851   ierr = CeedSetBackendFunction(ceed, "Operator", op, "AssembleLinearDiagonal",
852                                 CeedOperatorAssembleLinearDiagonal_Ref);
853   CeedChk(ierr);
854   ierr = CeedSetBackendFunction(ceed, "Operator", op, "ApplyAdd",
855                                 CeedOperatorApply_Ref); CeedChk(ierr);
856   ierr = CeedSetBackendFunction(ceed, "Operator", op, "Destroy",
857                                 CeedOperatorDestroy_Ref); CeedChk(ierr);
858   return 0;
859 }
860