15aed82e4SJeremy L Thompson // Copyright (c) 2017-2024, Lawrence Livermore National Security, LLC and other CEED contributors. 23d8e8822SJeremy L Thompson // All Rights Reserved. See the top-level LICENSE and NOTICE files for details. 3eaf62fffSJeremy L Thompson // 43d8e8822SJeremy L Thompson // SPDX-License-Identifier: BSD-2-Clause 5eaf62fffSJeremy L Thompson // 63d8e8822SJeremy L Thompson // This file is part of CEED: http://github.com/ceed 7eaf62fffSJeremy L Thompson 82b730f8bSJeremy L Thompson #include <ceed-impl.h> 949aac155SJeremy L Thompson #include <ceed.h> 102b730f8bSJeremy L Thompson #include <ceed/backend.h> 11c85e8640SSebastian Grimberg #include <assert.h> 122b730f8bSJeremy L Thompson #include <math.h> 13eaf62fffSJeremy L Thompson #include <stdbool.h> 14eaf62fffSJeremy L Thompson #include <stdio.h> 15eaf62fffSJeremy L Thompson #include <string.h> 16eaf62fffSJeremy L Thompson 17eaf62fffSJeremy L Thompson /// @file 18eaf62fffSJeremy L Thompson /// Implementation of CeedOperator preconditioning interfaces 19eaf62fffSJeremy L Thompson 20eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 21eaf62fffSJeremy L Thompson /// CeedOperator Library Internal Preconditioning Functions 22eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 23eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorDeveloper 24eaf62fffSJeremy L Thompson /// @{ 25eaf62fffSJeremy L Thompson 26eaf62fffSJeremy L Thompson /** 27ca94c3ddSJeremy L Thompson @brief Duplicate a `CeedQFunction` with a reference `Ceed` to fallback for advanced `CeedOperator` functionality 289e77b9c8SJeremy L Thompson 29ca94c3ddSJeremy L Thompson @param[in] fallback_ceed `Ceed` on which to create fallback `CeedQFunction` 30ca94c3ddSJeremy L Thompson @param[in] qf `CeedQFunction` to create fallback for 31ca94c3ddSJeremy L Thompson @param[out] qf_fallback Fallback `CeedQFunction` 329e77b9c8SJeremy L Thompson 339e77b9c8SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 349e77b9c8SJeremy L Thompson 359e77b9c8SJeremy L Thompson @ref Developer 369e77b9c8SJeremy L Thompson **/ 372b730f8bSJeremy L Thompson static int CeedQFunctionCreateFallback(Ceed fallback_ceed, CeedQFunction qf, CeedQFunction *qf_fallback) { 381c66c397SJeremy L Thompson char *source_path_with_name = NULL; 391203703bSJeremy L Thompson CeedInt num_input_fields, num_output_fields; 401203703bSJeremy L Thompson Ceed ceed; 411203703bSJeremy L Thompson CeedQFunctionField *input_fields, *output_fields; 421c66c397SJeremy L Thompson 439e77b9c8SJeremy L Thompson // Check if NULL qf passed in 449e77b9c8SJeremy L Thompson if (!qf) return CEED_ERROR_SUCCESS; 459e77b9c8SJeremy L Thompson 461203703bSJeremy L Thompson CeedCall(CeedQFunctionGetCeed(qf, &ceed)); 471203703bSJeremy L Thompson CeedDebug256(ceed, 1, "---------- CeedOperator Fallback ----------\n"); 481203703bSJeremy L Thompson CeedDebug(ceed, "Creating fallback CeedQFunction\n"); 49d04bbc78SJeremy L Thompson 509e77b9c8SJeremy L Thompson if (qf->source_path) { 512b730f8bSJeremy L Thompson size_t path_len = strlen(qf->source_path), name_len = strlen(qf->kernel_name); 52*9c25dd66SJeremy L Thompson 532b730f8bSJeremy L Thompson CeedCall(CeedCalloc(path_len + name_len + 2, &source_path_with_name)); 549e77b9c8SJeremy L Thompson memcpy(source_path_with_name, qf->source_path, path_len); 559e77b9c8SJeremy L Thompson memcpy(&source_path_with_name[path_len], ":", 1); 569e77b9c8SJeremy L Thompson memcpy(&source_path_with_name[path_len + 1], qf->kernel_name, name_len); 57*9c25dd66SJeremy L Thompson } else if (qf->user_source) { 58*9c25dd66SJeremy L Thompson CeedCall(CeedStringAllocCopy(qf->user_source, &source_path_with_name)); 599e77b9c8SJeremy L Thompson } else { 602b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &source_path_with_name)); 619e77b9c8SJeremy L Thompson } 629e77b9c8SJeremy L Thompson 631203703bSJeremy L Thompson { 641203703bSJeremy L Thompson CeedInt vec_length; 651203703bSJeremy L Thompson CeedQFunctionUser f; 661203703bSJeremy L Thompson 671203703bSJeremy L Thompson CeedCall(CeedQFunctionGetVectorLength(qf, &vec_length)); 681203703bSJeremy L Thompson CeedCall(CeedQFunctionGetUserFunction(qf, &f)); 691203703bSJeremy L Thompson CeedCall(CeedQFunctionCreateInterior(fallback_ceed, vec_length, f, source_path_with_name, qf_fallback)); 701203703bSJeremy L Thompson } 719e77b9c8SJeremy L Thompson { 729e77b9c8SJeremy L Thompson CeedQFunctionContext ctx; 739e77b9c8SJeremy L Thompson 742b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetContext(qf, &ctx)); 752b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(*qf_fallback, ctx)); 769e77b9c8SJeremy L Thompson } 771203703bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 781203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 796f8994e9SJeremy L Thompson const char *field_name; 801203703bSJeremy L Thompson CeedInt size; 811203703bSJeremy L Thompson CeedEvalMode eval_mode; 821203703bSJeremy L Thompson 83ab747706SJeremy L Thompson CeedCall(CeedQFunctionFieldGetData(input_fields[i], &field_name, &size, &eval_mode)); 841203703bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(*qf_fallback, field_name, size, eval_mode)); 859e77b9c8SJeremy L Thompson } 861203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 876f8994e9SJeremy L Thompson const char *field_name; 881203703bSJeremy L Thompson CeedInt size; 891203703bSJeremy L Thompson CeedEvalMode eval_mode; 901203703bSJeremy L Thompson 91ab747706SJeremy L Thompson CeedCall(CeedQFunctionFieldGetData(output_fields[i], &field_name, &size, &eval_mode)); 921203703bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(*qf_fallback, field_name, size, eval_mode)); 939e77b9c8SJeremy L Thompson } 942b730f8bSJeremy L Thompson CeedCall(CeedFree(&source_path_with_name)); 959e77b9c8SJeremy L Thompson return CEED_ERROR_SUCCESS; 969e77b9c8SJeremy L Thompson } 979e77b9c8SJeremy L Thompson 989e77b9c8SJeremy L Thompson /** 99ca94c3ddSJeremy L Thompson @brief Duplicate a `CeedOperator` with a reference `Ceed` to fallback for advanced `CeedOperator` functionality 100eaf62fffSJeremy L Thompson 101ca94c3ddSJeremy L Thompson @param[in,out] op `CeedOperator` to create fallback for 102eaf62fffSJeremy L Thompson 103eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 104eaf62fffSJeremy L Thompson 105eaf62fffSJeremy L Thompson @ref Developer 106eaf62fffSJeremy L Thompson **/ 107d04bbc78SJeremy L Thompson static int CeedOperatorCreateFallback(CeedOperator op) { 1081c66c397SJeremy L Thompson bool is_composite; 1091203703bSJeremy L Thompson Ceed ceed, ceed_fallback; 1101c66c397SJeremy L Thompson CeedOperator op_fallback; 111eaf62fffSJeremy L Thompson 112805fe78eSJeremy L Thompson // Check not already created 113805fe78eSJeremy L Thompson if (op->op_fallback) return CEED_ERROR_SUCCESS; 114805fe78eSJeremy L Thompson 115eaf62fffSJeremy L Thompson // Fallback Ceed 1161203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 1171203703bSJeremy L Thompson CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback)); 118d04bbc78SJeremy L Thompson if (!ceed_fallback) return CEED_ERROR_SUCCESS; 119d04bbc78SJeremy L Thompson 1201203703bSJeremy L Thompson CeedDebug256(ceed, 1, "---------- CeedOperator Fallback ----------\n"); 1211203703bSJeremy L Thompson CeedDebug(ceed, "Creating fallback CeedOperator\n"); 122eaf62fffSJeremy L Thompson 123eaf62fffSJeremy L Thompson // Clone Op 124b275c451SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 125b275c451SJeremy L Thompson if (is_composite) { 126b275c451SJeremy L Thompson CeedInt num_suboperators; 127b275c451SJeremy L Thompson CeedOperator *sub_operators; 128b275c451SJeremy L Thompson 1292b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorCreate(ceed_fallback, &op_fallback)); 130b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 131b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 132b275c451SJeremy L Thompson for (CeedInt i = 0; i < num_suboperators; i++) { 133d04bbc78SJeremy L Thompson CeedOperator op_sub_fallback; 134d04bbc78SJeremy L Thompson 135b275c451SJeremy L Thompson CeedCall(CeedOperatorGetFallback(sub_operators[i], &op_sub_fallback)); 1362b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorAddSub(op_fallback, op_sub_fallback)); 137805fe78eSJeremy L Thompson } 138805fe78eSJeremy L Thompson } else { 1391203703bSJeremy L Thompson CeedInt num_input_fields, num_output_fields; 1409e77b9c8SJeremy L Thompson CeedQFunction qf_fallback = NULL, dqf_fallback = NULL, dqfT_fallback = NULL; 1411203703bSJeremy L Thompson CeedOperatorField *input_fields, *output_fields; 1421c66c397SJeremy L Thompson 1432b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->qf, &qf_fallback)); 1442b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqf, &dqf_fallback)); 1452b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqfT, &dqfT_fallback)); 1462b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed_fallback, qf_fallback, dqf_fallback, dqfT_fallback, &op_fallback)); 1471203703bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 1481203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 1496f8994e9SJeremy L Thompson const char *field_name; 1501203703bSJeremy L Thompson CeedVector vec; 1511203703bSJeremy L Thompson CeedElemRestriction rstr; 1521203703bSJeremy L Thompson CeedBasis basis; 1531203703bSJeremy L Thompson 154ab747706SJeremy L Thompson CeedCall(CeedOperatorFieldGetData(input_fields[i], &field_name, &rstr, &basis, &vec)); 1551203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec)); 156681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 157681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 158681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 159805fe78eSJeremy L Thompson } 1601203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 1616f8994e9SJeremy L Thompson const char *field_name; 1621203703bSJeremy L Thompson CeedVector vec; 1631203703bSJeremy L Thompson CeedElemRestriction rstr; 1641203703bSJeremy L Thompson CeedBasis basis; 1651203703bSJeremy L Thompson 166ab747706SJeremy L Thompson CeedCall(CeedOperatorFieldGetData(output_fields[i], &field_name, &rstr, &basis, &vec)); 1671203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec)); 168681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 169681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 170681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 171805fe78eSJeremy L Thompson } 1727d5185d7SSebastian Grimberg { 1737d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 1747d5185d7SSebastian Grimberg 1757d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data)); 1767d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataReferenceCopy(data, &op_fallback->qf_assembled)); 1777d5185d7SSebastian Grimberg } 1789e77b9c8SJeremy L Thompson // Cleanup 1792b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&qf_fallback)); 1802b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&dqf_fallback)); 1812b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&dqfT_fallback)); 182805fe78eSJeremy L Thompson } 1832b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetName(op_fallback, op->name)); 1842b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fallback)); 185b05f7e9fSJeremy L Thompson // Note: No ref-counting here so we don't get caught in a reference loop. 186b05f7e9fSJeremy L Thompson // The op holds the only reference to op_fallback and is responsible for deleting itself and op_fallback. 187805fe78eSJeremy L Thompson op->op_fallback = op_fallback; 188b05f7e9fSJeremy L Thompson op_fallback->op_fallback_parent = op; 189eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 190eaf62fffSJeremy L Thompson } 191eaf62fffSJeremy L Thompson 192eaf62fffSJeremy L Thompson /** 193eaf62fffSJeremy L Thompson @brief Core logic for assembling operator diagonal or point block diagonal 194eaf62fffSJeremy L Thompson 1950cd9fdf4SJeremy L Thompson @param[in] op `CeedOperator` to assemble diagonal or point block diagonal 196ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 197bd83916cSSebastian Grimberg @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 198ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 199eaf62fffSJeremy L Thompson 200eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 201eaf62fffSJeremy L Thompson 202eaf62fffSJeremy L Thompson @ref Developer 203eaf62fffSJeremy L Thompson **/ 2040cd9fdf4SJeremy L Thompson static inline int CeedSingleOperatorLinearAssembleAddDiagonal_Mesh(CeedOperator op, CeedRequest *request, const bool is_point_block, 205f3bd9308SJeremy L Thompson CeedVector assembled) { 206eaf62fffSJeremy L Thompson Ceed ceed; 207506b1a0cSSebastian Grimberg bool is_composite; 208506b1a0cSSebastian Grimberg 209506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetCeed(op, &ceed)); 210506b1a0cSSebastian Grimberg CeedCall(CeedOperatorIsComposite(op, &is_composite)); 211506b1a0cSSebastian Grimberg CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 212506b1a0cSSebastian Grimberg 213506b1a0cSSebastian Grimberg // Assemble QFunction 214506b1a0cSSebastian Grimberg CeedInt layout_qf[3]; 215437c7c90SJeremy L Thompson const CeedScalar *assembled_qf_array; 216c5f45aeaSJeremy L Thompson CeedVector assembled_qf = NULL; 217c5f45aeaSJeremy L Thompson CeedElemRestriction assembled_elem_rstr = NULL; 218437c7c90SJeremy L Thompson 219437c7c90SJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, request)); 22056c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf)); 221437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr)); 222437c7c90SJeremy L Thompson CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array)); 223eaf62fffSJeremy L Thompson 224ed9e99e6SJeremy L Thompson // Get assembly data 225437c7c90SJeremy L Thompson const CeedEvalMode **eval_modes_in, **eval_modes_out; 226506b1a0cSSebastian Grimberg CeedInt num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out; 227437c7c90SJeremy L Thompson CeedSize **eval_mode_offsets_in, **eval_mode_offsets_out, num_output_components; 228506b1a0cSSebastian Grimberg CeedBasis *active_bases_in, *active_bases_out; 229506b1a0cSSebastian Grimberg CeedElemRestriction *active_elem_rstrs_in, *active_elem_rstrs_out; 2301c66c397SJeremy L Thompson CeedOperatorAssemblyData data; 2311c66c397SJeremy L Thompson 232437c7c90SJeremy L Thompson CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data)); 233506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, &eval_mode_offsets_in, 234506b1a0cSSebastian Grimberg &num_active_bases_out, &num_eval_modes_out, &eval_modes_out, &eval_mode_offsets_out, 235506b1a0cSSebastian Grimberg &num_output_components)); 236506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, NULL, NULL, &active_bases_out, NULL)); 237506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, NULL, &active_elem_rstrs_in, NULL, &active_elem_rstrs_out)); 238506b1a0cSSebastian Grimberg 239934a29f5SSebastian Grimberg // Loop over all active bases (find matching input/output pairs) 240934a29f5SSebastian Grimberg for (CeedInt b = 0; b < CeedIntMin(num_active_bases_in, num_active_bases_out); b++) { 241934a29f5SSebastian Grimberg CeedInt b_in, b_out, num_elem, num_nodes, num_qpts, num_comp; 2421c66c397SJeremy L Thompson bool has_eval_none = false; 2431c66c397SJeremy L Thompson CeedScalar *elem_diag_array, *identity = NULL; 2441c66c397SJeremy L Thompson CeedVector elem_diag; 2457c1dbaffSSebastian Grimberg CeedElemRestriction diag_elem_rstr; 2461c66c397SJeremy L Thompson 247934a29f5SSebastian Grimberg if (num_active_bases_in <= num_active_bases_out) { 248934a29f5SSebastian Grimberg b_in = b; 249934a29f5SSebastian Grimberg for (b_out = 0; b_out < num_active_bases_out; b_out++) { 250934a29f5SSebastian Grimberg if (active_bases_in[b_in] == active_bases_out[b_out]) { 251934a29f5SSebastian Grimberg break; 252934a29f5SSebastian Grimberg } 253934a29f5SSebastian Grimberg } 254934a29f5SSebastian Grimberg if (b_out == num_active_bases_out) { 255934a29f5SSebastian Grimberg continue; 256934a29f5SSebastian Grimberg } // No matching output basis found 257934a29f5SSebastian Grimberg } else { 258934a29f5SSebastian Grimberg b_out = b; 259934a29f5SSebastian Grimberg for (b_in = 0; b_in < num_active_bases_in; b_in++) { 260934a29f5SSebastian Grimberg if (active_bases_in[b_in] == active_bases_out[b_out]) { 261934a29f5SSebastian Grimberg break; 262934a29f5SSebastian Grimberg } 263934a29f5SSebastian Grimberg } 264934a29f5SSebastian Grimberg if (b_in == num_active_bases_in) { 265934a29f5SSebastian Grimberg continue; 266934a29f5SSebastian Grimberg } // No matching output basis found 267934a29f5SSebastian Grimberg } 268934a29f5SSebastian Grimberg CeedCheck(active_elem_rstrs_in[b_in] == active_elem_rstrs_out[b_out], ceed, CEED_ERROR_UNSUPPORTED, 269506b1a0cSSebastian Grimberg "Cannot assemble operator diagonal with different input and output active element restrictions"); 270506b1a0cSSebastian Grimberg 2711c66c397SJeremy L Thompson // Assemble point block diagonal restriction, if needed 272bd83916cSSebastian Grimberg if (is_point_block) { 273934a29f5SSebastian Grimberg CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstrs_in[b_in], &diag_elem_rstr)); 2747c1dbaffSSebastian Grimberg } else { 275934a29f5SSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnsignedCopy(active_elem_rstrs_in[b_in], &diag_elem_rstr)); 276eaf62fffSJeremy L Thompson } 277eaf62fffSJeremy L Thompson 278eaf62fffSJeremy L Thompson // Create diagonal vector 279437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionCreateVector(diag_elem_rstr, NULL, &elem_diag)); 280eaf62fffSJeremy L Thompson 281eaf62fffSJeremy L Thompson // Assemble element operator diagonals 2822b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(elem_diag, 0.0)); 2832b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArray(elem_diag, CEED_MEM_HOST, &elem_diag_array)); 284437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionGetNumElements(diag_elem_rstr, &num_elem)); 285934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumNodes(active_bases_in[b_in], &num_nodes)); 286934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumComponents(active_bases_in[b_in], &num_comp)); 287934a29f5SSebastian Grimberg if (active_bases_in[b_in] == CEED_BASIS_NONE) num_qpts = num_nodes; 288934a29f5SSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(active_bases_in[b_in], &num_qpts)); 289ed9e99e6SJeremy L Thompson 290352a5e7cSSebastian Grimberg // Construct identity matrix for basis if required 291934a29f5SSebastian Grimberg for (CeedInt i = 0; i < num_eval_modes_in[b_in]; i++) { 292934a29f5SSebastian Grimberg has_eval_none = has_eval_none || (eval_modes_in[b_in][i] == CEED_EVAL_NONE); 293ed9e99e6SJeremy L Thompson } 294934a29f5SSebastian Grimberg for (CeedInt i = 0; i < num_eval_modes_out[b_out]; i++) { 295934a29f5SSebastian Grimberg has_eval_none = has_eval_none || (eval_modes_out[b_out][i] == CEED_EVAL_NONE); 296ed9e99e6SJeremy L Thompson } 297ed9e99e6SJeremy L Thompson if (has_eval_none) { 2982b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 2992b730f8bSJeremy L Thompson for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) identity[i * num_nodes + i] = 1.0; 300eaf62fffSJeremy L Thompson } 301352a5e7cSSebastian Grimberg 302eaf62fffSJeremy L Thompson // Compute the diagonal of B^T D B 303eaf62fffSJeremy L Thompson // Each element 304b94338b9SJed Brown for (CeedSize e = 0; e < num_elem; e++) { 305eaf62fffSJeremy L Thompson // Each basis eval mode pair 306352a5e7cSSebastian Grimberg CeedInt d_out = 0, q_comp_out; 307352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE; 3081c66c397SJeremy L Thompson 309934a29f5SSebastian Grimberg for (CeedInt e_out = 0; e_out < num_eval_modes_out[b_out]; e_out++) { 3101c66c397SJeremy L Thompson CeedInt d_in = 0, q_comp_in; 311437c7c90SJeremy L Thompson const CeedScalar *B_t = NULL; 3121c66c397SJeremy L Thompson CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE; 3131c66c397SJeremy L Thompson 314934a29f5SSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(active_bases_out[b_out], eval_modes_out[b_out][e_out], identity, &B_t)); 315934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_out[b_out], eval_modes_out[b_out][e_out], &q_comp_out)); 316352a5e7cSSebastian Grimberg if (q_comp_out > 1) { 317934a29f5SSebastian Grimberg if (e_out == 0 || eval_modes_out[b_out][e_out] != eval_mode_out_prev) d_out = 0; 318352a5e7cSSebastian Grimberg else B_t = &B_t[(++d_out) * num_qpts * num_nodes]; 319352a5e7cSSebastian Grimberg } 320934a29f5SSebastian Grimberg eval_mode_out_prev = eval_modes_out[b_out][e_out]; 321352a5e7cSSebastian Grimberg 322934a29f5SSebastian Grimberg for (CeedInt e_in = 0; e_in < num_eval_modes_in[b_in]; e_in++) { 323437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 3241c66c397SJeremy L Thompson 325934a29f5SSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(active_bases_in[b_in], eval_modes_in[b_in][e_in], identity, &B)); 326934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_in[b_in], eval_modes_in[b_in][e_in], &q_comp_in)); 327352a5e7cSSebastian Grimberg if (q_comp_in > 1) { 328934a29f5SSebastian Grimberg if (e_in == 0 || eval_modes_in[b_in][e_in] != eval_mode_in_prev) d_in = 0; 329352a5e7cSSebastian Grimberg else B = &B[(++d_in) * num_qpts * num_nodes]; 330352a5e7cSSebastian Grimberg } 331934a29f5SSebastian Grimberg eval_mode_in_prev = eval_modes_in[b_in][e_in]; 332352a5e7cSSebastian Grimberg 333eaf62fffSJeremy L Thompson // Each component 334506b1a0cSSebastian Grimberg for (CeedInt c_out = 0; c_out < num_comp; c_out++) { 335437c7c90SJeremy L Thompson // Each qpt/node pair 3362b730f8bSJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 337bd83916cSSebastian Grimberg if (is_point_block) { 338eaf62fffSJeremy L Thompson // Point Block Diagonal 339506b1a0cSSebastian Grimberg for (CeedInt c_in = 0; c_in < num_comp; c_in++) { 340934a29f5SSebastian Grimberg const CeedSize c_offset = 341934a29f5SSebastian Grimberg (eval_mode_offsets_in[b_in][e_in] + c_in) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out; 342506b1a0cSSebastian Grimberg const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]]; 3431c66c397SJeremy L Thompson 3442b730f8bSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 345506b1a0cSSebastian Grimberg elem_diag_array[((e * num_comp + c_out) * num_comp + c_in) * num_nodes + n] += 346437c7c90SJeremy L Thompson B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n]; 347eaf62fffSJeremy L Thompson } 3482b730f8bSJeremy L Thompson } 349eaf62fffSJeremy L Thompson } else { 350eaf62fffSJeremy L Thompson // Diagonal Only 351934a29f5SSebastian Grimberg const CeedInt c_offset = 352934a29f5SSebastian Grimberg (eval_mode_offsets_in[b_in][e_in] + c_out) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out; 353506b1a0cSSebastian Grimberg const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]]; 3541c66c397SJeremy L Thompson 3552b730f8bSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 356506b1a0cSSebastian Grimberg elem_diag_array[(e * num_comp + c_out) * num_nodes + n] += B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n]; 357eaf62fffSJeremy L Thompson } 358eaf62fffSJeremy L Thompson } 359eaf62fffSJeremy L Thompson } 360eaf62fffSJeremy L Thompson } 3612b730f8bSJeremy L Thompson } 3622b730f8bSJeremy L Thompson } 3632b730f8bSJeremy L Thompson } 3642b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(elem_diag, &elem_diag_array)); 365eaf62fffSJeremy L Thompson 366eaf62fffSJeremy L Thompson // Assemble local operator diagonal 3677c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(diag_elem_rstr, CEED_TRANSPOSE, elem_diag, assembled, request)); 368eaf62fffSJeremy L Thompson 369eaf62fffSJeremy L Thompson // Cleanup 3707c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&diag_elem_rstr)); 3712b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&elem_diag)); 3722b730f8bSJeremy L Thompson CeedCall(CeedFree(&identity)); 373437c7c90SJeremy L Thompson } 374437c7c90SJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array)); 375437c7c90SJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_qf)); 376eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 377eaf62fffSJeremy L Thompson } 378eaf62fffSJeremy L Thompson 379eaf62fffSJeremy L Thompson /** 3800cd9fdf4SJeremy L Thompson @brief Core logic for assembling operator diagonal or point block diagonal 3810cd9fdf4SJeremy L Thompson 3820cd9fdf4SJeremy L Thompson @param[in] op `CeedOperator` to assemble diagonal or point block diagonal 3830cd9fdf4SJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 3840cd9fdf4SJeremy L Thompson @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 3850cd9fdf4SJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 3860cd9fdf4SJeremy L Thompson 3870cd9fdf4SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 3880cd9fdf4SJeremy L Thompson 3890cd9fdf4SJeremy L Thompson @ref Developer 3900cd9fdf4SJeremy L Thompson **/ 3910cd9fdf4SJeremy L Thompson static inline int CeedSingleOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_point_block, 3920cd9fdf4SJeremy L Thompson CeedVector assembled) { 3930cd9fdf4SJeremy L Thompson Ceed ceed; 3940cd9fdf4SJeremy L Thompson bool is_at_points; 3950cd9fdf4SJeremy L Thompson 3960cd9fdf4SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 3970cd9fdf4SJeremy L Thompson CeedCall(CeedOperatorIsAtPoints(op, &is_at_points)); 39842461424SJeremy L Thompson CeedCheck(!is_at_points, ceed, CEED_ERROR_UNSUPPORTED, "AtPoints operator not supported"); 3990cd9fdf4SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal_Mesh(op, request, is_point_block, assembled)); 4000cd9fdf4SJeremy L Thompson return CEED_ERROR_SUCCESS; 4010cd9fdf4SJeremy L Thompson } 4020cd9fdf4SJeremy L Thompson 4030cd9fdf4SJeremy L Thompson /** 404eaf62fffSJeremy L Thompson @brief Core logic for assembling composite operator diagonal 405eaf62fffSJeremy L Thompson 406ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble point block diagonal 407ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 408bd83916cSSebastian Grimberg @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 409ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 410eaf62fffSJeremy L Thompson 411eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 412eaf62fffSJeremy L Thompson 413eaf62fffSJeremy L Thompson @ref Developer 414eaf62fffSJeremy L Thompson **/ 415bd83916cSSebastian Grimberg static inline int CeedCompositeOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_point_block, 416eaf62fffSJeremy L Thompson CeedVector assembled) { 417eaf62fffSJeremy L Thompson CeedInt num_sub; 418eaf62fffSJeremy L Thompson CeedOperator *suboperators; 4191c66c397SJeremy L Thompson 420c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub)); 421c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &suboperators)); 422eaf62fffSJeremy L Thompson for (CeedInt i = 0; i < num_sub; i++) { 423bd83916cSSebastian Grimberg if (is_point_block) { 4242b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(suboperators[i], assembled, request)); 4256aa95790SJeremy L Thompson } else { 4262b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(suboperators[i], assembled, request)); 4276aa95790SJeremy L Thompson } 428eaf62fffSJeremy L Thompson } 429eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 430eaf62fffSJeremy L Thompson } 431eaf62fffSJeremy L Thompson 432eaf62fffSJeremy L Thompson /** 433ca94c3ddSJeremy L Thompson @brief Build nonzero pattern for non-composite CeedOperator`. 434eaf62fffSJeremy L Thompson 435ca94c3ddSJeremy L Thompson Users should generally use @ref CeedOperatorLinearAssembleSymbolic(). 436eaf62fffSJeremy L Thompson 437ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble nonzero pattern 438eaf62fffSJeremy L Thompson @param[in] offset Offset for number of entries 439eaf62fffSJeremy L Thompson @param[out] rows Row number for each entry 440eaf62fffSJeremy L Thompson @param[out] cols Column number for each entry 441eaf62fffSJeremy L Thompson 442eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 443eaf62fffSJeremy L Thompson 444eaf62fffSJeremy L Thompson @ref Developer 445eaf62fffSJeremy L Thompson **/ 4462b730f8bSJeremy L Thompson static int CeedSingleOperatorAssembleSymbolic(CeedOperator op, CeedInt offset, CeedInt *rows, CeedInt *cols) { 447f3d47e36SJeremy L Thompson Ceed ceed; 448f3d47e36SJeremy L Thompson bool is_composite; 44981670346SSebastian Grimberg CeedSize num_nodes_in, num_nodes_out, local_num_entries, count = 0; 450506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, layout_er_in[3]; 45181670346SSebastian Grimberg CeedInt num_elem_out, elem_size_out, num_comp_out, layout_er_out[3]; 4521c66c397SJeremy L Thompson CeedScalar *array; 453506b1a0cSSebastian Grimberg const CeedScalar *elem_dof_a_in, *elem_dof_a_out; 454506b1a0cSSebastian Grimberg CeedVector index_vec_in, index_vec_out, elem_dof_in, elem_dof_out; 455506b1a0cSSebastian Grimberg CeedElemRestriction elem_rstr_in, elem_rstr_out, index_elem_rstr_in, index_elem_rstr_out; 4561c66c397SJeremy L Thompson 457f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 458f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 4596574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 460eaf62fffSJeremy L Thompson 461506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveVectorLengths(op, &num_nodes_in, &num_nodes_out)); 462506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out)); 463506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in)); 464506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in)); 465506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in)); 46656c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(elem_rstr_in, layout_er_in)); 467eaf62fffSJeremy L Thompson 468506b1a0cSSebastian Grimberg // Determine elem_dof relation for input 469506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_nodes_in, &index_vec_in)); 470506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayWrite(index_vec_in, CEED_MEM_HOST, &array)); 471c81f2b9dSJames Wright for (CeedSize i = 0; i < num_nodes_in; i++) array[i] = i; 472506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArray(index_vec_in, &array)); 473506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_elem_in * elem_size_in * num_comp_in, &elem_dof_in)); 474506b1a0cSSebastian Grimberg CeedCall(CeedVectorSetValue(elem_dof_in, 0.0)); 475506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_in, &index_elem_rstr_in)); 476506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionApply(index_elem_rstr_in, CEED_NOTRANSPOSE, index_vec_in, elem_dof_in, CEED_REQUEST_IMMEDIATE)); 477506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(elem_dof_in, CEED_MEM_HOST, &elem_dof_a_in)); 478506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&index_vec_in)); 479506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_in)); 480506b1a0cSSebastian Grimberg 481506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 482506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out)); 483506b1a0cSSebastian Grimberg CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 4843f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 4853f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 4863f08121cSJeremy L Thompson num_elem_in, num_elem_out); 487506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out)); 488506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out)); 48956c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(elem_rstr_out, layout_er_out)); 490506b1a0cSSebastian Grimberg 491506b1a0cSSebastian Grimberg // Determine elem_dof relation for output 492506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_nodes_out, &index_vec_out)); 493506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayWrite(index_vec_out, CEED_MEM_HOST, &array)); 494c81f2b9dSJames Wright for (CeedSize i = 0; i < num_nodes_out; i++) array[i] = i; 495506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArray(index_vec_out, &array)); 496506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_elem_out * elem_size_out * num_comp_out, &elem_dof_out)); 497506b1a0cSSebastian Grimberg CeedCall(CeedVectorSetValue(elem_dof_out, 0.0)); 498506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_out, &index_elem_rstr_out)); 499506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionApply(index_elem_rstr_out, CEED_NOTRANSPOSE, index_vec_out, elem_dof_out, CEED_REQUEST_IMMEDIATE)); 500506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(elem_dof_out, CEED_MEM_HOST, &elem_dof_a_out)); 501506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&index_vec_out)); 502506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_out)); 503506b1a0cSSebastian Grimberg } else { 504506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 505506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 506506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 507506b1a0cSSebastian Grimberg layout_er_out[0] = layout_er_in[0]; 508506b1a0cSSebastian Grimberg layout_er_out[1] = layout_er_in[1]; 509506b1a0cSSebastian Grimberg layout_er_out[2] = layout_er_in[2]; 510506b1a0cSSebastian Grimberg elem_dof_a_out = elem_dof_a_in; 511506b1a0cSSebastian Grimberg } 512c81f2b9dSJames Wright local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in; 513eaf62fffSJeremy L Thompson 514eaf62fffSJeremy L Thompson // Determine i, j locations for element matrices 515506b1a0cSSebastian Grimberg for (CeedInt e = 0; e < num_elem_in; e++) { 516506b1a0cSSebastian Grimberg for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) { 517506b1a0cSSebastian Grimberg for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) { 518506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 519506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 520506b1a0cSSebastian Grimberg const CeedInt elem_dof_index_row = i * layout_er_out[0] + comp_out * layout_er_out[1] + e * layout_er_out[2]; 521506b1a0cSSebastian Grimberg const CeedInt elem_dof_index_col = j * layout_er_in[0] + comp_in * layout_er_in[1] + e * layout_er_in[2]; 522506b1a0cSSebastian Grimberg const CeedInt row = elem_dof_a_out[elem_dof_index_row]; 523506b1a0cSSebastian Grimberg const CeedInt col = elem_dof_a_in[elem_dof_index_col]; 524eaf62fffSJeremy L Thompson 525eaf62fffSJeremy L Thompson rows[offset + count] = row; 526eaf62fffSJeremy L Thompson cols[offset + count] = col; 527eaf62fffSJeremy L Thompson count++; 528eaf62fffSJeremy L Thompson } 529eaf62fffSJeremy L Thompson } 530eaf62fffSJeremy L Thompson } 531eaf62fffSJeremy L Thompson } 532eaf62fffSJeremy L Thompson } 5336574a04fSJeremy L Thompson CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing assembled entries"); 534506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArrayRead(elem_dof_in, &elem_dof_a_in)); 535506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&elem_dof_in)); 536506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 537506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArrayRead(elem_dof_out, &elem_dof_a_out)); 538506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&elem_dof_out)); 539506b1a0cSSebastian Grimberg } 540681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 541681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 542eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 543eaf62fffSJeremy L Thompson } 544eaf62fffSJeremy L Thompson 545eaf62fffSJeremy L Thompson /** 546ca94c3ddSJeremy L Thompson @brief Assemble nonzero entries for non-composite `CeedOperator`. 547eaf62fffSJeremy L Thompson 548ca94c3ddSJeremy L Thompson Users should generally use @ref CeedOperatorLinearAssemble(). 549eaf62fffSJeremy L Thompson 550ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 551ea61e9acSJeremy L Thompson @param[in] offset Offset for number of entries 552eaf62fffSJeremy L Thompson @param[out] values Values to assemble into matrix 553eaf62fffSJeremy L Thompson 554eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 555eaf62fffSJeremy L Thompson 556eaf62fffSJeremy L Thompson @ref Developer 557eaf62fffSJeremy L Thompson **/ 5582b730f8bSJeremy L Thompson static int CeedSingleOperatorAssemble(CeedOperator op, CeedInt offset, CeedVector values) { 559f3d47e36SJeremy L Thompson Ceed ceed; 560f3d47e36SJeremy L Thompson bool is_composite; 5611c66c397SJeremy L Thompson 562f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 563f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 5646574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 565f3d47e36SJeremy L Thompson 566f3d47e36SJeremy L Thompson // Early exit for empty operator 567f3d47e36SJeremy L Thompson { 568f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 569f3d47e36SJeremy L Thompson 570f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 571f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 572f3d47e36SJeremy L Thompson } 573eaf62fffSJeremy L Thompson 574cefa2673SJeremy L Thompson if (op->LinearAssembleSingle) { 575cefa2673SJeremy L Thompson // Backend version 5762b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleSingle(op, offset, values)); 577cefa2673SJeremy L Thompson return CEED_ERROR_SUCCESS; 578cefa2673SJeremy L Thompson } else { 579cefa2673SJeremy L Thompson // Operator fallback 580cefa2673SJeremy L Thompson CeedOperator op_fallback; 581cefa2673SJeremy L Thompson 5822b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 583cefa2673SJeremy L Thompson if (op_fallback) { 5842b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(op_fallback, offset, values)); 585cefa2673SJeremy L Thompson return CEED_ERROR_SUCCESS; 586cefa2673SJeremy L Thompson } 587cefa2673SJeremy L Thompson } 588cefa2673SJeremy L Thompson 589eaf62fffSJeremy L Thompson // Assemble QFunction 590506b1a0cSSebastian Grimberg CeedInt layout_qf[3]; 5911c66c397SJeremy L Thompson const CeedScalar *assembled_qf_array; 592c5f45aeaSJeremy L Thompson CeedVector assembled_qf = NULL; 593506b1a0cSSebastian Grimberg CeedElemRestriction assembled_elem_rstr = NULL; 594eaf62fffSJeremy L Thompson 595506b1a0cSSebastian Grimberg CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, CEED_REQUEST_IMMEDIATE)); 59656c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf)); 597506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr)); 598506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array)); 599eaf62fffSJeremy L Thompson 600ed9e99e6SJeremy L Thompson // Get assembly data 601506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, num_qpts_in; 60281670346SSebastian Grimberg CeedInt num_elem_out, elem_size_out, num_comp_out, num_qpts_out; 60381670346SSebastian Grimberg CeedSize local_num_entries, count = 0; 604506b1a0cSSebastian Grimberg const CeedEvalMode **eval_modes_in, **eval_modes_out; 605506b1a0cSSebastian Grimberg CeedInt num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out; 606506b1a0cSSebastian Grimberg CeedBasis *active_bases_in, *active_bases_out, basis_in, basis_out; 607506b1a0cSSebastian Grimberg const CeedScalar **B_mats_in, **B_mats_out, *B_mat_in, *B_mat_out; 608506b1a0cSSebastian Grimberg CeedElemRestriction elem_rstr_in, elem_rstr_out; 609506b1a0cSSebastian Grimberg CeedRestrictionType elem_rstr_type_in, elem_rstr_type_out; 610506b1a0cSSebastian Grimberg const bool *elem_rstr_orients_in = NULL, *elem_rstr_orients_out = NULL; 611506b1a0cSSebastian Grimberg const CeedInt8 *elem_rstr_curl_orients_in = NULL, *elem_rstr_curl_orients_out = NULL; 612506b1a0cSSebastian Grimberg CeedOperatorAssemblyData data; 613eaf62fffSJeremy L Thompson 614506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data)); 615506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, NULL, &num_active_bases_out, 616506b1a0cSSebastian Grimberg &num_eval_modes_out, &eval_modes_out, NULL, NULL)); 617506b1a0cSSebastian Grimberg 6183f08121cSJeremy L Thompson CeedCheck(num_active_bases_in == 1 && num_active_bases_out == 1, ceed, CEED_ERROR_UNSUPPORTED, 619506b1a0cSSebastian Grimberg "Cannot assemble operator with multiple active bases"); 6206574a04fSJeremy L Thompson CeedCheck(num_eval_modes_in[0] > 0 && num_eval_modes_out[0] > 0, ceed, CEED_ERROR_UNSUPPORTED, "Cannot assemble operator without inputs/outputs"); 621eaf62fffSJeremy L Thompson 622506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, &B_mats_in, NULL, &active_bases_out, &B_mats_out)); 623506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out)); 624506b1a0cSSebastian Grimberg basis_in = active_bases_in[0]; 625506b1a0cSSebastian Grimberg basis_out = active_bases_out[0]; 626506b1a0cSSebastian Grimberg B_mat_in = B_mats_in[0]; 627506b1a0cSSebastian Grimberg B_mat_out = B_mats_out[0]; 628eaf62fffSJeremy L Thompson 629506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in)); 630506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in)); 631506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in)); 632506b1a0cSSebastian Grimberg if (basis_in == CEED_BASIS_NONE) num_qpts_in = elem_size_in; 633506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(basis_in, &num_qpts_in)); 634506b1a0cSSebastian Grimberg 635506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(elem_rstr_in, &elem_rstr_type_in)); 636506b1a0cSSebastian Grimberg if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) { 637506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_orients_in)); 638506b1a0cSSebastian Grimberg } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) { 639506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_curl_orients_in)); 6407c1dbaffSSebastian Grimberg } 6417c1dbaffSSebastian Grimberg 642506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 643506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out)); 644506b1a0cSSebastian Grimberg CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 6453f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 6463f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 6473f08121cSJeremy L Thompson num_elem_in, num_elem_out); 648506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out)); 649506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out)); 650506b1a0cSSebastian Grimberg if (basis_out == CEED_BASIS_NONE) num_qpts_out = elem_size_out; 651506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(basis_out, &num_qpts_out)); 652506b1a0cSSebastian Grimberg CeedCheck(num_qpts_in == num_qpts_out, ceed, CEED_ERROR_UNSUPPORTED, 6533f08121cSJeremy L Thompson "Active input and output bases must have the same number of quadrature points." 6543f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " points; output has %" CeedInt_FMT "points.", 6553f08121cSJeremy L Thompson num_qpts_in, num_qpts_out); 656eaf62fffSJeremy L Thompson 657506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(elem_rstr_out, &elem_rstr_type_out)); 658506b1a0cSSebastian Grimberg if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) { 659506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_orients_out)); 660506b1a0cSSebastian Grimberg } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) { 661506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_curl_orients_out)); 662506b1a0cSSebastian Grimberg } 663506b1a0cSSebastian Grimberg } else { 664506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 665506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 666506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 667506b1a0cSSebastian Grimberg num_qpts_out = num_qpts_in; 668506b1a0cSSebastian Grimberg 669506b1a0cSSebastian Grimberg elem_rstr_orients_out = elem_rstr_orients_in; 670506b1a0cSSebastian Grimberg elem_rstr_curl_orients_out = elem_rstr_curl_orients_in; 671506b1a0cSSebastian Grimberg } 672c81f2b9dSJames Wright local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in; 673506b1a0cSSebastian Grimberg 674506b1a0cSSebastian Grimberg // Loop over elements and put in data structure 6757c1dbaffSSebastian Grimberg // We store B_mat_in, B_mat_out, BTD, elem_mat in row-major order 6760459ebd3SSebastian Grimberg CeedTensorContract contract; 677123d890dSSebastian Grimberg CeedScalar *vals, *BTD_mat = NULL, *elem_mat = NULL, *elem_mat_b = NULL; 678506b1a0cSSebastian Grimberg 679c22497adSSebastian Grimberg CeedCall(CeedBasisGetTensorContract(basis_in, &contract)); 680123d890dSSebastian Grimberg CeedCall(CeedCalloc(elem_size_out * num_qpts_in * num_eval_modes_in[0], &BTD_mat)); 681123d890dSSebastian Grimberg CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat)); 682506b1a0cSSebastian Grimberg if (elem_rstr_curl_orients_in || elem_rstr_curl_orients_out) CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat_b)); 6831c66c397SJeremy L Thompson 68428ec399dSJeremy L Thompson CeedCall(CeedVectorGetArray(values, CEED_MEM_HOST, &vals)); 685506b1a0cSSebastian Grimberg for (CeedSize e = 0; e < num_elem_in; e++) { 686506b1a0cSSebastian Grimberg for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) { 687506b1a0cSSebastian Grimberg for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) { 688ed9e99e6SJeremy L Thompson // Compute B^T*D 689506b1a0cSSebastian Grimberg for (CeedSize n = 0; n < elem_size_out; n++) { 690506b1a0cSSebastian Grimberg for (CeedSize q = 0; q < num_qpts_in; q++) { 691437c7c90SJeremy L Thompson for (CeedInt e_in = 0; e_in < num_eval_modes_in[0]; e_in++) { 692506b1a0cSSebastian Grimberg const CeedSize btd_index = n * (num_qpts_in * num_eval_modes_in[0]) + q * num_eval_modes_in[0] + e_in; 693067fd99fSJeremy L Thompson CeedScalar sum = 0.0; 6941c66c397SJeremy L Thompson 695437c7c90SJeremy L Thompson for (CeedInt e_out = 0; e_out < num_eval_modes_out[0]; e_out++) { 696506b1a0cSSebastian Grimberg const CeedSize b_out_index = (q * num_eval_modes_out[0] + e_out) * elem_size_out + n; 697506b1a0cSSebastian Grimberg const CeedSize eval_mode_index = ((e_in * num_comp_in + comp_in) * num_eval_modes_out[0] + e_out) * num_comp_out + comp_out; 698b94338b9SJed Brown const CeedSize qf_index = q * layout_qf[0] + eval_mode_index * layout_qf[1] + e * layout_qf[2]; 6991c66c397SJeremy L Thompson 700067fd99fSJeremy L Thompson sum += B_mat_out[b_out_index] * assembled_qf_array[qf_index]; 701eaf62fffSJeremy L Thompson } 702067fd99fSJeremy L Thompson BTD_mat[btd_index] = sum; 703ed9e99e6SJeremy L Thompson } 704ed9e99e6SJeremy L Thompson } 705eaf62fffSJeremy L Thompson } 7067c1dbaffSSebastian Grimberg 7077c1dbaffSSebastian Grimberg // Form element matrix itself (for each block component) 708e4065a52SSebastian Grimberg if (contract) { 7090459ebd3SSebastian Grimberg CeedCall(CeedTensorContractApply(contract, 1, num_qpts_in * num_eval_modes_in[0], elem_size_in, elem_size_out, BTD_mat, CEED_NOTRANSPOSE, 7100459ebd3SSebastian Grimberg false, B_mat_in, elem_mat)); 711e4065a52SSebastian Grimberg } else { 712e4065a52SSebastian Grimberg CeedCall(CeedMatrixMatrixMultiply(ceed, BTD_mat, B_mat_in, elem_mat, elem_size_out, elem_size_in, num_qpts_in * num_eval_modes_in[0])); 713e4065a52SSebastian Grimberg } 714eaf62fffSJeremy L Thompson 7157c1dbaffSSebastian Grimberg // Transform the element matrix if required 716506b1a0cSSebastian Grimberg if (elem_rstr_orients_out) { 717506b1a0cSSebastian Grimberg const bool *elem_orients = &elem_rstr_orients_out[e * elem_size_out]; 7181c66c397SJeremy L Thompson 719506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 720506b1a0cSSebastian Grimberg const double orient = elem_orients[i] ? -1.0 : 1.0; 721506b1a0cSSebastian Grimberg 722506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 723506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] *= orient; 7247c1dbaffSSebastian Grimberg } 7257c1dbaffSSebastian Grimberg } 726506b1a0cSSebastian Grimberg } else if (elem_rstr_curl_orients_out) { 727506b1a0cSSebastian Grimberg const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_out[e * 3 * elem_size_out]; 7281c66c397SJeremy L Thompson 7297c1dbaffSSebastian Grimberg // T^T*(B^T*D*B) 730506b1a0cSSebastian Grimberg memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar)); 731506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 732506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 733506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * i + 1] + 734506b1a0cSSebastian Grimberg (i > 0 ? elem_mat_b[(i - 1) * elem_size_in + j] * elem_curl_orients[3 * i - 1] : 0.0) + 735506b1a0cSSebastian Grimberg (i < elem_size_out - 1 ? elem_mat_b[(i + 1) * elem_size_in + j] * elem_curl_orients[3 * i + 3] : 0.0); 7367c1dbaffSSebastian Grimberg } 7377c1dbaffSSebastian Grimberg } 738506b1a0cSSebastian Grimberg } 739506b1a0cSSebastian Grimberg if (elem_rstr_orients_in) { 740506b1a0cSSebastian Grimberg const bool *elem_orients = &elem_rstr_orients_in[e * elem_size_in]; 741506b1a0cSSebastian Grimberg 742506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 743506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 744506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] *= elem_orients[j] ? -1.0 : 1.0; 745506b1a0cSSebastian Grimberg } 746506b1a0cSSebastian Grimberg } 747506b1a0cSSebastian Grimberg } else if (elem_rstr_curl_orients_in) { 748506b1a0cSSebastian Grimberg const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_in[e * 3 * elem_size_in]; 749506b1a0cSSebastian Grimberg 750506b1a0cSSebastian Grimberg // (B^T*D*B)*T 751506b1a0cSSebastian Grimberg memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar)); 752506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 753506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 754506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * j + 1] + 755506b1a0cSSebastian Grimberg (j > 0 ? elem_mat_b[i * elem_size_in + j - 1] * elem_curl_orients[3 * j - 1] : 0.0) + 756506b1a0cSSebastian Grimberg (j < elem_size_in - 1 ? elem_mat_b[i * elem_size_in + j + 1] * elem_curl_orients[3 * j + 3] : 0.0); 7577c1dbaffSSebastian Grimberg } 7587c1dbaffSSebastian Grimberg } 7597c1dbaffSSebastian Grimberg } 7607c1dbaffSSebastian Grimberg 7617c1dbaffSSebastian Grimberg // Put element matrix in coordinate data structure 762506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 763506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 764506b1a0cSSebastian Grimberg vals[offset + count] = elem_mat[i * elem_size_in + j]; 765eaf62fffSJeremy L Thompson count++; 766eaf62fffSJeremy L Thompson } 767eaf62fffSJeremy L Thompson } 768eaf62fffSJeremy L Thompson } 769eaf62fffSJeremy L Thompson } 770eaf62fffSJeremy L Thompson } 7716574a04fSJeremy L Thompson CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing entries"); 7722b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(values, &vals)); 773eaf62fffSJeremy L Thompson 774506b1a0cSSebastian Grimberg // Cleanup 775123d890dSSebastian Grimberg CeedCall(CeedFree(&BTD_mat)); 776123d890dSSebastian Grimberg CeedCall(CeedFree(&elem_mat)); 777506b1a0cSSebastian Grimberg CeedCall(CeedFree(&elem_mat_b)); 778506b1a0cSSebastian Grimberg if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) { 779506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_in, &elem_rstr_orients_in)); 780506b1a0cSSebastian Grimberg } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) { 781506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_in, &elem_rstr_curl_orients_in)); 782506b1a0cSSebastian Grimberg } 783506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 784506b1a0cSSebastian Grimberg if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) { 785506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_out, &elem_rstr_orients_out)); 786506b1a0cSSebastian Grimberg } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) { 787506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_out, &elem_rstr_curl_orients_out)); 788506b1a0cSSebastian Grimberg } 789506b1a0cSSebastian Grimberg } 7902b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array)); 7912b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_qf)); 792681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 793681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 794eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 795eaf62fffSJeremy L Thompson } 796eaf62fffSJeremy L Thompson 797eaf62fffSJeremy L Thompson /** 798ca94c3ddSJeremy L Thompson @brief Count number of entries for assembled `CeedOperator` 799eaf62fffSJeremy L Thompson 800ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 801eaf62fffSJeremy L Thompson @param[out] num_entries Number of entries in assembled representation 802eaf62fffSJeremy L Thompson 803eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 804eaf62fffSJeremy L Thompson 805eaf62fffSJeremy L Thompson @ref Utility 806eaf62fffSJeremy L Thompson **/ 807b94338b9SJed Brown static int CeedSingleOperatorAssemblyCountEntries(CeedOperator op, CeedSize *num_entries) { 808b275c451SJeremy L Thompson bool is_composite; 809506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, num_elem_out, elem_size_out, num_comp_out; 8101203703bSJeremy L Thompson Ceed ceed; 811506b1a0cSSebastian Grimberg CeedElemRestriction rstr_in, rstr_out; 812eaf62fffSJeremy L Thompson 8131203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 814b275c451SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 8151203703bSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 816506b1a0cSSebastian Grimberg 817506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &rstr_in, &rstr_out)); 818506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr_in, &num_elem_in)); 819506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr_in, &elem_size_in)); 820506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr_in, &num_comp_in)); 821506b1a0cSSebastian Grimberg if (rstr_in != rstr_out) { 822506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr_out, &num_elem_out)); 8231203703bSJeremy L Thompson CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 8243f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 8253f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 8263f08121cSJeremy L Thompson num_elem_in, num_elem_out); 827506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr_out, &elem_size_out)); 828506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr_out, &num_comp_out)); 829506b1a0cSSebastian Grimberg } else { 830506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 831506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 832506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 833506b1a0cSSebastian Grimberg } 834681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_in)); 835681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_out)); 836506b1a0cSSebastian Grimberg *num_entries = (CeedSize)elem_size_in * num_comp_in * elem_size_out * num_comp_out * num_elem_in; 837eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 838eaf62fffSJeremy L Thompson } 839eaf62fffSJeremy L Thompson 840eaf62fffSJeremy L Thompson /** 841ca94c3ddSJeremy L Thompson @brief Common code for creating a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` 842eaf62fffSJeremy L Thompson 843ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 844ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 845ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 846ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 847ca94c3ddSJeremy L Thompson @param[in] basis_c_to_f `CeedBasis` for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction operators 848ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 849ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 850ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 851eaf62fffSJeremy L Thompson 852eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 853eaf62fffSJeremy L Thompson 854eaf62fffSJeremy L Thompson @ref Developer 855eaf62fffSJeremy L Thompson **/ 8562b730f8bSJeremy L Thompson static int CeedSingleOperatorMultigridLevel(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 8577758292fSSebastian Grimberg CeedBasis basis_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) { 8581c66c397SJeremy L Thompson bool is_composite; 859eaf62fffSJeremy L Thompson Ceed ceed; 8601203703bSJeremy L Thompson CeedInt num_comp, num_input_fields, num_output_fields; 86185bb9dcfSJeremy L Thompson CeedVector mult_vec = NULL; 8621c66c397SJeremy L Thompson CeedElemRestriction rstr_p_mult_fine = NULL, rstr_fine = NULL; 8631203703bSJeremy L Thompson CeedOperatorField *input_fields, *output_fields; 8641c66c397SJeremy L Thompson 8652b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 866eaf62fffSJeremy L Thompson 867eaf62fffSJeremy L Thompson // Check for composite operator 8682b730f8bSJeremy L Thompson CeedCall(CeedOperatorIsComposite(op_fine, &is_composite)); 8696574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Automatic multigrid setup for composite operators not supported"); 870eaf62fffSJeremy L Thompson 871eaf62fffSJeremy L Thompson // Coarse Grid 8722b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse)); 8731203703bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op_fine, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 874eaf62fffSJeremy L Thompson // -- Clone input fields 8751203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 8766f8994e9SJeremy L Thompson const char *field_name; 8771203703bSJeremy L Thompson CeedVector vec; 878681d0ea7SJeremy L Thompson CeedElemRestriction rstr = NULL; 879681d0ea7SJeremy L Thompson CeedBasis basis = NULL; 8801203703bSJeremy L Thompson 8811203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetName(input_fields[i], &field_name)); 8821203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(input_fields[i], &vec)); 8831203703bSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 884681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr)); 885681d0ea7SJeremy L Thompson CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis)); 886681d0ea7SJeremy L Thompson if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr_fine)); 887eaf62fffSJeremy L Thompson } else { 8881203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr)); 8891203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(input_fields[i], &basis)); 890eaf62fffSJeremy L Thompson } 8911203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec)); 892681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 893681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 894681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 895eaf62fffSJeremy L Thompson } 896eaf62fffSJeremy L Thompson // -- Clone output fields 8971203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 8986f8994e9SJeremy L Thompson const char *field_name; 8991203703bSJeremy L Thompson CeedVector vec; 900681d0ea7SJeremy L Thompson CeedElemRestriction rstr = NULL; 901681d0ea7SJeremy L Thompson CeedBasis basis = NULL; 9021203703bSJeremy L Thompson 9031203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetName(output_fields[i], &field_name)); 9041203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(output_fields[i], &vec)); 9051203703bSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 906681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr)); 907681d0ea7SJeremy L Thompson CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis)); 908681d0ea7SJeremy L Thompson if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr_fine)); 909eaf62fffSJeremy L Thompson } else { 9101203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr)); 9111203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(output_fields[i], &basis)); 912eaf62fffSJeremy L Thompson } 9131203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec)); 914681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 915681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 916681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 917eaf62fffSJeremy L Thompson } 918af99e877SJeremy L Thompson // -- Clone QFunctionAssemblyData 9197d5185d7SSebastian Grimberg { 9207d5185d7SSebastian Grimberg CeedQFunctionAssemblyData fine_data; 9217d5185d7SSebastian Grimberg 9227d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op_fine, &fine_data)); 9237d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataReferenceCopy(fine_data, &(*op_coarse)->qf_assembled)); 9247d5185d7SSebastian Grimberg } 925eaf62fffSJeremy L Thompson 926eaf62fffSJeremy L Thompson // Multiplicity vector 9277758292fSSebastian Grimberg if (op_restrict || op_prolong) { 92885bb9dcfSJeremy L Thompson CeedVector mult_e_vec; 9291c66c397SJeremy L Thompson CeedRestrictionType rstr_type; 93085bb9dcfSJeremy L Thompson 9317c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(rstr_fine, &rstr_type)); 9327c1dbaffSSebastian Grimberg CeedCheck(rstr_type != CEED_RESTRICTION_CURL_ORIENTED, ceed, CEED_ERROR_UNSUPPORTED, 9337c1dbaffSSebastian Grimberg "Element restrictions created with CeedElemRestrictionCreateCurlOriented are not supported"); 9346574a04fSJeremy L Thompson CeedCheck(p_mult_fine, ceed, CEED_ERROR_INCOMPATIBLE, "Prolongation or restriction operator creation requires fine grid multiplicity vector"); 9357c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnsignedCopy(rstr_fine, &rstr_p_mult_fine)); 9362b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionCreateVector(rstr_fine, &mult_vec, &mult_e_vec)); 9372b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(mult_e_vec, 0.0)); 938c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_NOTRANSPOSE, p_mult_fine, mult_e_vec, CEED_REQUEST_IMMEDIATE)); 9392b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(mult_vec, 0.0)); 940c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_TRANSPOSE, mult_e_vec, mult_vec, CEED_REQUEST_IMMEDIATE)); 9412b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&mult_e_vec)); 9422b730f8bSJeremy L Thompson CeedCall(CeedVectorReciprocal(mult_vec)); 94385bb9dcfSJeremy L Thompson } 944eaf62fffSJeremy L Thompson 945addd79feSZach Atkins // Clone name 946addd79feSZach Atkins bool has_name = op_fine->name; 947addd79feSZach Atkins size_t name_len = op_fine->name ? strlen(op_fine->name) : 0; 948addd79feSZach Atkins CeedCall(CeedOperatorSetName(*op_coarse, op_fine->name)); 949addd79feSZach Atkins 9507758292fSSebastian Grimberg // Check that coarse to fine basis is provided if prolong/restrict operators are requested 9517758292fSSebastian Grimberg CeedCheck(basis_c_to_f || (!op_restrict && !op_prolong), ceed, CEED_ERROR_INCOMPATIBLE, 9526574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine basis"); 95383d6adf3SZach Atkins 95485bb9dcfSJeremy L Thompson // Restriction/Prolongation Operators 9552b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_coarse, &num_comp)); 956addd79feSZach Atkins 957addd79feSZach Atkins // Restriction 9587758292fSSebastian Grimberg if (op_restrict) { 959eaf62fffSJeremy L Thompson CeedInt *num_comp_r_data; 96085bb9dcfSJeremy L Thompson CeedQFunctionContext ctx_r; 9617758292fSSebastian Grimberg CeedQFunction qf_restrict; 96285bb9dcfSJeremy L Thompson 9637758292fSSebastian Grimberg CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_restrict)); 9642b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_r_data)); 965eaf62fffSJeremy L Thompson num_comp_r_data[0] = num_comp; 9662b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_r)); 9672b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_r, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_r_data), num_comp_r_data)); 9687758292fSSebastian Grimberg CeedCall(CeedQFunctionSetContext(qf_restrict, ctx_r)); 9692b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_r)); 9707758292fSSebastian Grimberg CeedCall(CeedQFunctionAddInput(qf_restrict, "input", num_comp, CEED_EVAL_NONE)); 9717758292fSSebastian Grimberg CeedCall(CeedQFunctionAddInput(qf_restrict, "scale", num_comp, CEED_EVAL_NONE)); 9727758292fSSebastian Grimberg CeedCall(CeedQFunctionAddOutput(qf_restrict, "output", num_comp, CEED_EVAL_INTERP)); 9737758292fSSebastian Grimberg CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_restrict, num_comp)); 974eaf62fffSJeremy L Thompson 9757758292fSSebastian Grimberg CeedCall(CeedOperatorCreate(ceed, qf_restrict, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_restrict)); 9767758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "input", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE)); 9777758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec)); 9787758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "output", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE)); 979eaf62fffSJeremy L Thompson 980addd79feSZach Atkins // Set name 981addd79feSZach Atkins char *restriction_name; 9821c66c397SJeremy L Thompson 983addd79feSZach Atkins CeedCall(CeedCalloc(17 + name_len, &restriction_name)); 984addd79feSZach Atkins sprintf(restriction_name, "restriction%s%s", has_name ? " for " : "", has_name ? op_fine->name : ""); 9857758292fSSebastian Grimberg CeedCall(CeedOperatorSetName(*op_restrict, restriction_name)); 986addd79feSZach Atkins CeedCall(CeedFree(&restriction_name)); 987addd79feSZach Atkins 988addd79feSZach Atkins // Check 9897758292fSSebastian Grimberg CeedCall(CeedOperatorCheckReady(*op_restrict)); 990addd79feSZach Atkins 991addd79feSZach Atkins // Cleanup 9927758292fSSebastian Grimberg CeedCall(CeedQFunctionDestroy(&qf_restrict)); 993addd79feSZach Atkins } 994addd79feSZach Atkins 995eaf62fffSJeremy L Thompson // Prolongation 996addd79feSZach Atkins if (op_prolong) { 997eaf62fffSJeremy L Thompson CeedInt *num_comp_p_data; 99885bb9dcfSJeremy L Thompson CeedQFunctionContext ctx_p; 9991c66c397SJeremy L Thompson CeedQFunction qf_prolong; 100085bb9dcfSJeremy L Thompson 100185bb9dcfSJeremy L Thompson CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_prolong)); 10022b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_p_data)); 1003eaf62fffSJeremy L Thompson num_comp_p_data[0] = num_comp; 10042b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_p)); 10052b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_p, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_p_data), num_comp_p_data)); 10062b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(qf_prolong, ctx_p)); 10072b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_p)); 10082b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_prolong, "input", num_comp, CEED_EVAL_INTERP)); 10092b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_prolong, "scale", num_comp, CEED_EVAL_NONE)); 10102b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(qf_prolong, "output", num_comp, CEED_EVAL_NONE)); 10112b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_prolong, num_comp)); 1012eaf62fffSJeremy L Thompson 10132b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed, qf_prolong, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_prolong)); 10142b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "input", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE)); 1015356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec)); 1016356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "output", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE)); 1017eaf62fffSJeremy L Thompson 1018addd79feSZach Atkins // Set name 1019ea6b5821SJeremy L Thompson char *prolongation_name; 10201c66c397SJeremy L Thompson 10212b730f8bSJeremy L Thompson CeedCall(CeedCalloc(18 + name_len, &prolongation_name)); 10222b730f8bSJeremy L Thompson sprintf(prolongation_name, "prolongation%s%s", has_name ? " for " : "", has_name ? op_fine->name : ""); 10232b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetName(*op_prolong, prolongation_name)); 10242b730f8bSJeremy L Thompson CeedCall(CeedFree(&prolongation_name)); 1025addd79feSZach Atkins 1026addd79feSZach Atkins // Check 1027addd79feSZach Atkins CeedCall(CeedOperatorCheckReady(*op_prolong)); 1028addd79feSZach Atkins 1029addd79feSZach Atkins // Cleanup 1030addd79feSZach Atkins CeedCall(CeedQFunctionDestroy(&qf_prolong)); 1031ea6b5821SJeremy L Thompson } 1032ea6b5821SJeremy L Thompson 103358e4b056SJeremy L Thompson // Check 103458e4b056SJeremy L Thompson CeedCall(CeedOperatorCheckReady(*op_coarse)); 103558e4b056SJeremy L Thompson 1036eaf62fffSJeremy L Thompson // Cleanup 10372b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&mult_vec)); 1038681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_fine)); 1039c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_fine)); 10402b730f8bSJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_c_to_f)); 1041eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1042eaf62fffSJeremy L Thompson } 1043eaf62fffSJeremy L Thompson 1044eaf62fffSJeremy L Thompson /** 1045eaf62fffSJeremy L Thompson @brief Build 1D mass matrix and Laplacian with perturbation 1046eaf62fffSJeremy L Thompson 1047eaf62fffSJeremy L Thompson @param[in] interp_1d Interpolation matrix in one dimension 1048eaf62fffSJeremy L Thompson @param[in] grad_1d Gradient matrix in one dimension 1049eaf62fffSJeremy L Thompson @param[in] q_weight_1d Quadrature weights in one dimension 1050eaf62fffSJeremy L Thompson @param[in] P_1d Number of basis nodes in one dimension 1051eaf62fffSJeremy L Thompson @param[in] Q_1d Number of quadrature points in one dimension 1052eaf62fffSJeremy L Thompson @param[in] dim Dimension of basis 1053eaf62fffSJeremy L Thompson @param[out] mass Assembled mass matrix in one dimension 1054eaf62fffSJeremy L Thompson @param[out] laplace Assembled perturbed Laplacian in one dimension 1055eaf62fffSJeremy L Thompson 1056eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1057eaf62fffSJeremy L Thompson 1058eaf62fffSJeremy L Thompson @ref Developer 1059eaf62fffSJeremy L Thompson **/ 10602c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOff 10612c2ea1dbSJeremy L Thompson static int CeedBuildMassLaplace(const CeedScalar *interp_1d, const CeedScalar *grad_1d, const CeedScalar *q_weight_1d, CeedInt P_1d, CeedInt Q_1d, 10622c2ea1dbSJeremy L Thompson CeedInt dim, CeedScalar *mass, CeedScalar *laplace) { 10632b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 1064eaf62fffSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) { 1065eaf62fffSJeremy L Thompson CeedScalar sum = 0.0; 10662b730f8bSJeremy L Thompson for (CeedInt k = 0; k < Q_1d; k++) sum += interp_1d[k * P_1d + i] * q_weight_1d[k] * interp_1d[k * P_1d + j]; 1067eaf62fffSJeremy L Thompson mass[i + j * P_1d] = sum; 1068eaf62fffSJeremy L Thompson } 10692b730f8bSJeremy L Thompson } 1070eaf62fffSJeremy L Thompson // -- Laplacian 10712b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 1072eaf62fffSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) { 1073eaf62fffSJeremy L Thompson CeedScalar sum = 0.0; 10741c66c397SJeremy L Thompson 10752b730f8bSJeremy L Thompson for (CeedInt k = 0; k < Q_1d; k++) sum += grad_1d[k * P_1d + i] * q_weight_1d[k] * grad_1d[k * P_1d + j]; 1076eaf62fffSJeremy L Thompson laplace[i + j * P_1d] = sum; 1077eaf62fffSJeremy L Thompson } 10782b730f8bSJeremy L Thompson } 1079eaf62fffSJeremy L Thompson CeedScalar perturbation = dim > 2 ? 1e-6 : 1e-4; 10802b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) laplace[i + P_1d * i] += perturbation; 1081eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1082eaf62fffSJeremy L Thompson } 10832c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOn 1084eaf62fffSJeremy L Thompson 1085eaf62fffSJeremy L Thompson /// @} 1086eaf62fffSJeremy L Thompson 1087eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 1088480fae85SJeremy L Thompson /// CeedOperator Backend API 1089480fae85SJeremy L Thompson /// ---------------------------------------------------------------------------- 1090480fae85SJeremy L Thompson /// @addtogroup CeedOperatorBackend 1091480fae85SJeremy L Thompson /// @{ 1092480fae85SJeremy L Thompson 1093480fae85SJeremy L Thompson /** 1094004e4986SSebastian Grimberg @brief Select correct basis matrix pointer based on @ref CeedEvalMode 1095004e4986SSebastian Grimberg 1096004e4986SSebastian Grimberg @param[in] basis `CeedBasis` from which to get the basis matrix 1097004e4986SSebastian Grimberg @param[in] eval_mode Current basis evaluation mode 1098004e4986SSebastian Grimberg @param[in] identity Pointer to identity matrix 1099004e4986SSebastian Grimberg @param[out] basis_ptr `CeedBasis` pointer to set 1100004e4986SSebastian Grimberg 1101004e4986SSebastian Grimberg @ref Backend 1102004e4986SSebastian Grimberg **/ 1103004e4986SSebastian Grimberg int CeedOperatorGetBasisPointer(CeedBasis basis, CeedEvalMode eval_mode, const CeedScalar *identity, const CeedScalar **basis_ptr) { 1104004e4986SSebastian Grimberg switch (eval_mode) { 1105004e4986SSebastian Grimberg case CEED_EVAL_NONE: 1106004e4986SSebastian Grimberg *basis_ptr = identity; 1107004e4986SSebastian Grimberg break; 1108004e4986SSebastian Grimberg case CEED_EVAL_INTERP: 1109004e4986SSebastian Grimberg CeedCall(CeedBasisGetInterp(basis, basis_ptr)); 1110004e4986SSebastian Grimberg break; 1111004e4986SSebastian Grimberg case CEED_EVAL_GRAD: 1112004e4986SSebastian Grimberg CeedCall(CeedBasisGetGrad(basis, basis_ptr)); 1113004e4986SSebastian Grimberg break; 1114004e4986SSebastian Grimberg case CEED_EVAL_DIV: 1115004e4986SSebastian Grimberg CeedCall(CeedBasisGetDiv(basis, basis_ptr)); 1116004e4986SSebastian Grimberg break; 1117004e4986SSebastian Grimberg case CEED_EVAL_CURL: 1118004e4986SSebastian Grimberg CeedCall(CeedBasisGetCurl(basis, basis_ptr)); 1119004e4986SSebastian Grimberg break; 1120004e4986SSebastian Grimberg case CEED_EVAL_WEIGHT: 1121004e4986SSebastian Grimberg break; // Caught by QF Assembly 1122004e4986SSebastian Grimberg } 1123004e4986SSebastian Grimberg assert(*basis_ptr != NULL); 1124004e4986SSebastian Grimberg return CEED_ERROR_SUCCESS; 1125004e4986SSebastian Grimberg } 1126004e4986SSebastian Grimberg 1127004e4986SSebastian Grimberg /** 1128ca94c3ddSJeremy L Thompson @brief Create point block restriction for active `CeedOperatorField` 1129506b1a0cSSebastian Grimberg 1130ca94c3ddSJeremy L Thompson @param[in] rstr Original `CeedElemRestriction` for active field 1131ca94c3ddSJeremy L Thompson @param[out] point_block_rstr Address of the variable where the newly created `CeedElemRestriction` will be stored 1132506b1a0cSSebastian Grimberg 1133506b1a0cSSebastian Grimberg @return An error code: 0 - success, otherwise - failure 1134506b1a0cSSebastian Grimberg 1135506b1a0cSSebastian Grimberg @ref Backend 1136506b1a0cSSebastian Grimberg **/ 1137506b1a0cSSebastian Grimberg int CeedOperatorCreateActivePointBlockRestriction(CeedElemRestriction rstr, CeedElemRestriction *point_block_rstr) { 1138506b1a0cSSebastian Grimberg Ceed ceed; 1139506b1a0cSSebastian Grimberg CeedInt num_elem, num_comp, shift, elem_size, comp_stride, *point_block_offsets; 1140506b1a0cSSebastian Grimberg CeedSize l_size; 1141506b1a0cSSebastian Grimberg const CeedInt *offsets; 1142506b1a0cSSebastian Grimberg 1143506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCeed(rstr, &ceed)); 1144506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOffsets(rstr, CEED_MEM_HOST, &offsets)); 1145506b1a0cSSebastian Grimberg 1146506b1a0cSSebastian Grimberg // Expand offsets 1147506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem)); 1148506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp)); 1149506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size)); 1150506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCompStride(rstr, &comp_stride)); 1151506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size)); 1152506b1a0cSSebastian Grimberg shift = num_comp; 1153506b1a0cSSebastian Grimberg if (comp_stride != 1) shift *= num_comp; 1154506b1a0cSSebastian Grimberg CeedCall(CeedCalloc(num_elem * elem_size, &point_block_offsets)); 1155506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_elem * elem_size; i++) { 1156506b1a0cSSebastian Grimberg point_block_offsets[i] = offsets[i] * shift; 1157506b1a0cSSebastian Grimberg } 1158506b1a0cSSebastian Grimberg 1159506b1a0cSSebastian Grimberg // Create new restriction 1160506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreate(ceed, num_elem, elem_size, num_comp * num_comp, 1, l_size * num_comp, CEED_MEM_HOST, CEED_OWN_POINTER, 1161506b1a0cSSebastian Grimberg point_block_offsets, point_block_rstr)); 1162506b1a0cSSebastian Grimberg 1163506b1a0cSSebastian Grimberg // Cleanup 1164506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOffsets(rstr, &offsets)); 1165506b1a0cSSebastian Grimberg return CEED_ERROR_SUCCESS; 1166506b1a0cSSebastian Grimberg } 1167506b1a0cSSebastian Grimberg 1168506b1a0cSSebastian Grimberg /** 11697d5185d7SSebastian Grimberg @brief Get `CeedQFunctionAssemblyData` 11707d5185d7SSebastian Grimberg 11717d5185d7SSebastian Grimberg @param[in] op `CeedOperator` to assemble 11727d5185d7SSebastian Grimberg @param[out] data `CeedQFunctionAssemblyData` 11737d5185d7SSebastian Grimberg 11747d5185d7SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 11757d5185d7SSebastian Grimberg 11767d5185d7SSebastian Grimberg @ref Backend 11777d5185d7SSebastian Grimberg **/ 11787d5185d7SSebastian Grimberg int CeedOperatorGetQFunctionAssemblyData(CeedOperator op, CeedQFunctionAssemblyData *data) { 11797d5185d7SSebastian Grimberg if (!op->qf_assembled) { 11807d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 11817d5185d7SSebastian Grimberg 11827d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataCreate(op->ceed, &data)); 11837d5185d7SSebastian Grimberg op->qf_assembled = data; 11847d5185d7SSebastian Grimberg } 11857d5185d7SSebastian Grimberg *data = op->qf_assembled; 11867d5185d7SSebastian Grimberg return CEED_ERROR_SUCCESS; 11877d5185d7SSebastian Grimberg } 11887d5185d7SSebastian Grimberg 11897d5185d7SSebastian Grimberg /** 1190ca94c3ddSJeremy L Thompson @brief Create object holding `CeedQFunction` assembly data for `CeedOperator` 1191480fae85SJeremy L Thompson 1192ca94c3ddSJeremy L Thompson @param[in] ceed `Ceed` object used to create the `CeedQFunctionAssemblyData` 1193ca94c3ddSJeremy L Thompson @param[out] data Address of the variable where the newly created `CeedQFunctionAssemblyData` will be stored 1194480fae85SJeremy L Thompson 1195480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1196480fae85SJeremy L Thompson 1197480fae85SJeremy L Thompson @ref Backend 1198480fae85SJeremy L Thompson **/ 1199ea61e9acSJeremy L Thompson int CeedQFunctionAssemblyDataCreate(Ceed ceed, CeedQFunctionAssemblyData *data) { 12002b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, data)); 1201480fae85SJeremy L Thompson (*data)->ref_count = 1; 1202480fae85SJeremy L Thompson (*data)->ceed = ceed; 12032b730f8bSJeremy L Thompson CeedCall(CeedReference(ceed)); 1204480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1205480fae85SJeremy L Thompson } 1206480fae85SJeremy L Thompson 1207480fae85SJeremy L Thompson /** 1208ca94c3ddSJeremy L Thompson @brief Increment the reference counter for a `CeedQFunctionAssemblyData` 1209480fae85SJeremy L Thompson 1210ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to increment the reference counter 1211480fae85SJeremy L Thompson 1212480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1213480fae85SJeremy L Thompson 1214480fae85SJeremy L Thompson @ref Backend 1215480fae85SJeremy L Thompson **/ 1216480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataReference(CeedQFunctionAssemblyData data) { 1217480fae85SJeremy L Thompson data->ref_count++; 1218480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1219480fae85SJeremy L Thompson } 1220480fae85SJeremy L Thompson 1221480fae85SJeremy L Thompson /** 1222ca94c3ddSJeremy L Thompson @brief Set re-use of `CeedQFunctionAssemblyData` 12238b919e6bSJeremy L Thompson 1224ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to mark for reuse 1225ea61e9acSJeremy L Thompson @param[in] reuse_data Boolean flag indicating data re-use 12268b919e6bSJeremy L Thompson 12278b919e6bSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 12288b919e6bSJeremy L Thompson 12298b919e6bSJeremy L Thompson @ref Backend 12308b919e6bSJeremy L Thompson **/ 12312b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetReuse(CeedQFunctionAssemblyData data, bool reuse_data) { 1232beecbf24SJeremy L Thompson data->reuse_data = reuse_data; 1233beecbf24SJeremy L Thompson data->needs_data_update = true; 1234beecbf24SJeremy L Thompson return CEED_ERROR_SUCCESS; 1235beecbf24SJeremy L Thompson } 1236beecbf24SJeremy L Thompson 1237beecbf24SJeremy L Thompson /** 1238ca94c3ddSJeremy L Thompson @brief Mark `CeedQFunctionAssemblyData` as stale 1239beecbf24SJeremy L Thompson 1240ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to mark as stale 1241ea61e9acSJeremy L Thompson @param[in] needs_data_update Boolean flag indicating if update is needed or completed 1242beecbf24SJeremy L Thompson 1243beecbf24SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1244beecbf24SJeremy L Thompson 1245beecbf24SJeremy L Thompson @ref Backend 1246beecbf24SJeremy L Thompson **/ 12472b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetUpdateNeeded(CeedQFunctionAssemblyData data, bool needs_data_update) { 1248beecbf24SJeremy L Thompson data->needs_data_update = needs_data_update; 12498b919e6bSJeremy L Thompson return CEED_ERROR_SUCCESS; 12508b919e6bSJeremy L Thompson } 12518b919e6bSJeremy L Thompson 12528b919e6bSJeremy L Thompson /** 1253ca94c3ddSJeremy L Thompson @brief Determine if `CeedQFunctionAssemblyData` needs update 12548b919e6bSJeremy L Thompson 1255ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to mark as stale 12568b919e6bSJeremy L Thompson @param[out] is_update_needed Boolean flag indicating if re-assembly is required 12578b919e6bSJeremy L Thompson 12588b919e6bSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 12598b919e6bSJeremy L Thompson 12608b919e6bSJeremy L Thompson @ref Backend 12618b919e6bSJeremy L Thompson **/ 12622b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsUpdateNeeded(CeedQFunctionAssemblyData data, bool *is_update_needed) { 1263beecbf24SJeremy L Thompson *is_update_needed = !data->reuse_data || data->needs_data_update; 12648b919e6bSJeremy L Thompson return CEED_ERROR_SUCCESS; 12658b919e6bSJeremy L Thompson } 12668b919e6bSJeremy L Thompson 12678b919e6bSJeremy L Thompson /** 1268ca94c3ddSJeremy L Thompson @brief Copy the pointer to a `CeedQFunctionAssemblyData`. 12694385fb7fSSebastian Grimberg 1270ca94c3ddSJeremy L Thompson Both pointers should be destroyed with @ref CeedQFunctionAssemblyDataDestroy(). 1271512bb800SJeremy L Thompson 1272ca94c3ddSJeremy L Thompson Note: If the value of ` *data_copy` passed to this function is non-`NULL` , then it is assumed that ` *data_copy` is a pointer to a `CeedQFunctionAssemblyData`. 1273ca94c3ddSJeremy L Thompson This `CeedQFunctionAssemblyData` will be destroyed if ` *data_copy` is the only reference to this `CeedQFunctionAssemblyData`. 1274480fae85SJeremy L Thompson 1275ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to copy reference to 1276ea61e9acSJeremy L Thompson @param[in,out] data_copy Variable to store copied reference 1277480fae85SJeremy L Thompson 1278480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1279480fae85SJeremy L Thompson 1280480fae85SJeremy L Thompson @ref Backend 1281480fae85SJeremy L Thompson **/ 12822b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataReferenceCopy(CeedQFunctionAssemblyData data, CeedQFunctionAssemblyData *data_copy) { 12832b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAssemblyDataReference(data)); 12842b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAssemblyDataDestroy(data_copy)); 1285480fae85SJeremy L Thompson *data_copy = data; 1286480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1287480fae85SJeremy L Thompson } 1288480fae85SJeremy L Thompson 1289480fae85SJeremy L Thompson /** 1290ca94c3ddSJeremy L Thompson @brief Get setup status for internal objects for `CeedQFunctionAssemblyData` 1291480fae85SJeremy L Thompson 1292ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to retrieve status 1293480fae85SJeremy L Thompson @param[out] is_setup Boolean flag for setup status 1294480fae85SJeremy L Thompson 1295480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1296480fae85SJeremy L Thompson 1297480fae85SJeremy L Thompson @ref Backend 1298480fae85SJeremy L Thompson **/ 12992b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsSetup(CeedQFunctionAssemblyData data, bool *is_setup) { 1300480fae85SJeremy L Thompson *is_setup = data->is_setup; 1301480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1302480fae85SJeremy L Thompson } 1303480fae85SJeremy L Thompson 1304480fae85SJeremy L Thompson /** 1305ca94c3ddSJeremy L Thompson @brief Set internal objects for `CeedQFunctionAssemblyData` 1306480fae85SJeremy L Thompson 1307ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to set objects 1308ca94c3ddSJeremy L Thompson @param[in] vec `CeedVector` to store assembled `CeedQFunction` at quadrature points 1309ca94c3ddSJeremy L Thompson @param[in] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1310480fae85SJeremy L Thompson 1311480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1312480fae85SJeremy L Thompson 1313480fae85SJeremy L Thompson @ref Backend 1314480fae85SJeremy L Thompson **/ 13152b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetObjects(CeedQFunctionAssemblyData data, CeedVector vec, CeedElemRestriction rstr) { 13162b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(vec, &data->vec)); 13172b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr, &data->rstr)); 1318480fae85SJeremy L Thompson 1319480fae85SJeremy L Thompson data->is_setup = true; 1320480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1321480fae85SJeremy L Thompson } 1322480fae85SJeremy L Thompson 13234dd1a9d2SSebastian Grimberg /** 1324ca94c3ddSJeremy L Thompson @brief Get internal objects for `CeedQFunctionAssemblyData` 13254dd1a9d2SSebastian Grimberg 1326ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to set objects 1327ca94c3ddSJeremy L Thompson @param[out] vec `CeedVector` to store assembled `CeedQFunction` at quadrature points 1328ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 13294dd1a9d2SSebastian Grimberg 13304dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 13314dd1a9d2SSebastian Grimberg 13324dd1a9d2SSebastian Grimberg @ref Backend 13334dd1a9d2SSebastian Grimberg **/ 13342b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataGetObjects(CeedQFunctionAssemblyData data, CeedVector *vec, CeedElemRestriction *rstr) { 13356574a04fSJeremy L Thompson CeedCheck(data->is_setup, data->ceed, CEED_ERROR_INCOMPLETE, "Internal objects not set; must call CeedQFunctionAssemblyDataSetObjects first."); 1336480fae85SJeremy L Thompson 13372b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(data->vec, vec)); 13382b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(data->rstr, rstr)); 1339480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1340480fae85SJeremy L Thompson } 1341480fae85SJeremy L Thompson 1342480fae85SJeremy L Thompson /** 1343ca94c3ddSJeremy L Thompson @brief Destroy `CeedQFunctionAssemblyData` 1344480fae85SJeremy L Thompson 1345ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to destroy 1346480fae85SJeremy L Thompson 1347480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1348480fae85SJeremy L Thompson 1349480fae85SJeremy L Thompson @ref Backend 1350480fae85SJeremy L Thompson **/ 1351480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataDestroy(CeedQFunctionAssemblyData *data) { 1352ad6481ceSJeremy L Thompson if (!*data || --(*data)->ref_count > 0) { 1353ad6481ceSJeremy L Thompson *data = NULL; 1354ad6481ceSJeremy L Thompson return CEED_ERROR_SUCCESS; 1355ad6481ceSJeremy L Thompson } 13562b730f8bSJeremy L Thompson CeedCall(CeedDestroy(&(*data)->ceed)); 13572b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&(*data)->vec)); 13582b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&(*data)->rstr)); 1359480fae85SJeremy L Thompson 13602b730f8bSJeremy L Thompson CeedCall(CeedFree(data)); 1361480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1362480fae85SJeremy L Thompson } 1363480fae85SJeremy L Thompson 1364ed9e99e6SJeremy L Thompson /** 1365ca94c3ddSJeremy L Thompson @brief Get `CeedOperatorAssemblyData` 1366ed9e99e6SJeremy L Thompson 1367ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 13687d5185d7SSebastian Grimberg @param[out] data `CeedOperatorAssemblyData` 1369ed9e99e6SJeremy L Thompson 1370ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1371ed9e99e6SJeremy L Thompson 1372ed9e99e6SJeremy L Thompson @ref Backend 1373ed9e99e6SJeremy L Thompson **/ 13742b730f8bSJeremy L Thompson int CeedOperatorGetOperatorAssemblyData(CeedOperator op, CeedOperatorAssemblyData *data) { 1375ed9e99e6SJeremy L Thompson if (!op->op_assembled) { 1376ed9e99e6SJeremy L Thompson CeedOperatorAssemblyData data; 1377ed9e99e6SJeremy L Thompson 13782b730f8bSJeremy L Thompson CeedCall(CeedOperatorAssemblyDataCreate(op->ceed, op, &data)); 1379ed9e99e6SJeremy L Thompson op->op_assembled = data; 1380ed9e99e6SJeremy L Thompson } 1381ed9e99e6SJeremy L Thompson *data = op->op_assembled; 1382ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1383ed9e99e6SJeremy L Thompson } 1384ed9e99e6SJeremy L Thompson 1385ed9e99e6SJeremy L Thompson /** 1386ca94c3ddSJeremy L Thompson @brief Create object holding `CeedOperator` assembly data. 1387ba746a46SJeremy L Thompson 1388ca94c3ddSJeremy L Thompson The `CeedOperatorAssemblyData` holds an array with references to every active `CeedBasis` used in the `CeedOperator`. 1389ca94c3ddSJeremy L Thompson An array with references to the corresponding active `CeedElemRestriction` is also stored. 1390ca94c3ddSJeremy L Thompson For each active `CeedBasis, the `CeedOperatorAssemblyData` holds an array of all input and output @ref CeedEvalMode for this `CeedBasis`. 1391ca94c3ddSJeremy L Thompson The `CeedOperatorAssemblyData` holds an array of offsets for indexing into the assembled `CeedQFunction` arrays to the row representing each @ref CeedEvalMode. 1392ca94c3ddSJeremy L Thompson The number of input columns across all active bases for the assembled `CeedQFunction` is also stored. 1393ca94c3ddSJeremy L Thompson Lastly, the `CeedOperatorAssembly` data holds assembled matrices representing the full action of the `CeedBasis` for all @ref CeedEvalMode. 1394ed9e99e6SJeremy L Thompson 1395ca94c3ddSJeremy L Thompson @param[in] ceed `Ceed` object used to create the `CeedOperatorAssemblyData` 1396ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to be assembled 1397ca94c3ddSJeremy L Thompson @param[out] data Address of the variable where the newly created `CeedOperatorAssemblyData` will be stored 1398ed9e99e6SJeremy L Thompson 1399ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1400ed9e99e6SJeremy L Thompson 1401ed9e99e6SJeremy L Thompson @ref Backend 1402ed9e99e6SJeremy L Thompson **/ 14032b730f8bSJeremy L Thompson int CeedOperatorAssemblyDataCreate(Ceed ceed, CeedOperator op, CeedOperatorAssemblyData *data) { 1404506b1a0cSSebastian Grimberg CeedInt num_active_bases_in = 0, num_active_bases_out = 0, offset = 0; 1405506b1a0cSSebastian Grimberg CeedInt num_input_fields, *num_eval_modes_in = NULL, num_output_fields, *num_eval_modes_out = NULL; 14061c66c397SJeremy L Thompson CeedSize **eval_mode_offsets_in = NULL, **eval_mode_offsets_out = NULL; 14071c66c397SJeremy L Thompson CeedEvalMode **eval_modes_in = NULL, **eval_modes_out = NULL; 14081c66c397SJeremy L Thompson CeedQFunctionField *qf_fields; 14091c66c397SJeremy L Thompson CeedQFunction qf; 14101c66c397SJeremy L Thompson CeedOperatorField *op_fields; 141101f0e615SJames Wright bool is_composite; 141201f0e615SJames Wright 141301f0e615SJames Wright CeedCall(CeedOperatorIsComposite(op, &is_composite)); 141401f0e615SJames Wright CeedCheck(!is_composite, ceed, CEED_ERROR_INCOMPATIBLE, "Can only create CeedOperator assembly data for non-composite operators."); 1415437c7c90SJeremy L Thompson 1416437c7c90SJeremy L Thompson // Allocate 14172b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, data)); 1418ed9e99e6SJeremy L Thompson (*data)->ceed = ceed; 14192b730f8bSJeremy L Thompson CeedCall(CeedReference(ceed)); 1420ed9e99e6SJeremy L Thompson 1421ed9e99e6SJeremy L Thompson // Build OperatorAssembly data 14222b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetQFunction(op, &qf)); 1423ed9e99e6SJeremy L Thompson 1424ed9e99e6SJeremy L Thompson // Determine active input basis 1425004e4986SSebastian Grimberg CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &qf_fields, NULL, NULL)); 1426004e4986SSebastian Grimberg CeedCall(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL)); 1427ed9e99e6SJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 1428ed9e99e6SJeremy L Thompson CeedVector vec; 14291c66c397SJeremy L Thompson 14302b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 1431ed9e99e6SJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 14327c1dbaffSSebastian Grimberg CeedInt index = -1, num_comp, q_comp; 14331c66c397SJeremy L Thompson CeedEvalMode eval_mode; 14341c66c397SJeremy L Thompson CeedBasis basis_in = NULL; 14351c66c397SJeremy L Thompson 14362b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_in)); 14372b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 1438352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumComponents(basis_in, &num_comp)); 1439352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(basis_in, eval_mode, &q_comp)); 1440506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_active_bases_in; i++) { 1441506b1a0cSSebastian Grimberg if ((*data)->active_bases_in[i] == basis_in) index = i; 1442437c7c90SJeremy L Thompson } 1443437c7c90SJeremy L Thompson if (index == -1) { 1444437c7c90SJeremy L Thompson CeedElemRestriction elem_rstr_in; 14451c66c397SJeremy L Thompson 1446506b1a0cSSebastian Grimberg index = num_active_bases_in; 1447506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_bases_in)); 1448506b1a0cSSebastian Grimberg (*data)->active_bases_in[num_active_bases_in] = NULL; 1449506b1a0cSSebastian Grimberg CeedCall(CeedBasisReferenceCopy(basis_in, &(*data)->active_bases_in[num_active_bases_in])); 1450506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_elem_rstrs_in)); 1451506b1a0cSSebastian Grimberg (*data)->active_elem_rstrs_in[num_active_bases_in] = NULL; 1452437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_in)); 1453506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_in, &(*data)->active_elem_rstrs_in[num_active_bases_in])); 1454681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 1455506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &num_eval_modes_in)); 1456437c7c90SJeremy L Thompson num_eval_modes_in[index] = 0; 1457506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_modes_in)); 1458437c7c90SJeremy L Thompson eval_modes_in[index] = NULL; 1459506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_mode_offsets_in)); 1460437c7c90SJeremy L Thompson eval_mode_offsets_in[index] = NULL; 1461506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->assembled_bases_in)); 1462437c7c90SJeremy L Thompson (*data)->assembled_bases_in[index] = NULL; 1463506b1a0cSSebastian Grimberg num_active_bases_in++; 1464437c7c90SJeremy L Thompson } 1465352a5e7cSSebastian Grimberg if (eval_mode != CEED_EVAL_WEIGHT) { 1466352a5e7cSSebastian Grimberg // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly 1467352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_modes_in[index])); 1468352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_mode_offsets_in[index])); 1469352a5e7cSSebastian Grimberg for (CeedInt d = 0; d < q_comp; d++) { 1470437c7c90SJeremy L Thompson eval_modes_in[index][num_eval_modes_in[index] + d] = eval_mode; 1471437c7c90SJeremy L Thompson eval_mode_offsets_in[index][num_eval_modes_in[index] + d] = offset; 1472352a5e7cSSebastian Grimberg offset += num_comp; 1473ed9e99e6SJeremy L Thompson } 1474352a5e7cSSebastian Grimberg num_eval_modes_in[index] += q_comp; 1475ed9e99e6SJeremy L Thompson } 1476681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_in)); 1477ed9e99e6SJeremy L Thompson } 1478681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 1479ed9e99e6SJeremy L Thompson } 1480ed9e99e6SJeremy L Thompson 1481ed9e99e6SJeremy L Thompson // Determine active output basis 14822b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, NULL, NULL, &num_output_fields, &qf_fields)); 14832b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields)); 1484437c7c90SJeremy L Thompson offset = 0; 1485ed9e99e6SJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 1486ed9e99e6SJeremy L Thompson CeedVector vec; 14871c66c397SJeremy L Thompson 14882b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 1489ed9e99e6SJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 14907c1dbaffSSebastian Grimberg CeedInt index = -1, num_comp, q_comp; 14911c66c397SJeremy L Thompson CeedEvalMode eval_mode; 14921c66c397SJeremy L Thompson CeedBasis basis_out = NULL; 14931c66c397SJeremy L Thompson 1494437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_out)); 14952b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 1496352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumComponents(basis_out, &num_comp)); 1497352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(basis_out, eval_mode, &q_comp)); 1498506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_active_bases_out; i++) { 1499506b1a0cSSebastian Grimberg if ((*data)->active_bases_out[i] == basis_out) index = i; 1500437c7c90SJeremy L Thompson } 1501437c7c90SJeremy L Thompson if (index == -1) { 1502437c7c90SJeremy L Thompson CeedElemRestriction elem_rstr_out; 15031c66c397SJeremy L Thompson 1504506b1a0cSSebastian Grimberg index = num_active_bases_out; 1505506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_bases_out)); 1506506b1a0cSSebastian Grimberg (*data)->active_bases_out[num_active_bases_out] = NULL; 1507506b1a0cSSebastian Grimberg CeedCall(CeedBasisReferenceCopy(basis_out, &(*data)->active_bases_out[num_active_bases_out])); 1508506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_elem_rstrs_out)); 1509506b1a0cSSebastian Grimberg (*data)->active_elem_rstrs_out[num_active_bases_out] = NULL; 1510437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_out)); 1511506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_out, &(*data)->active_elem_rstrs_out[num_active_bases_out])); 1512681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 1513506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &num_eval_modes_out)); 1514437c7c90SJeremy L Thompson num_eval_modes_out[index] = 0; 1515506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_modes_out)); 1516437c7c90SJeremy L Thompson eval_modes_out[index] = NULL; 1517506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_mode_offsets_out)); 1518437c7c90SJeremy L Thompson eval_mode_offsets_out[index] = NULL; 1519506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->assembled_bases_out)); 1520437c7c90SJeremy L Thompson (*data)->assembled_bases_out[index] = NULL; 1521506b1a0cSSebastian Grimberg num_active_bases_out++; 1522437c7c90SJeremy L Thompson } 1523352a5e7cSSebastian Grimberg if (eval_mode != CEED_EVAL_WEIGHT) { 1524352a5e7cSSebastian Grimberg // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly 1525352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_modes_out[index])); 1526352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_mode_offsets_out[index])); 1527352a5e7cSSebastian Grimberg for (CeedInt d = 0; d < q_comp; d++) { 1528437c7c90SJeremy L Thompson eval_modes_out[index][num_eval_modes_out[index] + d] = eval_mode; 1529437c7c90SJeremy L Thompson eval_mode_offsets_out[index][num_eval_modes_out[index] + d] = offset; 1530352a5e7cSSebastian Grimberg offset += num_comp; 1531ed9e99e6SJeremy L Thompson } 1532352a5e7cSSebastian Grimberg num_eval_modes_out[index] += q_comp; 1533ed9e99e6SJeremy L Thompson } 1534681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_out)); 1535ed9e99e6SJeremy L Thompson } 1536681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 1537ed9e99e6SJeremy L Thompson } 1538506b1a0cSSebastian Grimberg (*data)->num_active_bases_in = num_active_bases_in; 153927789c4aSJed Brown (*data)->num_eval_modes_in = num_eval_modes_in; 154027789c4aSJed Brown (*data)->eval_modes_in = eval_modes_in; 154127789c4aSJed Brown (*data)->eval_mode_offsets_in = eval_mode_offsets_in; 1542506b1a0cSSebastian Grimberg (*data)->num_active_bases_out = num_active_bases_out; 1543437c7c90SJeremy L Thompson (*data)->num_eval_modes_out = num_eval_modes_out; 1544437c7c90SJeremy L Thompson (*data)->eval_modes_out = eval_modes_out; 1545437c7c90SJeremy L Thompson (*data)->eval_mode_offsets_out = eval_mode_offsets_out; 1546506b1a0cSSebastian Grimberg (*data)->num_output_components = offset; 1547ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1548ed9e99e6SJeremy L Thompson } 1549ed9e99e6SJeremy L Thompson 1550ed9e99e6SJeremy L Thompson /** 1551ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` @ref CeedEvalMode for assembly. 1552ba746a46SJeremy L Thompson 1553ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1554ed9e99e6SJeremy L Thompson 1555ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1556506b1a0cSSebastian Grimberg @param[out] num_active_bases_in Total number of active bases for input 1557ca94c3ddSJeremy L Thompson @param[out] num_eval_modes_in Pointer to hold array of numbers of input @ref CeedEvalMode, or `NULL`. 1558ca94c3ddSJeremy L Thompson `eval_modes_in[0]` holds an array of eval modes for the first active `CeedBasis`. 1559ca94c3ddSJeremy L Thompson @param[out] eval_modes_in Pointer to hold arrays of input @ref CeedEvalMode, or `NULL` 1560ca94c3ddSJeremy L Thompson @param[out] eval_mode_offsets_in Pointer to hold arrays of input offsets at each quadrature point 1561506b1a0cSSebastian Grimberg @param[out] num_active_bases_out Total number of active bases for output 1562ca94c3ddSJeremy L Thompson @param[out] num_eval_modes_out Pointer to hold array of numbers of output @ref CeedEvalMode, or `NULL` 1563ca94c3ddSJeremy L Thompson @param[out] eval_modes_out Pointer to hold arrays of output @ref CeedEvalMode, or `NULL` 1564437c7c90SJeremy L Thompson @param[out] eval_mode_offsets_out Pointer to hold arrays of output offsets at each quadrature point 1565ca94c3ddSJeremy L Thompson @param[out] num_output_components The number of columns in the assembled `CeedQFunction` matrix for each quadrature point, including contributions of all active bases 1566ed9e99e6SJeremy L Thompson 1567ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1568ed9e99e6SJeremy L Thompson 1569ed9e99e6SJeremy L Thompson @ref Backend 1570ed9e99e6SJeremy L Thompson **/ 1571506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetEvalModes(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedInt **num_eval_modes_in, 1572506b1a0cSSebastian Grimberg const CeedEvalMode ***eval_modes_in, CeedSize ***eval_mode_offsets_in, CeedInt *num_active_bases_out, 1573506b1a0cSSebastian Grimberg CeedInt **num_eval_modes_out, const CeedEvalMode ***eval_modes_out, CeedSize ***eval_mode_offsets_out, 1574506b1a0cSSebastian Grimberg CeedSize *num_output_components) { 1575506b1a0cSSebastian Grimberg if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in; 1576437c7c90SJeremy L Thompson if (num_eval_modes_in) *num_eval_modes_in = data->num_eval_modes_in; 1577437c7c90SJeremy L Thompson if (eval_modes_in) *eval_modes_in = (const CeedEvalMode **)data->eval_modes_in; 1578437c7c90SJeremy L Thompson if (eval_mode_offsets_in) *eval_mode_offsets_in = data->eval_mode_offsets_in; 1579506b1a0cSSebastian Grimberg if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out; 1580437c7c90SJeremy L Thompson if (num_eval_modes_out) *num_eval_modes_out = data->num_eval_modes_out; 1581437c7c90SJeremy L Thompson if (eval_modes_out) *eval_modes_out = (const CeedEvalMode **)data->eval_modes_out; 1582437c7c90SJeremy L Thompson if (eval_mode_offsets_out) *eval_mode_offsets_out = data->eval_mode_offsets_out; 1583437c7c90SJeremy L Thompson if (num_output_components) *num_output_components = data->num_output_components; 1584ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1585ed9e99e6SJeremy L Thompson } 1586ed9e99e6SJeremy L Thompson 1587ed9e99e6SJeremy L Thompson /** 1588ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` `CeedBasis` data for assembly. 1589ba746a46SJeremy L Thompson 1590ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1591ed9e99e6SJeremy L Thompson 1592ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1593ca94c3ddSJeremy L Thompson @param[out] num_active_bases_in Number of active input bases, or `NULL` 1594ca94c3ddSJeremy L Thompson @param[out] active_bases_in Pointer to hold active input `CeedBasis`, or `NULL` 1595ca94c3ddSJeremy L Thompson @param[out] assembled_bases_in Pointer to hold assembled active input `B` , or `NULL` 1596ca94c3ddSJeremy L Thompson @param[out] num_active_bases_out Number of active output bases, or `NULL` 1597ca94c3ddSJeremy L Thompson @param[out] active_bases_out Pointer to hold active output `CeedBasis`, or `NULL` 1598ca94c3ddSJeremy L Thompson @param[out] assembled_bases_out Pointer to hold assembled active output `B` , or `NULL` 1599ed9e99e6SJeremy L Thompson 1600ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1601ed9e99e6SJeremy L Thompson 1602ed9e99e6SJeremy L Thompson @ref Backend 1603ed9e99e6SJeremy L Thompson **/ 1604506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetBases(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedBasis **active_bases_in, 1605506b1a0cSSebastian Grimberg const CeedScalar ***assembled_bases_in, CeedInt *num_active_bases_out, CeedBasis **active_bases_out, 1606506b1a0cSSebastian Grimberg const CeedScalar ***assembled_bases_out) { 1607ed9e99e6SJeremy L Thompson // Assemble B_in, B_out if needed 1608437c7c90SJeremy L Thompson if (assembled_bases_in && !data->assembled_bases_in[0]) { 1609437c7c90SJeremy L Thompson CeedInt num_qpts; 1610437c7c90SJeremy L Thompson 1611506b1a0cSSebastian Grimberg if (data->active_bases_in[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[0], &num_qpts)); 1612506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_in[0], &num_qpts)); 1613506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < data->num_active_bases_in; b++) { 16141c66c397SJeremy L Thompson bool has_eval_none = false; 1615352a5e7cSSebastian Grimberg CeedInt num_nodes; 1616437c7c90SJeremy L Thompson CeedScalar *B_in = NULL, *identity = NULL; 1617ed9e99e6SJeremy L Thompson 1618506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[b], &num_nodes)); 1619352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_in[b], &B_in)); 1620ed9e99e6SJeremy L Thompson 1621437c7c90SJeremy L Thompson for (CeedInt i = 0; i < data->num_eval_modes_in[b]; i++) { 1622437c7c90SJeremy L Thompson has_eval_none = has_eval_none || (data->eval_modes_in[b][i] == CEED_EVAL_NONE); 1623ed9e99e6SJeremy L Thompson } 1624ed9e99e6SJeremy L Thompson if (has_eval_none) { 1625352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 1626352a5e7cSSebastian Grimberg for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) { 1627352a5e7cSSebastian Grimberg identity[i * num_nodes + i] = 1.0; 1628ed9e99e6SJeremy L Thompson } 1629ed9e99e6SJeremy L Thompson } 1630ed9e99e6SJeremy L Thompson 1631ed9e99e6SJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 1632352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 1633352a5e7cSSebastian Grimberg CeedInt d_in = 0, q_comp_in; 1634352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE; 16351c66c397SJeremy L Thompson 1636437c7c90SJeremy L Thompson for (CeedInt e_in = 0; e_in < data->num_eval_modes_in[b]; e_in++) { 1637437c7c90SJeremy L Thompson const CeedInt qq = data->num_eval_modes_in[b] * q; 1638437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 16391c66c397SJeremy L Thompson 1640506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(data->active_bases_in[b], data->eval_modes_in[b][e_in], identity, &B)); 1641506b1a0cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_in[b], data->eval_modes_in[b][e_in], &q_comp_in)); 1642352a5e7cSSebastian Grimberg if (q_comp_in > 1) { 1643352a5e7cSSebastian Grimberg if (e_in == 0 || data->eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0; 1644352a5e7cSSebastian Grimberg else B = &B[(++d_in) * num_qpts * num_nodes]; 1645352a5e7cSSebastian Grimberg } 1646352a5e7cSSebastian Grimberg eval_mode_in_prev = data->eval_modes_in[b][e_in]; 1647352a5e7cSSebastian Grimberg B_in[(qq + e_in) * num_nodes + n] = B[q * num_nodes + n]; 1648ed9e99e6SJeremy L Thompson } 1649ed9e99e6SJeremy L Thompson } 1650ed9e99e6SJeremy L Thompson } 16517c1dbaffSSebastian Grimberg if (identity) CeedCall(CeedFree(&identity)); 1652437c7c90SJeremy L Thompson data->assembled_bases_in[b] = B_in; 1653437c7c90SJeremy L Thompson } 1654ed9e99e6SJeremy L Thompson } 1655ed9e99e6SJeremy L Thompson 1656437c7c90SJeremy L Thompson if (assembled_bases_out && !data->assembled_bases_out[0]) { 1657437c7c90SJeremy L Thompson CeedInt num_qpts; 1658437c7c90SJeremy L Thompson 1659506b1a0cSSebastian Grimberg if (data->active_bases_out[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[0], &num_qpts)); 1660506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_out[0], &num_qpts)); 1661506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < data->num_active_bases_out; b++) { 1662ed9e99e6SJeremy L Thompson bool has_eval_none = false; 16631c66c397SJeremy L Thompson CeedInt num_nodes; 1664437c7c90SJeremy L Thompson CeedScalar *B_out = NULL, *identity = NULL; 1665ed9e99e6SJeremy L Thompson 1666506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[b], &num_nodes)); 1667352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_out[b], &B_out)); 1668ed9e99e6SJeremy L Thompson 1669437c7c90SJeremy L Thompson for (CeedInt i = 0; i < data->num_eval_modes_out[b]; i++) { 1670437c7c90SJeremy L Thompson has_eval_none = has_eval_none || (data->eval_modes_out[b][i] == CEED_EVAL_NONE); 1671ed9e99e6SJeremy L Thompson } 1672ed9e99e6SJeremy L Thompson if (has_eval_none) { 1673352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 1674352a5e7cSSebastian Grimberg for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) { 1675352a5e7cSSebastian Grimberg identity[i * num_nodes + i] = 1.0; 1676ed9e99e6SJeremy L Thompson } 1677ed9e99e6SJeremy L Thompson } 1678ed9e99e6SJeremy L Thompson 1679ed9e99e6SJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 1680352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 1681352a5e7cSSebastian Grimberg CeedInt d_out = 0, q_comp_out; 1682352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE; 16831c66c397SJeremy L Thompson 1684437c7c90SJeremy L Thompson for (CeedInt e_out = 0; e_out < data->num_eval_modes_out[b]; e_out++) { 1685437c7c90SJeremy L Thompson const CeedInt qq = data->num_eval_modes_out[b] * q; 1686437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 16871c66c397SJeremy L Thompson 1688506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(data->active_bases_out[b], data->eval_modes_out[b][e_out], identity, &B)); 1689506b1a0cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_out[b], data->eval_modes_out[b][e_out], &q_comp_out)); 1690352a5e7cSSebastian Grimberg if (q_comp_out > 1) { 1691352a5e7cSSebastian Grimberg if (e_out == 0 || data->eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0; 1692352a5e7cSSebastian Grimberg else B = &B[(++d_out) * num_qpts * num_nodes]; 1693352a5e7cSSebastian Grimberg } 1694352a5e7cSSebastian Grimberg eval_mode_out_prev = data->eval_modes_out[b][e_out]; 1695352a5e7cSSebastian Grimberg B_out[(qq + e_out) * num_nodes + n] = B[q * num_nodes + n]; 1696ed9e99e6SJeremy L Thompson } 1697ed9e99e6SJeremy L Thompson } 1698ed9e99e6SJeremy L Thompson } 16997c1dbaffSSebastian Grimberg if (identity) CeedCall(CeedFree(&identity)); 1700437c7c90SJeremy L Thompson data->assembled_bases_out[b] = B_out; 1701437c7c90SJeremy L Thompson } 1702ed9e99e6SJeremy L Thompson } 1703ed9e99e6SJeremy L Thompson 1704437c7c90SJeremy L Thompson // Pass out assembled data 1705506b1a0cSSebastian Grimberg if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in; 1706506b1a0cSSebastian Grimberg if (active_bases_in) *active_bases_in = data->active_bases_in; 1707437c7c90SJeremy L Thompson if (assembled_bases_in) *assembled_bases_in = (const CeedScalar **)data->assembled_bases_in; 1708506b1a0cSSebastian Grimberg if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out; 1709506b1a0cSSebastian Grimberg if (active_bases_out) *active_bases_out = data->active_bases_out; 1710437c7c90SJeremy L Thompson if (assembled_bases_out) *assembled_bases_out = (const CeedScalar **)data->assembled_bases_out; 1711437c7c90SJeremy L Thompson return CEED_ERROR_SUCCESS; 1712437c7c90SJeremy L Thompson } 1713437c7c90SJeremy L Thompson 1714437c7c90SJeremy L Thompson /** 1715ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` `CeedBasis` data for assembly. 1716ba746a46SJeremy L Thompson 1717ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1718437c7c90SJeremy L Thompson 1719ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1720ca94c3ddSJeremy L Thompson @param[out] num_active_elem_rstrs_in Number of active input element restrictions, or `NULL` 1721ca94c3ddSJeremy L Thompson @param[out] active_elem_rstrs_in Pointer to hold active input `CeedElemRestriction`, or `NULL` 1722ca94c3ddSJeremy L Thompson @param[out] num_active_elem_rstrs_out Number of active output element restrictions, or `NULL` 1723ca94c3ddSJeremy L Thompson @param[out] active_elem_rstrs_out Pointer to hold active output `CeedElemRestriction`, or `NULL` 1724437c7c90SJeremy L Thompson 1725437c7c90SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1726437c7c90SJeremy L Thompson 1727437c7c90SJeremy L Thompson @ref Backend 1728437c7c90SJeremy L Thompson **/ 1729506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetElemRestrictions(CeedOperatorAssemblyData data, CeedInt *num_active_elem_rstrs_in, 1730506b1a0cSSebastian Grimberg CeedElemRestriction **active_elem_rstrs_in, CeedInt *num_active_elem_rstrs_out, 1731506b1a0cSSebastian Grimberg CeedElemRestriction **active_elem_rstrs_out) { 1732506b1a0cSSebastian Grimberg if (num_active_elem_rstrs_in) *num_active_elem_rstrs_in = data->num_active_bases_in; 1733506b1a0cSSebastian Grimberg if (active_elem_rstrs_in) *active_elem_rstrs_in = data->active_elem_rstrs_in; 1734506b1a0cSSebastian Grimberg if (num_active_elem_rstrs_out) *num_active_elem_rstrs_out = data->num_active_bases_out; 1735506b1a0cSSebastian Grimberg if (active_elem_rstrs_out) *active_elem_rstrs_out = data->active_elem_rstrs_out; 1736ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1737ed9e99e6SJeremy L Thompson } 1738ed9e99e6SJeremy L Thompson 1739ed9e99e6SJeremy L Thompson /** 1740ca94c3ddSJeremy L Thompson @brief Destroy `CeedOperatorAssemblyData` 1741ed9e99e6SJeremy L Thompson 1742ca94c3ddSJeremy L Thompson @param[in,out] data `CeedOperatorAssemblyData` to destroy 1743ed9e99e6SJeremy L Thompson 1744ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1745ed9e99e6SJeremy L Thompson 1746ed9e99e6SJeremy L Thompson @ref Backend 1747ed9e99e6SJeremy L Thompson **/ 1748ed9e99e6SJeremy L Thompson int CeedOperatorAssemblyDataDestroy(CeedOperatorAssemblyData *data) { 1749ad6481ceSJeremy L Thompson if (!*data) { 1750ad6481ceSJeremy L Thompson *data = NULL; 1751ad6481ceSJeremy L Thompson return CEED_ERROR_SUCCESS; 1752ad6481ceSJeremy L Thompson } 17532b730f8bSJeremy L Thompson CeedCall(CeedDestroy(&(*data)->ceed)); 1754506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < (*data)->num_active_bases_in; b++) { 1755506b1a0cSSebastian Grimberg CeedCall(CeedBasisDestroy(&(*data)->active_bases_in[b])); 1756506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_in[b])); 1757437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_in[b])); 1758437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_in[b])); 1759437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_in[b])); 1760506b1a0cSSebastian Grimberg } 1761506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < (*data)->num_active_bases_out; b++) { 1762506b1a0cSSebastian Grimberg CeedCall(CeedBasisDestroy(&(*data)->active_bases_out[b])); 1763506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_out[b])); 1764506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->eval_modes_out[b])); 1765506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->eval_mode_offsets_out[b])); 1766437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_out[b])); 1767437c7c90SJeremy L Thompson } 1768506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_bases_in)); 1769506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_bases_out)); 1770506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_elem_rstrs_in)); 1771506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_elem_rstrs_out)); 1772437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->num_eval_modes_in)); 1773437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->num_eval_modes_out)); 1774437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_in)); 1775437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_out)); 1776437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_in)); 1777437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_out)); 1778437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_in)); 1779437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_out)); 1780ed9e99e6SJeremy L Thompson 17812b730f8bSJeremy L Thompson CeedCall(CeedFree(data)); 1782ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1783ed9e99e6SJeremy L Thompson } 1784ed9e99e6SJeremy L Thompson 17854dd1a9d2SSebastian Grimberg /** 1786ca94c3ddSJeremy L Thompson @brief Retrieve fallback `CeedOperator` with a reference `Ceed` for advanced `CeedOperator` functionality 17874dd1a9d2SSebastian Grimberg 1788ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to retrieve fallback for 1789ca94c3ddSJeremy L Thompson @param[out] op_fallback Fallback `CeedOperator` 17904dd1a9d2SSebastian Grimberg 17914dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 17924dd1a9d2SSebastian Grimberg 17934dd1a9d2SSebastian Grimberg @ref Backend 17944dd1a9d2SSebastian Grimberg **/ 17954dd1a9d2SSebastian Grimberg int CeedOperatorGetFallback(CeedOperator op, CeedOperator *op_fallback) { 17964dd1a9d2SSebastian Grimberg // Create if needed 17974dd1a9d2SSebastian Grimberg if (!op->op_fallback) CeedCall(CeedOperatorCreateFallback(op)); 17984dd1a9d2SSebastian Grimberg if (op->op_fallback) { 17994dd1a9d2SSebastian Grimberg bool is_debug; 18001203703bSJeremy L Thompson Ceed ceed; 18014dd1a9d2SSebastian Grimberg 18024dd1a9d2SSebastian Grimberg CeedCall(CeedOperatorGetCeed(op, &ceed)); 18031203703bSJeremy L Thompson CeedCall(CeedIsDebug(ceed, &is_debug)); 18041203703bSJeremy L Thompson if (is_debug) { 18051203703bSJeremy L Thompson Ceed ceed_fallback; 18061203703bSJeremy L Thompson const char *resource, *resource_fallback; 18071203703bSJeremy L Thompson 18084dd1a9d2SSebastian Grimberg CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback)); 18094dd1a9d2SSebastian Grimberg CeedCall(CeedGetResource(ceed, &resource)); 18104dd1a9d2SSebastian Grimberg CeedCall(CeedGetResource(ceed_fallback, &resource_fallback)); 18114dd1a9d2SSebastian Grimberg 18124dd1a9d2SSebastian Grimberg CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "---------- CeedOperator Fallback ----------\n"); 1813249f8407SJeremy L Thompson CeedDebug(ceed, "Falling back from %s operator at address %p to %s operator at address %p\n", resource, op, resource_fallback, op->op_fallback); 18144dd1a9d2SSebastian Grimberg } 18154dd1a9d2SSebastian Grimberg } 18164dd1a9d2SSebastian Grimberg *op_fallback = op->op_fallback; 18174dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18184dd1a9d2SSebastian Grimberg } 18194dd1a9d2SSebastian Grimberg 18204dd1a9d2SSebastian Grimberg /** 1821ca94c3ddSJeremy L Thompson @brief Get the parent `CeedOperator` for a fallback `CeedOperator` 18224dd1a9d2SSebastian Grimberg 1823ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` context 1824ca94c3ddSJeremy L Thompson @param[out] parent Variable to store parent `CeedOperator` context 18254dd1a9d2SSebastian Grimberg 18264dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 18274dd1a9d2SSebastian Grimberg 18284dd1a9d2SSebastian Grimberg @ref Backend 18294dd1a9d2SSebastian Grimberg **/ 18304dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParent(CeedOperator op, CeedOperator *parent) { 18314dd1a9d2SSebastian Grimberg *parent = op->op_fallback_parent ? op->op_fallback_parent : NULL; 18324dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18334dd1a9d2SSebastian Grimberg } 18344dd1a9d2SSebastian Grimberg 18354dd1a9d2SSebastian Grimberg /** 1836ca94c3ddSJeremy L Thompson @brief Get the `Ceed` context of the parent `CeedOperator` for a fallback `CeedOperator` 18374dd1a9d2SSebastian Grimberg 1838ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` context 1839ca94c3ddSJeremy L Thompson @param[out] parent Variable to store parent `Ceed` context 18404dd1a9d2SSebastian Grimberg 18414dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 18424dd1a9d2SSebastian Grimberg 18434dd1a9d2SSebastian Grimberg @ref Backend 18444dd1a9d2SSebastian Grimberg **/ 18454dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParentCeed(CeedOperator op, Ceed *parent) { 18464dd1a9d2SSebastian Grimberg *parent = op->op_fallback_parent ? op->op_fallback_parent->ceed : op->ceed; 18474dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18484dd1a9d2SSebastian Grimberg } 18494dd1a9d2SSebastian Grimberg 1850480fae85SJeremy L Thompson /// @} 1851480fae85SJeremy L Thompson 1852480fae85SJeremy L Thompson /// ---------------------------------------------------------------------------- 1853eaf62fffSJeremy L Thompson /// CeedOperator Public API 1854eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 1855eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorUser 1856eaf62fffSJeremy L Thompson /// @{ 1857eaf62fffSJeremy L Thompson 1858eaf62fffSJeremy L Thompson /** 1859ca94c3ddSJeremy L Thompson @brief Assemble a linear `CeedQFunction` associated with a `CeedOperator`. 1860eaf62fffSJeremy L Thompson 1861ca94c3ddSJeremy L Thompson This returns a `CeedVector` containing a matrix at each quadrature point providing the action of the `CeedQFunction` associated with the `CeedOperator`. 1862ca94c3ddSJeremy L Thompson The vector `assembled` is of shape `[num_elements, num_input_fields, num_output_fields, num_quad_points]` and contains column-major matrices representing the action of the `CeedQFunction` for a corresponding quadrature point on an element. 1863859c15bbSJames Wright 1864ca94c3ddSJeremy L Thompson Inputs and outputs are in the order provided by the user when adding `CeedOperator` fields. 1865ca94c3ddSJeremy L Thompson For example, a `CeedQFunction` with inputs `u` and `gradu` and outputs `gradv` and `v` , provided in that order, would result in an assembled `CeedQFunction` that consists of `(1 + dim) x (dim + 1)` matrices at each quadrature point acting on the input ` [u, du_0, du_1]` and producing the output `[dv_0, dv_1, v]`. 1866eaf62fffSJeremy L Thompson 1867ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 1868f04ea552SJeremy L Thompson 1869ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1870ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points 1871ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1872ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 1873eaf62fffSJeremy L Thompson 1874eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1875eaf62fffSJeremy L Thompson 1876eaf62fffSJeremy L Thompson @ref User 1877eaf62fffSJeremy L Thompson **/ 18782b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunction(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) { 18792b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 1880eaf62fffSJeremy L Thompson 1881eaf62fffSJeremy L Thompson if (op->LinearAssembleQFunction) { 1882d04bbc78SJeremy L Thompson // Backend version 18832b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleQFunction(op, assembled, rstr, request)); 1884eaf62fffSJeremy L Thompson } else { 1885d04bbc78SJeremy L Thompson // Operator fallback 18861203703bSJeremy L Thompson Ceed ceed; 1887d04bbc78SJeremy L Thompson CeedOperator op_fallback; 1888d04bbc78SJeremy L Thompson 18891203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 18902b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 18916574a04fSJeremy L Thompson if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunction(op_fallback, assembled, rstr, request)); 18921203703bSJeremy L Thompson else return CeedError(ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunction"); 189370a7ffb3SJeremy L Thompson } 1894eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1895eaf62fffSJeremy L Thompson } 189670a7ffb3SJeremy L Thompson 189770a7ffb3SJeremy L Thompson /** 1898ca94c3ddSJeremy L Thompson @brief Assemble `CeedQFunction` and store result internally. 18994385fb7fSSebastian Grimberg 1900ea61e9acSJeremy L Thompson Return copied references of stored data to the caller. 1901ea61e9acSJeremy L Thompson Caller is responsible for ownership and destruction of the copied references. 1902ca94c3ddSJeremy L Thompson See also @ref CeedOperatorLinearAssembleQFunction(). 190370a7ffb3SJeremy L Thompson 1904ca94c3ddSJeremy L Thompson Note: If the value of `assembled` or `rstr` passed to this function are non-`NULL` , then it is assumed that they hold valid pointers. 1905c5f45aeaSJeremy L Thompson These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object. 1906c5f45aeaSJeremy L Thompson 1907ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1908ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points 1909ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1910ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 191170a7ffb3SJeremy L Thompson 191270a7ffb3SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 191370a7ffb3SJeremy L Thompson 191470a7ffb3SJeremy L Thompson @ref User 191570a7ffb3SJeremy L Thompson **/ 19162b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdate(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) { 1917b05f7e9fSJeremy L Thompson int (*LinearAssembleQFunctionUpdate)(CeedOperator, CeedVector, CeedElemRestriction, CeedRequest *) = NULL; 1918b05f7e9fSJeremy L Thompson CeedOperator op_assemble = NULL; 1919bb229da9SJeremy L Thompson CeedOperator op_fallback_parent = NULL; 1920b05f7e9fSJeremy L Thompson 19212b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 192270a7ffb3SJeremy L Thompson 1923b05f7e9fSJeremy L Thompson // Determine if fallback parent or operator has implementation 1924bb229da9SJeremy L Thompson CeedCall(CeedOperatorGetFallbackParent(op, &op_fallback_parent)); 1925bb229da9SJeremy L Thompson if (op_fallback_parent && op_fallback_parent->LinearAssembleQFunctionUpdate) { 1926b05f7e9fSJeremy L Thompson // -- Backend version for op fallback parent is faster, if it exists 1927bb229da9SJeremy L Thompson LinearAssembleQFunctionUpdate = op_fallback_parent->LinearAssembleQFunctionUpdate; 1928bb229da9SJeremy L Thompson op_assemble = op_fallback_parent; 1929b05f7e9fSJeremy L Thompson } else if (op->LinearAssembleQFunctionUpdate) { 1930b05f7e9fSJeremy L Thompson // -- Backend version for op 1931b05f7e9fSJeremy L Thompson LinearAssembleQFunctionUpdate = op->LinearAssembleQFunctionUpdate; 1932b05f7e9fSJeremy L Thompson op_assemble = op; 1933b05f7e9fSJeremy L Thompson } 1934b05f7e9fSJeremy L Thompson 1935b05f7e9fSJeremy L Thompson // Assemble QFunction 1936b05f7e9fSJeremy L Thompson if (LinearAssembleQFunctionUpdate) { 1937b05f7e9fSJeremy L Thompson // Backend or fallback parent version 19387d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 19397d5185d7SSebastian Grimberg bool data_is_setup; 19402efa2d85SJeremy L Thompson CeedVector assembled_vec = NULL; 19412efa2d85SJeremy L Thompson CeedElemRestriction assembled_rstr = NULL; 1942480fae85SJeremy L Thompson 19437d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data)); 19447d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataIsSetup(data, &data_is_setup)); 19457d5185d7SSebastian Grimberg if (data_is_setup) { 1946d04bbc78SJeremy L Thompson bool update_needed; 1947d04bbc78SJeremy L Thompson 19487d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataGetObjects(data, &assembled_vec, &assembled_rstr)); 19497d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataIsUpdateNeeded(data, &update_needed)); 1950b05f7e9fSJeremy L Thompson if (update_needed) CeedCall(LinearAssembleQFunctionUpdate(op_assemble, assembled_vec, assembled_rstr, request)); 195170a7ffb3SJeremy L Thompson } else { 1952b05f7e9fSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunction(op_assemble, &assembled_vec, &assembled_rstr, request)); 19537d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataSetObjects(data, assembled_vec, assembled_rstr)); 195470a7ffb3SJeremy L Thompson } 19557d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataSetUpdateNeeded(data, false)); 19562efa2d85SJeremy L Thompson 1957d04bbc78SJeremy L Thompson // Copy reference from internally held copy 19582b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(assembled_vec, assembled)); 19592b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(assembled_rstr, rstr)); 1960c5f45aeaSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_vec)); 19612b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&assembled_rstr)); 196270a7ffb3SJeremy L Thompson } else { 1963d04bbc78SJeremy L Thompson // Operator fallback 19641203703bSJeremy L Thompson Ceed ceed; 1965d04bbc78SJeremy L Thompson CeedOperator op_fallback; 1966d04bbc78SJeremy L Thompson 19671203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 19682b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 19696574a04fSJeremy L Thompson if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op_fallback, assembled, rstr, request)); 19701203703bSJeremy L Thompson else return CeedError(ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunctionUpdate"); 197170a7ffb3SJeremy L Thompson } 197270a7ffb3SJeremy L Thompson return CEED_ERROR_SUCCESS; 1973eaf62fffSJeremy L Thompson } 1974eaf62fffSJeremy L Thompson 1975eaf62fffSJeremy L Thompson /** 1976ca94c3ddSJeremy L Thompson @brief Assemble the diagonal of a square linear `CeedOperator` 1977eaf62fffSJeremy L Thompson 1978ca94c3ddSJeremy L Thompson This overwrites a `CeedVector` with the diagonal of a linear `CeedOperator`. 1979eaf62fffSJeremy L Thompson 1980ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 1981eaf62fffSJeremy L Thompson 1982ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 1983f04ea552SJeremy L Thompson 1984ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1985ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal 1986ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 1987eaf62fffSJeremy L Thompson 1988eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1989eaf62fffSJeremy L Thompson 1990eaf62fffSJeremy L Thompson @ref User 1991eaf62fffSJeremy L Thompson **/ 19922b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 1993f3d47e36SJeremy L Thompson bool is_composite; 19941c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 19951203703bSJeremy L Thompson Ceed ceed; 19961c66c397SJeremy L Thompson 19971203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 19982b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 1999f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2000eaf62fffSJeremy L Thompson 20012b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 20021203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2003c9366a6bSJeremy L Thompson 2004f3d47e36SJeremy L Thompson // Early exit for empty operator 2005f3d47e36SJeremy L Thompson if (!is_composite) { 2006f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2007f3d47e36SJeremy L Thompson 2008f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2009f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2010f3d47e36SJeremy L Thompson } 2011f3d47e36SJeremy L Thompson 2012eaf62fffSJeremy L Thompson if (op->LinearAssembleDiagonal) { 2013d04bbc78SJeremy L Thompson // Backend version 20142b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleDiagonal(op, assembled, request)); 2015eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2016eaf62fffSJeremy L Thompson } else if (op->LinearAssembleAddDiagonal) { 2017d04bbc78SJeremy L Thompson // Backend version with zeroing first 20182b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 20192b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request)); 2020eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2021eaf62fffSJeremy L Thompson } else { 2022d04bbc78SJeremy L Thompson // Operator fallback 2023d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2024d04bbc78SJeremy L Thompson 20252b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2026d04bbc78SJeremy L Thompson if (op_fallback) { 20272b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleDiagonal(op_fallback, assembled, request)); 2028eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2029eaf62fffSJeremy L Thompson } 2030eaf62fffSJeremy L Thompson } 2031eaf62fffSJeremy L Thompson // Default interface implementation 20322b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 20332b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(op, assembled, request)); 2034eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2035eaf62fffSJeremy L Thompson } 2036eaf62fffSJeremy L Thompson 2037eaf62fffSJeremy L Thompson /** 2038ca94c3ddSJeremy L Thompson @brief Assemble the diagonal of a square linear `CeedOperator`. 2039eaf62fffSJeremy L Thompson 2040ca94c3ddSJeremy L Thompson This sums into a `CeedVector` the diagonal of a linear `CeedOperator`. 2041eaf62fffSJeremy L Thompson 2042ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2043eaf62fffSJeremy L Thompson 2044ea61e9acSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable. 2045f04ea552SJeremy L Thompson 2046ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2047ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal 2048ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2049eaf62fffSJeremy L Thompson 2050eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2051eaf62fffSJeremy L Thompson 2052eaf62fffSJeremy L Thompson @ref User 2053eaf62fffSJeremy L Thompson **/ 20542b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2055f3d47e36SJeremy L Thompson bool is_composite; 20561c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 20571203703bSJeremy L Thompson Ceed ceed; 20581c66c397SJeremy L Thompson 20591203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 20602b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2061f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2062eaf62fffSJeremy L Thompson 20632b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 20641203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2065c9366a6bSJeremy L Thompson 2066f3d47e36SJeremy L Thompson // Early exit for empty operator 2067f3d47e36SJeremy L Thompson if (!is_composite) { 2068f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2069f3d47e36SJeremy L Thompson 2070f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2071f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2072f3d47e36SJeremy L Thompson } 2073f3d47e36SJeremy L Thompson 2074eaf62fffSJeremy L Thompson if (op->LinearAssembleAddDiagonal) { 2075d04bbc78SJeremy L Thompson // Backend version 20762b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request)); 2077eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2078eaf62fffSJeremy L Thompson } else { 2079d04bbc78SJeremy L Thompson // Operator fallback 2080d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2081d04bbc78SJeremy L Thompson 20822b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2083d04bbc78SJeremy L Thompson if (op_fallback) { 20842b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(op_fallback, assembled, request)); 2085eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2086eaf62fffSJeremy L Thompson } 2087eaf62fffSJeremy L Thompson } 2088eaf62fffSJeremy L Thompson // Default interface implementation 2089eaf62fffSJeremy L Thompson if (is_composite) { 20902b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, false, assembled)); 2091eaf62fffSJeremy L Thompson } else { 2092f3bd9308SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal(op, request, false, assembled)); 2093eaf62fffSJeremy L Thompson } 2094d04bbc78SJeremy L Thompson return CEED_ERROR_SUCCESS; 2095eaf62fffSJeremy L Thompson } 2096eaf62fffSJeremy L Thompson 2097eaf62fffSJeremy L Thompson /** 2098ca94c3ddSJeremy L Thompson @brief Fully assemble the point-block diagonal pattern of a linear `CeedOperator`. 209901f0e615SJames Wright 2100ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssemblePointBlockDiagonal(). 210101f0e615SJames Wright 2102ca94c3ddSJeremy L Thompson The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`. 2103ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are unique. 2104ca94c3ddSJeremy L Thompson This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemblePointBlockDiagonal() provides the values in the same ordering. 210501f0e615SJames Wright 210601f0e615SJames Wright This will generally be slow unless your operator is low-order. 210701f0e615SJames Wright 2108ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 210901f0e615SJames Wright 2110ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 211101f0e615SJames Wright @param[out] num_entries Number of entries in coordinate nonzero pattern 211201f0e615SJames Wright @param[out] rows Row number for each entry 211301f0e615SJames Wright @param[out] cols Column number for each entry 211401f0e615SJames Wright 211501f0e615SJames Wright @ref User 211601f0e615SJames Wright **/ 211701f0e615SJames Wright int CeedOperatorLinearAssemblePointBlockDiagonalSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) { 211801f0e615SJames Wright Ceed ceed; 211901f0e615SJames Wright bool is_composite; 212001f0e615SJames Wright CeedInt num_active_components, num_sub_operators; 212101f0e615SJames Wright CeedOperator *sub_operators; 212201f0e615SJames Wright 212301f0e615SJames Wright CeedCall(CeedOperatorGetCeed(op, &ceed)); 212401f0e615SJames Wright CeedCall(CeedOperatorIsComposite(op, &is_composite)); 212501f0e615SJames Wright 212601f0e615SJames Wright CeedSize input_size = 0, output_size = 0; 212701f0e615SJames Wright CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 212801f0e615SJames Wright CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 212901f0e615SJames Wright 213001f0e615SJames Wright if (is_composite) { 213101f0e615SJames Wright CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub_operators)); 213201f0e615SJames Wright CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 213301f0e615SJames Wright } else { 213401f0e615SJames Wright sub_operators = &op; 213501f0e615SJames Wright num_sub_operators = 1; 213601f0e615SJames Wright } 213701f0e615SJames Wright 2138506b1a0cSSebastian Grimberg // Verify operator can be assembled correctly 2139506b1a0cSSebastian Grimberg { 214001f0e615SJames Wright CeedOperatorAssemblyData data; 2141506b1a0cSSebastian Grimberg CeedInt num_active_elem_rstrs, comp_stride; 214201f0e615SJames Wright CeedElemRestriction *active_elem_rstrs; 214301f0e615SJames Wright 214401f0e615SJames Wright // Get initial values to check against 214501f0e615SJames Wright CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[0], &data)); 2146506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL)); 214701f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[0], &comp_stride)); 214801f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[0], &num_active_components)); 214901f0e615SJames Wright 2150506b1a0cSSebastian Grimberg // Verify that all active element restrictions have same component stride and number of components 215101f0e615SJames Wright for (CeedInt k = 0; k < num_sub_operators; k++) { 215201f0e615SJames Wright CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[k], &data)); 2153506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL)); 215401f0e615SJames Wright for (CeedInt i = 0; i < num_active_elem_rstrs; i++) { 2155506b1a0cSSebastian Grimberg CeedInt comp_stride_sub, num_active_components_sub; 2156506b1a0cSSebastian Grimberg 215701f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[i], &comp_stride_sub)); 215801f0e615SJames Wright CeedCheck(comp_stride == comp_stride_sub, ceed, CEED_ERROR_DIMENSION, 215901f0e615SJames Wright "Active element restrictions must have the same component stride: %d vs %d", comp_stride, comp_stride_sub); 216001f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[i], &num_active_components_sub)); 216101f0e615SJames Wright CeedCheck(num_active_components == num_active_components_sub, ceed, CEED_ERROR_INCOMPATIBLE, 21623f08121cSJeremy L Thompson "All suboperators must have the same number of output components." 21633f08121cSJeremy L Thompson " Previous: %" CeedInt_FMT " Current: %" CeedInt_FMT, 21643f08121cSJeremy L Thompson num_active_components, num_active_components_sub); 216501f0e615SJames Wright } 216601f0e615SJames Wright } 216701f0e615SJames Wright } 216801f0e615SJames Wright *num_entries = input_size * num_active_components; 216901f0e615SJames Wright CeedCall(CeedCalloc(*num_entries, rows)); 217001f0e615SJames Wright CeedCall(CeedCalloc(*num_entries, cols)); 217101f0e615SJames Wright 217201f0e615SJames Wright for (CeedInt o = 0; o < num_sub_operators; o++) { 2173506b1a0cSSebastian Grimberg CeedElemRestriction active_elem_rstr, point_block_active_elem_rstr; 217401f0e615SJames Wright CeedInt comp_stride, num_elem, elem_size; 2175506b1a0cSSebastian Grimberg const CeedInt *offsets, *point_block_offsets; 217601f0e615SJames Wright 217701f0e615SJames Wright CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[o], &active_elem_rstr)); 217801f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstr, &comp_stride)); 217901f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumElements(active_elem_rstr, &num_elem)); 218001f0e615SJames Wright CeedCall(CeedElemRestrictionGetElementSize(active_elem_rstr, &elem_size)); 218101f0e615SJames Wright CeedCall(CeedElemRestrictionGetOffsets(active_elem_rstr, CEED_MEM_HOST, &offsets)); 218201f0e615SJames Wright 2183506b1a0cSSebastian Grimberg CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstr, &point_block_active_elem_rstr)); 2184506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOffsets(point_block_active_elem_rstr, CEED_MEM_HOST, &point_block_offsets)); 218501f0e615SJames Wright 218601f0e615SJames Wright for (CeedSize i = 0; i < num_elem * elem_size; i++) { 218701f0e615SJames Wright for (CeedInt c_out = 0; c_out < num_active_components; c_out++) { 218801f0e615SJames Wright for (CeedInt c_in = 0; c_in < num_active_components; c_in++) { 2189506b1a0cSSebastian Grimberg (*rows)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_out * comp_stride; 2190506b1a0cSSebastian Grimberg (*cols)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_in * comp_stride; 219101f0e615SJames Wright } 219201f0e615SJames Wright } 219301f0e615SJames Wright } 219401f0e615SJames Wright 219501f0e615SJames Wright CeedCall(CeedElemRestrictionRestoreOffsets(active_elem_rstr, &offsets)); 2196506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOffsets(point_block_active_elem_rstr, &point_block_offsets)); 2197681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&active_elem_rstr)); 2198506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&point_block_active_elem_rstr)); 219901f0e615SJames Wright } 220001f0e615SJames Wright return CEED_ERROR_SUCCESS; 220101f0e615SJames Wright } 220201f0e615SJames Wright 220301f0e615SJames Wright /** 2204ca94c3ddSJeremy L Thompson @brief Assemble the point block diagonal of a square linear `CeedOperator`. 2205eaf62fffSJeremy L Thompson 2206ca94c3ddSJeremy L Thompson This overwrites a `CeedVector` with the point block diagonal of a linear `CeedOperator`. 2207eaf62fffSJeremy L Thompson 2208ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2209eaf62fffSJeremy L Thompson 2210ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2211f04ea552SJeremy L Thompson 2212ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2213ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedOperator` point block diagonal, provided in row-major form with an `num_comp * num_comp` block at each node. 2214ca94c3ddSJeremy L Thompson The dimensions of this vector are derived from the active vector for the `CeedOperator`. 2215ca94c3ddSJeremy L Thompson The array has shape `[nodes, component out, component in]`. 2216ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2217eaf62fffSJeremy L Thompson 2218eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2219eaf62fffSJeremy L Thompson 2220eaf62fffSJeremy L Thompson @ref User 2221eaf62fffSJeremy L Thompson **/ 22222b730f8bSJeremy L Thompson int CeedOperatorLinearAssemblePointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2223f3d47e36SJeremy L Thompson bool is_composite; 22241c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 22251203703bSJeremy L Thompson Ceed ceed; 22261c66c397SJeremy L Thompson 22271203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 22282b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2229f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2230eaf62fffSJeremy L Thompson 22312b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 22321203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2233c9366a6bSJeremy L Thompson 2234f3d47e36SJeremy L Thompson // Early exit for empty operator 2235f3d47e36SJeremy L Thompson if (!is_composite) { 2236f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2237f3d47e36SJeremy L Thompson 2238f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2239f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2240f3d47e36SJeremy L Thompson } 2241f3d47e36SJeremy L Thompson 2242eaf62fffSJeremy L Thompson if (op->LinearAssemblePointBlockDiagonal) { 2243d04bbc78SJeremy L Thompson // Backend version 22442b730f8bSJeremy L Thompson CeedCall(op->LinearAssemblePointBlockDiagonal(op, assembled, request)); 2245eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2246eaf62fffSJeremy L Thompson } else if (op->LinearAssembleAddPointBlockDiagonal) { 2247d04bbc78SJeremy L Thompson // Backend version with zeroing first 22482b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 22492b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2250eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2251eaf62fffSJeremy L Thompson } else { 2252d04bbc78SJeremy L Thompson // Operator fallback 2253d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2254d04bbc78SJeremy L Thompson 22552b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2256d04bbc78SJeremy L Thompson if (op_fallback) { 22572b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssemblePointBlockDiagonal(op_fallback, assembled, request)); 2258eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2259eaf62fffSJeremy L Thompson } 2260eaf62fffSJeremy L Thompson } 2261eaf62fffSJeremy L Thompson // Default interface implementation 22622b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 22632b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2264eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2265eaf62fffSJeremy L Thompson } 2266eaf62fffSJeremy L Thompson 2267eaf62fffSJeremy L Thompson /** 2268ca94c3ddSJeremy L Thompson @brief Assemble the point block diagonal of a square linear `CeedOperator`. 2269eaf62fffSJeremy L Thompson 2270ca94c3ddSJeremy L Thompson This sums into a `CeedVector` with the point block diagonal of a linear `CeedOperator`. 2271eaf62fffSJeremy L Thompson 2272ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2273eaf62fffSJeremy L Thompson 2274ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2275f04ea552SJeremy L Thompson 2276ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2277ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled CeedOperator point block diagonal, provided in row-major form with an `num_comp * num_comp` block at each node. 2278ca94c3ddSJeremy L Thompson The dimensions of this vector are derived from the active vector for the `CeedOperator`. 2279ca94c3ddSJeremy L Thompson The array has shape `[nodes, component out, component in]`. 2280ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2281eaf62fffSJeremy L Thompson 2282eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2283eaf62fffSJeremy L Thompson 2284eaf62fffSJeremy L Thompson @ref User 2285eaf62fffSJeremy L Thompson **/ 22862b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddPointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2287f3d47e36SJeremy L Thompson bool is_composite; 22881c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 22891203703bSJeremy L Thompson Ceed ceed; 22901c66c397SJeremy L Thompson 22911203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 22922b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2293f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2294eaf62fffSJeremy L Thompson 22952b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 22961203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2297c9366a6bSJeremy L Thompson 2298f3d47e36SJeremy L Thompson // Early exit for empty operator 2299f3d47e36SJeremy L Thompson if (!is_composite) { 2300f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2301f3d47e36SJeremy L Thompson 2302f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2303f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2304f3d47e36SJeremy L Thompson } 2305f3d47e36SJeremy L Thompson 2306eaf62fffSJeremy L Thompson if (op->LinearAssembleAddPointBlockDiagonal) { 2307d04bbc78SJeremy L Thompson // Backend version 23082b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2309eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2310eaf62fffSJeremy L Thompson } else { 2311d04bbc78SJeremy L Thompson // Operator fallback 2312d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2313d04bbc78SJeremy L Thompson 23142b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2315d04bbc78SJeremy L Thompson if (op_fallback) { 23162b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op_fallback, assembled, request)); 2317eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2318eaf62fffSJeremy L Thompson } 2319eaf62fffSJeremy L Thompson } 2320ea61e9acSJeremy L Thompson // Default interface implementation 2321eaf62fffSJeremy L Thompson if (is_composite) { 23222b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, true, assembled)); 2323eaf62fffSJeremy L Thompson } else { 2324f3bd9308SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal(op, request, true, assembled)); 2325eaf62fffSJeremy L Thompson } 2326d04bbc78SJeremy L Thompson return CEED_ERROR_SUCCESS; 2327eaf62fffSJeremy L Thompson } 2328eaf62fffSJeremy L Thompson 2329eaf62fffSJeremy L Thompson /** 2330ca94c3ddSJeremy L Thompson @brief Fully assemble the nonzero pattern of a linear `CeedOperator`. 2331eaf62fffSJeremy L Thompson 2332ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssemble(). 2333eaf62fffSJeremy L Thompson 2334ca94c3ddSJeremy L Thompson The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`. 2335ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are not unique and may repeat. 2336ca94c3ddSJeremy L Thompson This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemble() provides the values in the same ordering. 2337eaf62fffSJeremy L Thompson 2338eaf62fffSJeremy L Thompson This will generally be slow unless your operator is low-order. 2339eaf62fffSJeremy L Thompson 2340ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2341f04ea552SJeremy L Thompson 2342ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 2343eaf62fffSJeremy L Thompson @param[out] num_entries Number of entries in coordinate nonzero pattern 2344eaf62fffSJeremy L Thompson @param[out] rows Row number for each entry 2345eaf62fffSJeremy L Thompson @param[out] cols Column number for each entry 2346eaf62fffSJeremy L Thompson 2347eaf62fffSJeremy L Thompson @ref User 2348eaf62fffSJeremy L Thompson **/ 23492b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) { 23501c66c397SJeremy L Thompson bool is_composite; 23511c66c397SJeremy L Thompson CeedInt num_suboperators, offset = 0; 2352b94338b9SJed Brown CeedSize single_entries; 2353eaf62fffSJeremy L Thompson CeedOperator *sub_operators; 23541c66c397SJeremy L Thompson 23552b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2356f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2357eaf62fffSJeremy L Thompson 2358eaf62fffSJeremy L Thompson if (op->LinearAssembleSymbolic) { 2359d04bbc78SJeremy L Thompson // Backend version 23602b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleSymbolic(op, num_entries, rows, cols)); 2361eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2362eaf62fffSJeremy L Thompson } else { 2363d04bbc78SJeremy L Thompson // Operator fallback 2364d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2365d04bbc78SJeremy L Thompson 23662b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2367d04bbc78SJeremy L Thompson if (op_fallback) { 23682b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleSymbolic(op_fallback, num_entries, rows, cols)); 2369eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2370eaf62fffSJeremy L Thompson } 2371eaf62fffSJeremy L Thompson } 2372eaf62fffSJeremy L Thompson 2373eaf62fffSJeremy L Thompson // Default interface implementation 2374eaf62fffSJeremy L Thompson 2375506b1a0cSSebastian Grimberg // Count entries and allocate rows, cols arrays 2376eaf62fffSJeremy L Thompson *num_entries = 0; 2377eaf62fffSJeremy L Thompson if (is_composite) { 2378c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2379c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 238092ae7e47SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; ++k) { 23812b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2382eaf62fffSJeremy L Thompson *num_entries += single_entries; 2383eaf62fffSJeremy L Thompson } 2384eaf62fffSJeremy L Thompson } else { 23852b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(op, &single_entries)); 2386eaf62fffSJeremy L Thompson *num_entries += single_entries; 2387eaf62fffSJeremy L Thompson } 23882b730f8bSJeremy L Thompson CeedCall(CeedCalloc(*num_entries, rows)); 23892b730f8bSJeremy L Thompson CeedCall(CeedCalloc(*num_entries, cols)); 2390eaf62fffSJeremy L Thompson 2391506b1a0cSSebastian Grimberg // Assemble nonzero locations 2392eaf62fffSJeremy L Thompson if (is_composite) { 2393c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2394c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 239592ae7e47SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; ++k) { 23962b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssembleSymbolic(sub_operators[k], offset, *rows, *cols)); 23972b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2398eaf62fffSJeremy L Thompson offset += single_entries; 2399eaf62fffSJeremy L Thompson } 2400eaf62fffSJeremy L Thompson } else { 24012b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssembleSymbolic(op, offset, *rows, *cols)); 2402eaf62fffSJeremy L Thompson } 2403eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2404eaf62fffSJeremy L Thompson } 2405eaf62fffSJeremy L Thompson 2406eaf62fffSJeremy L Thompson /** 2407eaf62fffSJeremy L Thompson @brief Fully assemble the nonzero entries of a linear operator. 2408eaf62fffSJeremy L Thompson 2409ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssembleSymbolic(). 2410eaf62fffSJeremy L Thompson 2411ca94c3ddSJeremy L Thompson The assembly routines use coordinate format, with `num_entries` tuples of the form `(i, j, value)` which indicate that value should be added to the matrix in entry `(i, j)`. 2412ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are not unique and may repeat. 2413ca94c3ddSJeremy L Thompson This function returns the values of the nonzero entries to be added, their `(i, j)` locations are provided by @ref CeedOperatorLinearAssembleSymbolic(). 2414eaf62fffSJeremy L Thompson 2415eaf62fffSJeremy L Thompson This will generally be slow unless your operator is low-order. 2416eaf62fffSJeremy L Thompson 2417ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2418f04ea552SJeremy L Thompson 2419ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 2420eaf62fffSJeremy L Thompson @param[out] values Values to assemble into matrix 2421eaf62fffSJeremy L Thompson 2422eaf62fffSJeremy L Thompson @ref User 2423eaf62fffSJeremy L Thompson **/ 2424eaf62fffSJeremy L Thompson int CeedOperatorLinearAssemble(CeedOperator op, CeedVector values) { 24251c66c397SJeremy L Thompson bool is_composite; 24261c66c397SJeremy L Thompson CeedInt num_suboperators, offset = 0; 2427b94338b9SJed Brown CeedSize single_entries = 0; 2428eaf62fffSJeremy L Thompson CeedOperator *sub_operators; 24291c66c397SJeremy L Thompson 24302b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2431f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2432f3d47e36SJeremy L Thompson 2433f3d47e36SJeremy L Thompson // Early exit for empty operator 2434f3d47e36SJeremy L Thompson if (!is_composite) { 2435f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2436f3d47e36SJeremy L Thompson 2437f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2438f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2439f3d47e36SJeremy L Thompson } 2440eaf62fffSJeremy L Thompson 2441eaf62fffSJeremy L Thompson if (op->LinearAssemble) { 2442d04bbc78SJeremy L Thompson // Backend version 24432b730f8bSJeremy L Thompson CeedCall(op->LinearAssemble(op, values)); 2444eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2445eaf62fffSJeremy L Thompson } else { 2446d04bbc78SJeremy L Thompson // Operator fallback 2447d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2448d04bbc78SJeremy L Thompson 24492b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2450d04bbc78SJeremy L Thompson if (op_fallback) { 24512b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssemble(op_fallback, values)); 2452eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2453eaf62fffSJeremy L Thompson } 2454eaf62fffSJeremy L Thompson } 2455eaf62fffSJeremy L Thompson 2456eaf62fffSJeremy L Thompson // Default interface implementation 245728ec399dSJeremy L Thompson CeedCall(CeedVectorSetValue(values, 0.0)); 2458eaf62fffSJeremy L Thompson if (is_composite) { 2459c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2460c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 2461cefa2673SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; k++) { 24622b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(sub_operators[k], offset, values)); 24632b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2464eaf62fffSJeremy L Thompson offset += single_entries; 2465eaf62fffSJeremy L Thompson } 2466eaf62fffSJeremy L Thompson } else { 24672b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(op, offset, values)); 2468eaf62fffSJeremy L Thompson } 2469eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2470eaf62fffSJeremy L Thompson } 2471eaf62fffSJeremy L Thompson 2472eaf62fffSJeremy L Thompson /** 2473ca94c3ddSJeremy L Thompson @brief Get the multiplicity of nodes across sub-operators in a composite `CeedOperator`. 247475f0d5a4SJeremy L Thompson 2475ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 247675f0d5a4SJeremy L Thompson 2477ca94c3ddSJeremy L Thompson @param[in] op Composite `CeedOperator` 2478ca94c3ddSJeremy L Thompson @param[in] num_skip_indices Number of sub-operators to skip 2479ca94c3ddSJeremy L Thompson @param[in] skip_indices Array of indices of sub-operators to skip 2480ca94c3ddSJeremy L Thompson @param[out] mult Vector to store multiplicity (of size `l_size` ) 248175f0d5a4SJeremy L Thompson 248275f0d5a4SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 248375f0d5a4SJeremy L Thompson 248475f0d5a4SJeremy L Thompson @ref User 248575f0d5a4SJeremy L Thompson **/ 248675f0d5a4SJeremy L Thompson int CeedCompositeOperatorGetMultiplicity(CeedOperator op, CeedInt num_skip_indices, CeedInt *skip_indices, CeedVector mult) { 248775f0d5a4SJeremy L Thompson Ceed ceed; 2488b275c451SJeremy L Thompson CeedInt num_suboperators; 248975f0d5a4SJeremy L Thompson CeedSize l_vec_len; 249075f0d5a4SJeremy L Thompson CeedScalar *mult_array; 249175f0d5a4SJeremy L Thompson CeedVector ones_l_vec; 24927c1dbaffSSebastian Grimberg CeedElemRestriction elem_rstr, mult_elem_rstr; 2493b275c451SJeremy L Thompson CeedOperator *sub_operators; 249475f0d5a4SJeremy L Thompson 24951c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 24961c66c397SJeremy L Thompson 249775f0d5a4SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 249875f0d5a4SJeremy L Thompson 249975f0d5a4SJeremy L Thompson // Zero mult vector 250075f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(mult, 0.0)); 250175f0d5a4SJeremy L Thompson 250275f0d5a4SJeremy L Thompson // Get suboperators 2503b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2504b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 2505b275c451SJeremy L Thompson if (num_suboperators == 0) return CEED_ERROR_SUCCESS; 250675f0d5a4SJeremy L Thompson 250775f0d5a4SJeremy L Thompson // Work vector 250875f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetLength(mult, &l_vec_len)); 250975f0d5a4SJeremy L Thompson CeedCall(CeedVectorCreate(ceed, l_vec_len, &ones_l_vec)); 251075f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(ones_l_vec, 1.0)); 251175f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetArray(mult, CEED_MEM_HOST, &mult_array)); 251275f0d5a4SJeremy L Thompson 251375f0d5a4SJeremy L Thompson // Compute multiplicity across suboperators 2514b275c451SJeremy L Thompson for (CeedInt i = 0; i < num_suboperators; i++) { 251575f0d5a4SJeremy L Thompson const CeedScalar *sub_mult_array; 251675f0d5a4SJeremy L Thompson CeedVector sub_mult_l_vec, ones_e_vec; 251775f0d5a4SJeremy L Thompson 251875f0d5a4SJeremy L Thompson // -- Check for suboperator to skip 251975f0d5a4SJeremy L Thompson for (CeedInt j = 0; j < num_skip_indices; j++) { 252075f0d5a4SJeremy L Thompson if (skip_indices[j] == i) continue; 252175f0d5a4SJeremy L Thompson } 252275f0d5a4SJeremy L Thompson 252375f0d5a4SJeremy L Thompson // -- Sub operator multiplicity 2524437c7c90SJeremy L Thompson CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[i], &elem_rstr)); 25257c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr, &mult_elem_rstr)); 2526681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr)); 25277c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateVector(mult_elem_rstr, &sub_mult_l_vec, &ones_e_vec)); 252875f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(sub_mult_l_vec, 0.0)); 25297c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_NOTRANSPOSE, ones_l_vec, ones_e_vec, CEED_REQUEST_IMMEDIATE)); 25307c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_TRANSPOSE, ones_e_vec, sub_mult_l_vec, CEED_REQUEST_IMMEDIATE)); 253175f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetArrayRead(sub_mult_l_vec, CEED_MEM_HOST, &sub_mult_array)); 253275f0d5a4SJeremy L Thompson // ---- Flag every node present in the current suboperator 2533c81f2b9dSJames Wright for (CeedSize j = 0; j < l_vec_len; j++) { 253475f0d5a4SJeremy L Thompson if (sub_mult_array[j] > 0.0) mult_array[j] += 1.0; 253575f0d5a4SJeremy L Thompson } 253675f0d5a4SJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(sub_mult_l_vec, &sub_mult_array)); 253775f0d5a4SJeremy L Thompson CeedCall(CeedVectorDestroy(&sub_mult_l_vec)); 253875f0d5a4SJeremy L Thompson CeedCall(CeedVectorDestroy(&ones_e_vec)); 25397c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&mult_elem_rstr)); 254075f0d5a4SJeremy L Thompson } 254175f0d5a4SJeremy L Thompson CeedCall(CeedVectorRestoreArray(mult, &mult_array)); 2542811d0ccfSJeremy L Thompson CeedCall(CeedVectorDestroy(&ones_l_vec)); 254375f0d5a4SJeremy L Thompson return CEED_ERROR_SUCCESS; 254475f0d5a4SJeremy L Thompson } 254575f0d5a4SJeremy L Thompson 254675f0d5a4SJeremy L Thompson /** 2547ca94c3ddSJeremy L Thompson @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator`, creating the prolongation basis from the fine and coarse grid interpolation. 2548eaf62fffSJeremy L Thompson 2549ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2550f04ea552SJeremy L Thompson 2551ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2552ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2553ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2554ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2555ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2556ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2557ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2558eaf62fffSJeremy L Thompson 2559eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2560eaf62fffSJeremy L Thompson 2561eaf62fffSJeremy L Thompson @ref User 2562eaf62fffSJeremy L Thompson **/ 25632b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreate(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 25647758292fSSebastian Grimberg CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) { 25651c66c397SJeremy L Thompson CeedBasis basis_c_to_f = NULL; 25661c66c397SJeremy L Thompson 25672b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 2568eaf62fffSJeremy L Thompson 256983d6adf3SZach Atkins // Build prolongation matrix, if required 25707758292fSSebastian Grimberg if (op_prolong || op_restrict) { 257183d6adf3SZach Atkins CeedBasis basis_fine; 25721c66c397SJeremy L Thompson 25732b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 25742b730f8bSJeremy L Thompson CeedCall(CeedBasisCreateProjection(basis_coarse, basis_fine, &basis_c_to_f)); 2575681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 257683d6adf3SZach Atkins } 2577eaf62fffSJeremy L Thompson 2578f113e5dcSJeremy L Thompson // Core code 25797758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2580eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2581eaf62fffSJeremy L Thompson } 2582eaf62fffSJeremy L Thompson 2583eaf62fffSJeremy L Thompson /** 2584ca94c3ddSJeremy L Thompson @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a tensor basis for the active basis. 2585eaf62fffSJeremy L Thompson 2586ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2587f04ea552SJeremy L Thompson 2588ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2589ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2590ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2591ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2592ca94c3ddSJeremy L Thompson @param[in] interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator` 2593ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2594ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2595ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2596eaf62fffSJeremy L Thompson 2597eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2598eaf62fffSJeremy L Thompson 2599eaf62fffSJeremy L Thompson @ref User 2600eaf62fffSJeremy L Thompson **/ 26012b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateTensorH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 26022b730f8bSJeremy L Thompson const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, 26037758292fSSebastian Grimberg CeedOperator *op_restrict) { 2604eaf62fffSJeremy L Thompson Ceed ceed; 26051c66c397SJeremy L Thompson CeedInt Q_f, Q_c; 26061c66c397SJeremy L Thompson CeedBasis basis_fine, basis_c_to_f = NULL; 26071c66c397SJeremy L Thompson 26081c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 26092b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 2610eaf62fffSJeremy L Thompson 2611eaf62fffSJeremy L Thompson // Check for compatible quadrature spaces 26122b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 26132b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f)); 26142b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c)); 26153f08121cSJeremy L Thompson CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, 26163f08121cSJeremy L Thompson "Bases must have compatible quadrature spaces." 26173f08121cSJeremy L Thompson " Fine grid: %" CeedInt_FMT " points, Coarse grid: %" CeedInt_FMT " points", 26183f08121cSJeremy L Thompson Q_f, Q_c); 2619eaf62fffSJeremy L Thompson 262083d6adf3SZach Atkins // Create coarse to fine basis, if required 26217758292fSSebastian Grimberg if (op_prolong || op_restrict) { 26221c66c397SJeremy L Thompson CeedInt dim, num_comp, num_nodes_c, P_1d_f, P_1d_c; 26231c66c397SJeremy L Thompson CeedScalar *q_ref, *q_weight, *grad; 26241c66c397SJeremy L Thompson 262583d6adf3SZach Atkins // Check if interpolation matrix is provided 26266574a04fSJeremy L Thompson CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE, 26276574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix"); 26282b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis_fine, &dim)); 26292b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp)); 26302b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes1D(basis_fine, &P_1d_f)); 2631681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 26322b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c)); 26332b730f8bSJeremy L Thompson P_1d_c = dim == 1 ? num_nodes_c : dim == 2 ? sqrt(num_nodes_c) : cbrt(num_nodes_c); 26342b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f, &q_ref)); 26352b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f, &q_weight)); 26362b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f * P_1d_c * dim, &grad)); 26372b730f8bSJeremy L Thompson CeedCall(CeedBasisCreateTensorH1(ceed, dim, num_comp, P_1d_c, P_1d_f, interp_c_to_f, grad, q_ref, q_weight, &basis_c_to_f)); 26382b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref)); 26392b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight)); 26402b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad)); 264183d6adf3SZach Atkins } 2642eaf62fffSJeremy L Thompson 2643eaf62fffSJeremy L Thompson // Core code 26447758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2645eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2646eaf62fffSJeremy L Thompson } 2647eaf62fffSJeremy L Thompson 2648eaf62fffSJeremy L Thompson /** 2649ca94c3ddSJeremy L Thompson @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a non-tensor basis for the active vector 2650eaf62fffSJeremy L Thompson 2651ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2652f04ea552SJeremy L Thompson 2653ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2654ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2655ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2656ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2657ca94c3ddSJeremy L Thompson @param[in] interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator` 2658ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2659ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2660ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2661eaf62fffSJeremy L Thompson 2662eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2663eaf62fffSJeremy L Thompson 2664eaf62fffSJeremy L Thompson @ref User 2665eaf62fffSJeremy L Thompson **/ 26662b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 26677758292fSSebastian Grimberg const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, 26687758292fSSebastian Grimberg CeedOperator *op_restrict) { 2669eaf62fffSJeremy L Thompson Ceed ceed; 26701c66c397SJeremy L Thompson CeedInt Q_f, Q_c; 26711c66c397SJeremy L Thompson CeedBasis basis_fine, basis_c_to_f = NULL; 26721c66c397SJeremy L Thompson 26731c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 26742b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 2675eaf62fffSJeremy L Thompson 2676eaf62fffSJeremy L Thompson // Check for compatible quadrature spaces 26772b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 26782b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f)); 26792b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c)); 26806574a04fSJeremy L Thompson CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces"); 2681eaf62fffSJeremy L Thompson 2682eaf62fffSJeremy L Thompson // Coarse to fine basis 26837758292fSSebastian Grimberg if (op_prolong || op_restrict) { 26841c66c397SJeremy L Thompson CeedInt dim, num_comp, num_nodes_c, num_nodes_f; 26851c66c397SJeremy L Thompson CeedScalar *q_ref, *q_weight, *grad; 26861c66c397SJeremy L Thompson CeedElemTopology topo; 26871c66c397SJeremy L Thompson 268883d6adf3SZach Atkins // Check if interpolation matrix is provided 26896574a04fSJeremy L Thompson CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE, 26906574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix"); 26912b730f8bSJeremy L Thompson CeedCall(CeedBasisGetTopology(basis_fine, &topo)); 26922b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis_fine, &dim)); 26932b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp)); 26942b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes(basis_fine, &num_nodes_f)); 2695681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 26962b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c)); 26972b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f * dim, &q_ref)); 26982b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f, &q_weight)); 26992b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f * num_nodes_c * dim, &grad)); 27002b730f8bSJeremy L Thompson CeedCall(CeedBasisCreateH1(ceed, topo, num_comp, num_nodes_c, num_nodes_f, interp_c_to_f, grad, q_ref, q_weight, &basis_c_to_f)); 27012b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref)); 27022b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight)); 27032b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad)); 270483d6adf3SZach Atkins } 2705eaf62fffSJeremy L Thompson 2706eaf62fffSJeremy L Thompson // Core code 27077758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2708eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2709eaf62fffSJeremy L Thompson } 2710eaf62fffSJeremy L Thompson 2711eaf62fffSJeremy L Thompson /** 2712ca94c3ddSJeremy L Thompson @brief Build a FDM based approximate inverse for each element for a `CeedOperator`. 2713eaf62fffSJeremy L Thompson 2714ca94c3ddSJeremy L Thompson This returns a `CeedOperator` and `CeedVector` to apply a Fast Diagonalization Method based approximate inverse. 2715859c15bbSJames Wright This function obtains the simultaneous diagonalization for the 1D mass and Laplacian operators, \f$M = V^T V, K = V^T S V\f$. 2716ca94c3ddSJeremy L Thompson The assembled `CeedQFunction` is used to modify the eigenvalues from simultaneous diagonalization and obtain an approximate inverse of the form \f$V^T \hat S V\f$. 2717ca94c3ddSJeremy L Thompson The `CeedOperator` must be linear and non-composite. 2718ca94c3ddSJeremy L Thompson The associated `CeedQFunction` must therefore also be linear. 2719eaf62fffSJeremy L Thompson 2720ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2721f04ea552SJeremy L Thompson 2722ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to create element inverses 2723ca94c3ddSJeremy L Thompson @param[out] fdm_inv `CeedOperator` to apply the action of a FDM based inverse for each element 2724ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2725eaf62fffSJeremy L Thompson 2726eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2727eaf62fffSJeremy L Thompson 2728480fae85SJeremy L Thompson @ref User 2729eaf62fffSJeremy L Thompson **/ 27302b730f8bSJeremy L Thompson int CeedOperatorCreateFDMElementInverse(CeedOperator op, CeedOperator *fdm_inv, CeedRequest *request) { 27311c66c397SJeremy L Thompson Ceed ceed, ceed_parent; 27321c66c397SJeremy L Thompson bool interp = false, grad = false, is_tensor_basis = true; 27331c66c397SJeremy L Thompson CeedInt num_input_fields, P_1d, Q_1d, num_nodes, num_qpts, dim, num_comp = 1, num_elem = 1; 27341c66c397SJeremy L Thompson CeedScalar *mass, *laplace, *x, *fdm_interp, *lambda, *elem_avg; 27351c66c397SJeremy L Thompson const CeedScalar *interp_1d, *grad_1d, *q_weight_1d; 27361c66c397SJeremy L Thompson CeedVector q_data; 27371c66c397SJeremy L Thompson CeedElemRestriction rstr = NULL, rstr_qd_i; 27381c66c397SJeremy L Thompson CeedBasis basis = NULL, fdm_basis; 27391c66c397SJeremy L Thompson CeedQFunctionContext ctx_fdm; 27401c66c397SJeremy L Thompson CeedQFunctionField *qf_fields; 27411c66c397SJeremy L Thompson CeedQFunction qf, qf_fdm; 27421c66c397SJeremy L Thompson CeedOperatorField *op_fields; 27431c66c397SJeremy L Thompson 27442b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2745eaf62fffSJeremy L Thompson 2746eaf62fffSJeremy L Thompson if (op->CreateFDMElementInverse) { 2747d04bbc78SJeremy L Thompson // Backend version 27482b730f8bSJeremy L Thompson CeedCall(op->CreateFDMElementInverse(op, fdm_inv, request)); 2749eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2750eaf62fffSJeremy L Thompson } else { 2751d04bbc78SJeremy L Thompson // Operator fallback 2752d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2753d04bbc78SJeremy L Thompson 27542b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2755d04bbc78SJeremy L Thompson if (op_fallback) { 27562b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreateFDMElementInverse(op_fallback, fdm_inv, request)); 2757eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2758eaf62fffSJeremy L Thompson } 2759eaf62fffSJeremy L Thompson } 2760eaf62fffSJeremy L Thompson 2761d04bbc78SJeremy L Thompson // Default interface implementation 27622b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 2763bb229da9SJeremy L Thompson CeedCall(CeedOperatorGetFallbackParentCeed(op, &ceed_parent)); 27642b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetQFunction(op, &qf)); 2765eaf62fffSJeremy L Thompson 2766eaf62fffSJeremy L Thompson // Determine active input basis 27672b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, &num_input_fields, &op_fields, NULL, NULL)); 27682b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL)); 2769eaf62fffSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 2770eaf62fffSJeremy L Thompson CeedVector vec; 27711c66c397SJeremy L Thompson 27722b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 2773eaf62fffSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 2774eaf62fffSJeremy L Thompson CeedEvalMode eval_mode; 27751c66c397SJeremy L Thompson 27762b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 2777eaf62fffSJeremy L Thompson interp = interp || eval_mode == CEED_EVAL_INTERP; 2778eaf62fffSJeremy L Thompson grad = grad || eval_mode == CEED_EVAL_GRAD; 2779681d0ea7SJeremy L Thompson if (!basis) CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis)); 2780681d0ea7SJeremy L Thompson if (!rstr) CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &rstr)); 2781eaf62fffSJeremy L Thompson } 2782681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 2783eaf62fffSJeremy L Thompson } 27846574a04fSJeremy L Thompson CeedCheck(basis, ceed, CEED_ERROR_BACKEND, "No active field set"); 27852b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes1D(basis, &P_1d)); 2786352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumNodes(basis, &num_nodes)); 27872b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints1D(basis, &Q_1d)); 27882b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis, &num_qpts)); 27892b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis, &dim)); 27902b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis, &num_comp)); 27912b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem)); 2792eaf62fffSJeremy L Thompson 2793eaf62fffSJeremy L Thompson // Build and diagonalize 1D Mass and Laplacian 27946574a04fSJeremy L Thompson CeedCall(CeedBasisIsTensor(basis, &is_tensor_basis)); 27956574a04fSJeremy L Thompson CeedCheck(is_tensor_basis, ceed, CEED_ERROR_BACKEND, "FDMElementInverse only supported for tensor bases"); 27962b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &mass)); 27972b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &laplace)); 27982b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &x)); 27992b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &fdm_interp)); 28002b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &lambda)); 2801eaf62fffSJeremy L Thompson // -- Build matrices 28022b730f8bSJeremy L Thompson CeedCall(CeedBasisGetInterp1D(basis, &interp_1d)); 28032b730f8bSJeremy L Thompson CeedCall(CeedBasisGetGrad1D(basis, &grad_1d)); 28042b730f8bSJeremy L Thompson CeedCall(CeedBasisGetQWeights(basis, &q_weight_1d)); 28052b730f8bSJeremy L Thompson CeedCall(CeedBuildMassLaplace(interp_1d, grad_1d, q_weight_1d, P_1d, Q_1d, dim, mass, laplace)); 2806eaf62fffSJeremy L Thompson 2807eaf62fffSJeremy L Thompson // -- Diagonalize 28082b730f8bSJeremy L Thompson CeedCall(CeedSimultaneousDiagonalization(ceed, laplace, mass, x, lambda, P_1d)); 28092b730f8bSJeremy L Thompson CeedCall(CeedFree(&mass)); 28102b730f8bSJeremy L Thompson CeedCall(CeedFree(&laplace)); 28112b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 28122b730f8bSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) fdm_interp[i + j * P_1d] = x[j + i * P_1d]; 28132b730f8bSJeremy L Thompson } 28142b730f8bSJeremy L Thompson CeedCall(CeedFree(&x)); 2815eaf62fffSJeremy L Thompson 28161c66c397SJeremy L Thompson { 28171c66c397SJeremy L Thompson CeedInt layout[3], num_modes = (interp ? 1 : 0) + (grad ? dim : 0); 28181c66c397SJeremy L Thompson CeedScalar max_norm = 0; 28191c66c397SJeremy L Thompson const CeedScalar *assembled_array, *q_weight_array; 28201c66c397SJeremy L Thompson CeedVector assembled = NULL, q_weight; 2821c5f45aeaSJeremy L Thompson CeedElemRestriction rstr_qf = NULL; 28221c66c397SJeremy L Thompson 28231c66c397SJeremy L Thompson // Assemble QFunction 28242b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled, &rstr_qf, request)); 282556c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(rstr_qf, layout)); 28262b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_qf)); 28272b730f8bSJeremy L Thompson CeedCall(CeedVectorNorm(assembled, CEED_NORM_MAX, &max_norm)); 2828eaf62fffSJeremy L Thompson 2829eaf62fffSJeremy L Thompson // Calculate element averages 28302b730f8bSJeremy L Thompson CeedCall(CeedVectorCreate(ceed_parent, num_qpts, &q_weight)); 28312b730f8bSJeremy L Thompson CeedCall(CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_weight)); 28322b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayRead(assembled, CEED_MEM_HOST, &assembled_array)); 28332b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayRead(q_weight, CEED_MEM_HOST, &q_weight_array)); 28342b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_elem, &elem_avg)); 2835eaf62fffSJeremy L Thompson const CeedScalar qf_value_bound = max_norm * 100 * CEED_EPSILON; 28361c66c397SJeremy L Thompson 2837eaf62fffSJeremy L Thompson for (CeedInt e = 0; e < num_elem; e++) { 2838eaf62fffSJeremy L Thompson CeedInt count = 0; 28391c66c397SJeremy L Thompson 28402b730f8bSJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 28412b730f8bSJeremy L Thompson for (CeedInt i = 0; i < num_comp * num_comp * num_modes * num_modes; i++) { 28422b730f8bSJeremy L Thompson if (fabs(assembled_array[q * layout[0] + i * layout[1] + e * layout[2]]) > qf_value_bound) { 28432b730f8bSJeremy L Thompson elem_avg[e] += assembled_array[q * layout[0] + i * layout[1] + e * layout[2]] / q_weight_array[q]; 2844eaf62fffSJeremy L Thompson count++; 2845eaf62fffSJeremy L Thompson } 28462b730f8bSJeremy L Thompson } 28472b730f8bSJeremy L Thompson } 2848eaf62fffSJeremy L Thompson if (count) { 2849eaf62fffSJeremy L Thompson elem_avg[e] /= count; 2850eaf62fffSJeremy L Thompson } else { 2851eaf62fffSJeremy L Thompson elem_avg[e] = 1.0; 2852eaf62fffSJeremy L Thompson } 2853eaf62fffSJeremy L Thompson } 28542b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled, &assembled_array)); 28552b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled)); 28562b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(q_weight, &q_weight_array)); 28572b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&q_weight)); 28581c66c397SJeremy L Thompson } 2859eaf62fffSJeremy L Thompson 2860eaf62fffSJeremy L Thompson // Build FDM diagonal 28611c66c397SJeremy L Thompson { 2862eaf62fffSJeremy L Thompson CeedScalar *q_data_array, *fdm_diagonal; 28631c66c397SJeremy L Thompson 2864352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_comp * num_nodes, &fdm_diagonal)); 2865352a5e7cSSebastian Grimberg const CeedScalar fdm_diagonal_bound = num_nodes * CEED_EPSILON; 28662b730f8bSJeremy L Thompson for (CeedInt c = 0; c < num_comp; c++) { 2867352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 2868352a5e7cSSebastian Grimberg if (interp) fdm_diagonal[c * num_nodes + n] = 1.0; 28692b730f8bSJeremy L Thompson if (grad) { 2870eaf62fffSJeremy L Thompson for (CeedInt d = 0; d < dim; d++) { 2871eaf62fffSJeremy L Thompson CeedInt i = (n / CeedIntPow(P_1d, d)) % P_1d; 2872352a5e7cSSebastian Grimberg fdm_diagonal[c * num_nodes + n] += lambda[i]; 2873eaf62fffSJeremy L Thompson } 2874eaf62fffSJeremy L Thompson } 2875352a5e7cSSebastian Grimberg if (fabs(fdm_diagonal[c * num_nodes + n]) < fdm_diagonal_bound) fdm_diagonal[c * num_nodes + n] = fdm_diagonal_bound; 28762b730f8bSJeremy L Thompson } 28772b730f8bSJeremy L Thompson } 2878352a5e7cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed_parent, num_elem * num_comp * num_nodes, &q_data)); 28792b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(q_data, 0.0)); 28802b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayWrite(q_data, CEED_MEM_HOST, &q_data_array)); 28812b730f8bSJeremy L Thompson for (CeedInt e = 0; e < num_elem; e++) { 28822b730f8bSJeremy L Thompson for (CeedInt c = 0; c < num_comp; c++) { 28836c10af5dSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 28841c66c397SJeremy L Thompson q_data_array[(e * num_comp + c) * num_nodes + n] = 1. / (elem_avg[e] * fdm_diagonal[c * num_nodes + n]); 28852b730f8bSJeremy L Thompson } 28862b730f8bSJeremy L Thompson } 28876c10af5dSJeremy L Thompson } 28882b730f8bSJeremy L Thompson CeedCall(CeedFree(&elem_avg)); 28892b730f8bSJeremy L Thompson CeedCall(CeedFree(&fdm_diagonal)); 28902b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(q_data, &q_data_array)); 28911c66c397SJeremy L Thompson } 2892eaf62fffSJeremy L Thompson 2893eaf62fffSJeremy L Thompson // Setup FDM operator 2894eaf62fffSJeremy L Thompson // -- Basis 28951c66c397SJeremy L Thompson { 2896eaf62fffSJeremy L Thompson CeedScalar *grad_dummy, *q_ref_dummy, *q_weight_dummy; 28971c66c397SJeremy L Thompson 28982b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &grad_dummy)); 28992b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &q_ref_dummy)); 29002b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &q_weight_dummy)); 29012b730f8bSJeremy L Thompson CeedCall(CeedBasisCreateTensorH1(ceed_parent, dim, num_comp, P_1d, P_1d, fdm_interp, grad_dummy, q_ref_dummy, q_weight_dummy, &fdm_basis)); 29022b730f8bSJeremy L Thompson CeedCall(CeedFree(&fdm_interp)); 29032b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad_dummy)); 29042b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref_dummy)); 29052b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight_dummy)); 29062b730f8bSJeremy L Thompson CeedCall(CeedFree(&lambda)); 29071c66c397SJeremy L Thompson } 2908eaf62fffSJeremy L Thompson 2909eaf62fffSJeremy L Thompson // -- Restriction 29101c66c397SJeremy L Thompson { 2911352a5e7cSSebastian Grimberg CeedInt strides[3] = {1, num_nodes, num_nodes * num_comp}; 29120a5597ceSJeremy L Thompson CeedCall(CeedElemRestrictionCreateStrided(ceed_parent, num_elem, num_nodes, num_comp, 29130a5597ceSJeremy L Thompson (CeedSize)num_elem * (CeedSize)num_comp * (CeedSize)num_nodes, strides, &rstr_qd_i)); 29141c66c397SJeremy L Thompson } 29151c66c397SJeremy L Thompson 2916eaf62fffSJeremy L Thompson // -- QFunction 29172b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateInteriorByName(ceed_parent, "Scale", &qf_fdm)); 29182b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_fdm, "input", num_comp, CEED_EVAL_INTERP)); 29192b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_fdm, "scale", num_comp, CEED_EVAL_NONE)); 29202b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(qf_fdm, "output", num_comp, CEED_EVAL_INTERP)); 29212b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_fdm, num_comp)); 29221c66c397SJeremy L Thompson 2923eaf62fffSJeremy L Thompson // -- QFunction context 29241c66c397SJeremy L Thompson { 2925eaf62fffSJeremy L Thompson CeedInt *num_comp_data; 29261c66c397SJeremy L Thompson 29272b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_data)); 2928eaf62fffSJeremy L Thompson num_comp_data[0] = num_comp; 29292b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_fdm)); 29302b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_fdm, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_data), num_comp_data)); 29311c66c397SJeremy L Thompson } 29322b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(qf_fdm, ctx_fdm)); 29332b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_fdm)); 29341c66c397SJeremy L Thompson 2935eaf62fffSJeremy L Thompson // -- Operator 29362b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed_parent, qf_fdm, NULL, NULL, fdm_inv)); 29372b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "input", rstr, fdm_basis, CEED_VECTOR_ACTIVE)); 2938356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "scale", rstr_qd_i, CEED_BASIS_NONE, q_data)); 29392b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "output", rstr, fdm_basis, CEED_VECTOR_ACTIVE)); 2940eaf62fffSJeremy L Thompson 2941eaf62fffSJeremy L Thompson // Cleanup 29422b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&q_data)); 2943681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 29442b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_qd_i)); 2945681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 2946681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&fdm_basis)); 29472b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&qf_fdm)); 2948eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2949eaf62fffSJeremy L Thompson } 2950eaf62fffSJeremy L Thompson 2951eaf62fffSJeremy L Thompson /// @} 2952