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); 522b730f8bSJeremy L Thompson CeedCall(CeedCalloc(path_len + name_len + 2, &source_path_with_name)); 539e77b9c8SJeremy L Thompson memcpy(source_path_with_name, qf->source_path, path_len); 549e77b9c8SJeremy L Thompson memcpy(&source_path_with_name[path_len], ":", 1); 559e77b9c8SJeremy L Thompson memcpy(&source_path_with_name[path_len + 1], qf->kernel_name, name_len); 569e77b9c8SJeremy L Thompson } else { 572b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &source_path_with_name)); 589e77b9c8SJeremy L Thompson } 599e77b9c8SJeremy L Thompson 601203703bSJeremy L Thompson { 611203703bSJeremy L Thompson CeedInt vec_length; 621203703bSJeremy L Thompson CeedQFunctionUser f; 631203703bSJeremy L Thompson 641203703bSJeremy L Thompson CeedCall(CeedQFunctionGetVectorLength(qf, &vec_length)); 651203703bSJeremy L Thompson CeedCall(CeedQFunctionGetUserFunction(qf, &f)); 661203703bSJeremy L Thompson CeedCall(CeedQFunctionCreateInterior(fallback_ceed, vec_length, f, source_path_with_name, qf_fallback)); 671203703bSJeremy L Thompson } 689e77b9c8SJeremy L Thompson { 699e77b9c8SJeremy L Thompson CeedQFunctionContext ctx; 709e77b9c8SJeremy L Thompson 712b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetContext(qf, &ctx)); 722b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(*qf_fallback, ctx)); 739e77b9c8SJeremy L Thompson } 741203703bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 751203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 766f8994e9SJeremy L Thompson const char *field_name; 771203703bSJeremy L Thompson CeedInt size; 781203703bSJeremy L Thompson CeedEvalMode eval_mode; 791203703bSJeremy L Thompson 80ab747706SJeremy L Thompson CeedCall(CeedQFunctionFieldGetData(input_fields[i], &field_name, &size, &eval_mode)); 811203703bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(*qf_fallback, field_name, size, eval_mode)); 829e77b9c8SJeremy L Thompson } 831203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 846f8994e9SJeremy L Thompson const char *field_name; 851203703bSJeremy L Thompson CeedInt size; 861203703bSJeremy L Thompson CeedEvalMode eval_mode; 871203703bSJeremy L Thompson 88ab747706SJeremy L Thompson CeedCall(CeedQFunctionFieldGetData(output_fields[i], &field_name, &size, &eval_mode)); 891203703bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(*qf_fallback, field_name, size, eval_mode)); 909e77b9c8SJeremy L Thompson } 912b730f8bSJeremy L Thompson CeedCall(CeedFree(&source_path_with_name)); 929e77b9c8SJeremy L Thompson return CEED_ERROR_SUCCESS; 939e77b9c8SJeremy L Thompson } 949e77b9c8SJeremy L Thompson 959e77b9c8SJeremy L Thompson /** 96ca94c3ddSJeremy L Thompson @brief Duplicate a `CeedOperator` with a reference `Ceed` to fallback for advanced `CeedOperator` functionality 97eaf62fffSJeremy L Thompson 98ca94c3ddSJeremy L Thompson @param[in,out] op `CeedOperator` to create fallback for 99eaf62fffSJeremy L Thompson 100eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 101eaf62fffSJeremy L Thompson 102eaf62fffSJeremy L Thompson @ref Developer 103eaf62fffSJeremy L Thompson **/ 104d04bbc78SJeremy L Thompson static int CeedOperatorCreateFallback(CeedOperator op) { 1051c66c397SJeremy L Thompson bool is_composite; 1061203703bSJeremy L Thompson Ceed ceed, ceed_fallback; 1071c66c397SJeremy L Thompson CeedOperator op_fallback; 108eaf62fffSJeremy L Thompson 109805fe78eSJeremy L Thompson // Check not already created 110805fe78eSJeremy L Thompson if (op->op_fallback) return CEED_ERROR_SUCCESS; 111805fe78eSJeremy L Thompson 112eaf62fffSJeremy L Thompson // Fallback Ceed 1131203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 1141203703bSJeremy L Thompson CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback)); 115d04bbc78SJeremy L Thompson if (!ceed_fallback) return CEED_ERROR_SUCCESS; 116d04bbc78SJeremy L Thompson 1171203703bSJeremy L Thompson CeedDebug256(ceed, 1, "---------- CeedOperator Fallback ----------\n"); 1181203703bSJeremy L Thompson CeedDebug(ceed, "Creating fallback CeedOperator\n"); 119eaf62fffSJeremy L Thompson 120eaf62fffSJeremy L Thompson // Clone Op 121b275c451SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 122b275c451SJeremy L Thompson if (is_composite) { 123b275c451SJeremy L Thompson CeedInt num_suboperators; 124b275c451SJeremy L Thompson CeedOperator *sub_operators; 125b275c451SJeremy L Thompson 1262b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorCreate(ceed_fallback, &op_fallback)); 127b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 128b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 129b275c451SJeremy L Thompson for (CeedInt i = 0; i < num_suboperators; i++) { 130d04bbc78SJeremy L Thompson CeedOperator op_sub_fallback; 131d04bbc78SJeremy L Thompson 132b275c451SJeremy L Thompson CeedCall(CeedOperatorGetFallback(sub_operators[i], &op_sub_fallback)); 1332b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorAddSub(op_fallback, op_sub_fallback)); 134805fe78eSJeremy L Thompson } 135805fe78eSJeremy L Thompson } else { 1361203703bSJeremy L Thompson CeedInt num_input_fields, num_output_fields; 1379e77b9c8SJeremy L Thompson CeedQFunction qf_fallback = NULL, dqf_fallback = NULL, dqfT_fallback = NULL; 1381203703bSJeremy L Thompson CeedOperatorField *input_fields, *output_fields; 1391c66c397SJeremy L Thompson 1402b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->qf, &qf_fallback)); 1412b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqf, &dqf_fallback)); 1422b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateFallback(ceed_fallback, op->dqfT, &dqfT_fallback)); 1432b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed_fallback, qf_fallback, dqf_fallback, dqfT_fallback, &op_fallback)); 1441203703bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 1451203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 1466f8994e9SJeremy L Thompson const char *field_name; 1471203703bSJeremy L Thompson CeedVector vec; 1481203703bSJeremy L Thompson CeedElemRestriction rstr; 1491203703bSJeremy L Thompson CeedBasis basis; 1501203703bSJeremy L Thompson 151ab747706SJeremy L Thompson CeedCall(CeedOperatorFieldGetData(input_fields[i], &field_name, &rstr, &basis, &vec)); 1521203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec)); 153*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 154*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 155*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 156805fe78eSJeremy L Thompson } 1571203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 1586f8994e9SJeremy L Thompson const char *field_name; 1591203703bSJeremy L Thompson CeedVector vec; 1601203703bSJeremy L Thompson CeedElemRestriction rstr; 1611203703bSJeremy L Thompson CeedBasis basis; 1621203703bSJeremy L Thompson 163ab747706SJeremy L Thompson CeedCall(CeedOperatorFieldGetData(output_fields[i], &field_name, &rstr, &basis, &vec)); 1641203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(op_fallback, field_name, rstr, basis, vec)); 165*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 166*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 167*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 168805fe78eSJeremy L Thompson } 1697d5185d7SSebastian Grimberg { 1707d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 1717d5185d7SSebastian Grimberg 1727d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data)); 1737d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataReferenceCopy(data, &op_fallback->qf_assembled)); 1747d5185d7SSebastian Grimberg } 1759e77b9c8SJeremy L Thompson // Cleanup 1762b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&qf_fallback)); 1772b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&dqf_fallback)); 1782b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&dqfT_fallback)); 179805fe78eSJeremy L Thompson } 1802b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetName(op_fallback, op->name)); 1812b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fallback)); 182b05f7e9fSJeremy L Thompson // Note: No ref-counting here so we don't get caught in a reference loop. 183b05f7e9fSJeremy L Thompson // The op holds the only reference to op_fallback and is responsible for deleting itself and op_fallback. 184805fe78eSJeremy L Thompson op->op_fallback = op_fallback; 185b05f7e9fSJeremy L Thompson op_fallback->op_fallback_parent = op; 186eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 187eaf62fffSJeremy L Thompson } 188eaf62fffSJeremy L Thompson 189eaf62fffSJeremy L Thompson /** 190eaf62fffSJeremy L Thompson @brief Core logic for assembling operator diagonal or point block diagonal 191eaf62fffSJeremy L Thompson 1920cd9fdf4SJeremy L Thompson @param[in] op `CeedOperator` to assemble diagonal or point block diagonal 193ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 194bd83916cSSebastian Grimberg @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 195ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 196eaf62fffSJeremy L Thompson 197eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 198eaf62fffSJeremy L Thompson 199eaf62fffSJeremy L Thompson @ref Developer 200eaf62fffSJeremy L Thompson **/ 2010cd9fdf4SJeremy L Thompson static inline int CeedSingleOperatorLinearAssembleAddDiagonal_Mesh(CeedOperator op, CeedRequest *request, const bool is_point_block, 202f3bd9308SJeremy L Thompson CeedVector assembled) { 203eaf62fffSJeremy L Thompson Ceed ceed; 204506b1a0cSSebastian Grimberg bool is_composite; 205506b1a0cSSebastian Grimberg 206506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetCeed(op, &ceed)); 207506b1a0cSSebastian Grimberg CeedCall(CeedOperatorIsComposite(op, &is_composite)); 208506b1a0cSSebastian Grimberg CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 209506b1a0cSSebastian Grimberg 210506b1a0cSSebastian Grimberg // Assemble QFunction 211506b1a0cSSebastian Grimberg CeedInt layout_qf[3]; 212437c7c90SJeremy L Thompson const CeedScalar *assembled_qf_array; 213c5f45aeaSJeremy L Thompson CeedVector assembled_qf = NULL; 214c5f45aeaSJeremy L Thompson CeedElemRestriction assembled_elem_rstr = NULL; 215437c7c90SJeremy L Thompson 216437c7c90SJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, request)); 21756c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf)); 218437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr)); 219437c7c90SJeremy L Thompson CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array)); 220eaf62fffSJeremy L Thompson 221ed9e99e6SJeremy L Thompson // Get assembly data 222437c7c90SJeremy L Thompson const CeedEvalMode **eval_modes_in, **eval_modes_out; 223506b1a0cSSebastian Grimberg CeedInt num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out; 224437c7c90SJeremy L Thompson CeedSize **eval_mode_offsets_in, **eval_mode_offsets_out, num_output_components; 225506b1a0cSSebastian Grimberg CeedBasis *active_bases_in, *active_bases_out; 226506b1a0cSSebastian Grimberg CeedElemRestriction *active_elem_rstrs_in, *active_elem_rstrs_out; 2271c66c397SJeremy L Thompson CeedOperatorAssemblyData data; 2281c66c397SJeremy L Thompson 229437c7c90SJeremy L Thompson CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data)); 230506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, &eval_mode_offsets_in, 231506b1a0cSSebastian Grimberg &num_active_bases_out, &num_eval_modes_out, &eval_modes_out, &eval_mode_offsets_out, 232506b1a0cSSebastian Grimberg &num_output_components)); 233506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, NULL, NULL, &active_bases_out, NULL)); 234506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, NULL, &active_elem_rstrs_in, NULL, &active_elem_rstrs_out)); 235506b1a0cSSebastian Grimberg 236934a29f5SSebastian Grimberg // Loop over all active bases (find matching input/output pairs) 237934a29f5SSebastian Grimberg for (CeedInt b = 0; b < CeedIntMin(num_active_bases_in, num_active_bases_out); b++) { 238934a29f5SSebastian Grimberg CeedInt b_in, b_out, num_elem, num_nodes, num_qpts, num_comp; 2391c66c397SJeremy L Thompson bool has_eval_none = false; 2401c66c397SJeremy L Thompson CeedScalar *elem_diag_array, *identity = NULL; 2411c66c397SJeremy L Thompson CeedVector elem_diag; 2427c1dbaffSSebastian Grimberg CeedElemRestriction diag_elem_rstr; 2431c66c397SJeremy L Thompson 244934a29f5SSebastian Grimberg if (num_active_bases_in <= num_active_bases_out) { 245934a29f5SSebastian Grimberg b_in = b; 246934a29f5SSebastian Grimberg for (b_out = 0; b_out < num_active_bases_out; b_out++) { 247934a29f5SSebastian Grimberg if (active_bases_in[b_in] == active_bases_out[b_out]) { 248934a29f5SSebastian Grimberg break; 249934a29f5SSebastian Grimberg } 250934a29f5SSebastian Grimberg } 251934a29f5SSebastian Grimberg if (b_out == num_active_bases_out) { 252934a29f5SSebastian Grimberg continue; 253934a29f5SSebastian Grimberg } // No matching output basis found 254934a29f5SSebastian Grimberg } else { 255934a29f5SSebastian Grimberg b_out = b; 256934a29f5SSebastian Grimberg for (b_in = 0; b_in < num_active_bases_in; b_in++) { 257934a29f5SSebastian Grimberg if (active_bases_in[b_in] == active_bases_out[b_out]) { 258934a29f5SSebastian Grimberg break; 259934a29f5SSebastian Grimberg } 260934a29f5SSebastian Grimberg } 261934a29f5SSebastian Grimberg if (b_in == num_active_bases_in) { 262934a29f5SSebastian Grimberg continue; 263934a29f5SSebastian Grimberg } // No matching output basis found 264934a29f5SSebastian Grimberg } 265934a29f5SSebastian Grimberg CeedCheck(active_elem_rstrs_in[b_in] == active_elem_rstrs_out[b_out], ceed, CEED_ERROR_UNSUPPORTED, 266506b1a0cSSebastian Grimberg "Cannot assemble operator diagonal with different input and output active element restrictions"); 267506b1a0cSSebastian Grimberg 2681c66c397SJeremy L Thompson // Assemble point block diagonal restriction, if needed 269bd83916cSSebastian Grimberg if (is_point_block) { 270934a29f5SSebastian Grimberg CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstrs_in[b_in], &diag_elem_rstr)); 2717c1dbaffSSebastian Grimberg } else { 272934a29f5SSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnsignedCopy(active_elem_rstrs_in[b_in], &diag_elem_rstr)); 273eaf62fffSJeremy L Thompson } 274eaf62fffSJeremy L Thompson 275eaf62fffSJeremy L Thompson // Create diagonal vector 276437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionCreateVector(diag_elem_rstr, NULL, &elem_diag)); 277eaf62fffSJeremy L Thompson 278eaf62fffSJeremy L Thompson // Assemble element operator diagonals 2792b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(elem_diag, 0.0)); 2802b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArray(elem_diag, CEED_MEM_HOST, &elem_diag_array)); 281437c7c90SJeremy L Thompson CeedCall(CeedElemRestrictionGetNumElements(diag_elem_rstr, &num_elem)); 282934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumNodes(active_bases_in[b_in], &num_nodes)); 283934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumComponents(active_bases_in[b_in], &num_comp)); 284934a29f5SSebastian Grimberg if (active_bases_in[b_in] == CEED_BASIS_NONE) num_qpts = num_nodes; 285934a29f5SSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(active_bases_in[b_in], &num_qpts)); 286ed9e99e6SJeremy L Thompson 287352a5e7cSSebastian Grimberg // Construct identity matrix for basis if required 288934a29f5SSebastian Grimberg for (CeedInt i = 0; i < num_eval_modes_in[b_in]; i++) { 289934a29f5SSebastian Grimberg has_eval_none = has_eval_none || (eval_modes_in[b_in][i] == CEED_EVAL_NONE); 290ed9e99e6SJeremy L Thompson } 291934a29f5SSebastian Grimberg for (CeedInt i = 0; i < num_eval_modes_out[b_out]; i++) { 292934a29f5SSebastian Grimberg has_eval_none = has_eval_none || (eval_modes_out[b_out][i] == CEED_EVAL_NONE); 293ed9e99e6SJeremy L Thompson } 294ed9e99e6SJeremy L Thompson if (has_eval_none) { 2952b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 2962b730f8bSJeremy L Thompson for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) identity[i * num_nodes + i] = 1.0; 297eaf62fffSJeremy L Thompson } 298352a5e7cSSebastian Grimberg 299eaf62fffSJeremy L Thompson // Compute the diagonal of B^T D B 300eaf62fffSJeremy L Thompson // Each element 301b94338b9SJed Brown for (CeedSize e = 0; e < num_elem; e++) { 302eaf62fffSJeremy L Thompson // Each basis eval mode pair 303352a5e7cSSebastian Grimberg CeedInt d_out = 0, q_comp_out; 304352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE; 3051c66c397SJeremy L Thompson 306934a29f5SSebastian Grimberg for (CeedInt e_out = 0; e_out < num_eval_modes_out[b_out]; e_out++) { 3071c66c397SJeremy L Thompson CeedInt d_in = 0, q_comp_in; 308437c7c90SJeremy L Thompson const CeedScalar *B_t = NULL; 3091c66c397SJeremy L Thompson CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE; 3101c66c397SJeremy L Thompson 311934a29f5SSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(active_bases_out[b_out], eval_modes_out[b_out][e_out], identity, &B_t)); 312934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_out[b_out], eval_modes_out[b_out][e_out], &q_comp_out)); 313352a5e7cSSebastian Grimberg if (q_comp_out > 1) { 314934a29f5SSebastian Grimberg if (e_out == 0 || eval_modes_out[b_out][e_out] != eval_mode_out_prev) d_out = 0; 315352a5e7cSSebastian Grimberg else B_t = &B_t[(++d_out) * num_qpts * num_nodes]; 316352a5e7cSSebastian Grimberg } 317934a29f5SSebastian Grimberg eval_mode_out_prev = eval_modes_out[b_out][e_out]; 318352a5e7cSSebastian Grimberg 319934a29f5SSebastian Grimberg for (CeedInt e_in = 0; e_in < num_eval_modes_in[b_in]; e_in++) { 320437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 3211c66c397SJeremy L Thompson 322934a29f5SSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(active_bases_in[b_in], eval_modes_in[b_in][e_in], identity, &B)); 323934a29f5SSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(active_bases_in[b_in], eval_modes_in[b_in][e_in], &q_comp_in)); 324352a5e7cSSebastian Grimberg if (q_comp_in > 1) { 325934a29f5SSebastian Grimberg if (e_in == 0 || eval_modes_in[b_in][e_in] != eval_mode_in_prev) d_in = 0; 326352a5e7cSSebastian Grimberg else B = &B[(++d_in) * num_qpts * num_nodes]; 327352a5e7cSSebastian Grimberg } 328934a29f5SSebastian Grimberg eval_mode_in_prev = eval_modes_in[b_in][e_in]; 329352a5e7cSSebastian Grimberg 330eaf62fffSJeremy L Thompson // Each component 331506b1a0cSSebastian Grimberg for (CeedInt c_out = 0; c_out < num_comp; c_out++) { 332437c7c90SJeremy L Thompson // Each qpt/node pair 3332b730f8bSJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 334bd83916cSSebastian Grimberg if (is_point_block) { 335eaf62fffSJeremy L Thompson // Point Block Diagonal 336506b1a0cSSebastian Grimberg for (CeedInt c_in = 0; c_in < num_comp; c_in++) { 337934a29f5SSebastian Grimberg const CeedSize c_offset = 338934a29f5SSebastian Grimberg (eval_mode_offsets_in[b_in][e_in] + c_in) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out; 339506b1a0cSSebastian Grimberg const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]]; 3401c66c397SJeremy L Thompson 3412b730f8bSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 342506b1a0cSSebastian Grimberg elem_diag_array[((e * num_comp + c_out) * num_comp + c_in) * num_nodes + n] += 343437c7c90SJeremy L Thompson B_t[q * num_nodes + n] * qf_value * B[q * num_nodes + n]; 344eaf62fffSJeremy L Thompson } 3452b730f8bSJeremy L Thompson } 346eaf62fffSJeremy L Thompson } else { 347eaf62fffSJeremy L Thompson // Diagonal Only 348934a29f5SSebastian Grimberg const CeedInt c_offset = 349934a29f5SSebastian Grimberg (eval_mode_offsets_in[b_in][e_in] + c_out) * num_output_components + eval_mode_offsets_out[b_out][e_out] + c_out; 350506b1a0cSSebastian Grimberg const CeedScalar qf_value = assembled_qf_array[q * layout_qf[0] + c_offset * layout_qf[1] + e * layout_qf[2]]; 3511c66c397SJeremy L Thompson 3522b730f8bSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 353506b1a0cSSebastian 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]; 354eaf62fffSJeremy L Thompson } 355eaf62fffSJeremy L Thompson } 356eaf62fffSJeremy L Thompson } 357eaf62fffSJeremy L Thompson } 3582b730f8bSJeremy L Thompson } 3592b730f8bSJeremy L Thompson } 3602b730f8bSJeremy L Thompson } 3612b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(elem_diag, &elem_diag_array)); 362eaf62fffSJeremy L Thompson 363eaf62fffSJeremy L Thompson // Assemble local operator diagonal 3647c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(diag_elem_rstr, CEED_TRANSPOSE, elem_diag, assembled, request)); 365eaf62fffSJeremy L Thompson 366eaf62fffSJeremy L Thompson // Cleanup 3677c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&diag_elem_rstr)); 3682b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&elem_diag)); 3692b730f8bSJeremy L Thompson CeedCall(CeedFree(&identity)); 370437c7c90SJeremy L Thompson } 371437c7c90SJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array)); 372437c7c90SJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_qf)); 373eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 374eaf62fffSJeremy L Thompson } 375eaf62fffSJeremy L Thompson 376eaf62fffSJeremy L Thompson /** 3770cd9fdf4SJeremy L Thompson @brief Core logic for assembling operator diagonal or point block diagonal 3780cd9fdf4SJeremy L Thompson 3790cd9fdf4SJeremy L Thompson @param[in] op `CeedOperator` to assemble diagonal or point block diagonal 3800cd9fdf4SJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 3810cd9fdf4SJeremy L Thompson @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 3820cd9fdf4SJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 3830cd9fdf4SJeremy L Thompson 3840cd9fdf4SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 3850cd9fdf4SJeremy L Thompson 3860cd9fdf4SJeremy L Thompson @ref Developer 3870cd9fdf4SJeremy L Thompson **/ 3880cd9fdf4SJeremy L Thompson static inline int CeedSingleOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_point_block, 3890cd9fdf4SJeremy L Thompson CeedVector assembled) { 3900cd9fdf4SJeremy L Thompson Ceed ceed; 3910cd9fdf4SJeremy L Thompson bool is_at_points; 3920cd9fdf4SJeremy L Thompson 3930cd9fdf4SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 3940cd9fdf4SJeremy L Thompson CeedCall(CeedOperatorIsAtPoints(op, &is_at_points)); 39542461424SJeremy L Thompson CeedCheck(!is_at_points, ceed, CEED_ERROR_UNSUPPORTED, "AtPoints operator not supported"); 3960cd9fdf4SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal_Mesh(op, request, is_point_block, assembled)); 3970cd9fdf4SJeremy L Thompson return CEED_ERROR_SUCCESS; 3980cd9fdf4SJeremy L Thompson } 3990cd9fdf4SJeremy L Thompson 4000cd9fdf4SJeremy L Thompson /** 401eaf62fffSJeremy L Thompson @brief Core logic for assembling composite operator diagonal 402eaf62fffSJeremy L Thompson 403ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble point block diagonal 404ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 405bd83916cSSebastian Grimberg @param[in] is_point_block Boolean flag to assemble diagonal or point block diagonal 406ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled diagonal 407eaf62fffSJeremy L Thompson 408eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 409eaf62fffSJeremy L Thompson 410eaf62fffSJeremy L Thompson @ref Developer 411eaf62fffSJeremy L Thompson **/ 412bd83916cSSebastian Grimberg static inline int CeedCompositeOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedRequest *request, const bool is_point_block, 413eaf62fffSJeremy L Thompson CeedVector assembled) { 414eaf62fffSJeremy L Thompson CeedInt num_sub; 415eaf62fffSJeremy L Thompson CeedOperator *suboperators; 4161c66c397SJeremy L Thompson 417c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub)); 418c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &suboperators)); 419eaf62fffSJeremy L Thompson for (CeedInt i = 0; i < num_sub; i++) { 420bd83916cSSebastian Grimberg if (is_point_block) { 4212b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(suboperators[i], assembled, request)); 4226aa95790SJeremy L Thompson } else { 4232b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(suboperators[i], assembled, request)); 4246aa95790SJeremy L Thompson } 425eaf62fffSJeremy L Thompson } 426eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 427eaf62fffSJeremy L Thompson } 428eaf62fffSJeremy L Thompson 429eaf62fffSJeremy L Thompson /** 430ca94c3ddSJeremy L Thompson @brief Build nonzero pattern for non-composite CeedOperator`. 431eaf62fffSJeremy L Thompson 432ca94c3ddSJeremy L Thompson Users should generally use @ref CeedOperatorLinearAssembleSymbolic(). 433eaf62fffSJeremy L Thompson 434ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble nonzero pattern 435eaf62fffSJeremy L Thompson @param[in] offset Offset for number of entries 436eaf62fffSJeremy L Thompson @param[out] rows Row number for each entry 437eaf62fffSJeremy L Thompson @param[out] cols Column number for each entry 438eaf62fffSJeremy L Thompson 439eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 440eaf62fffSJeremy L Thompson 441eaf62fffSJeremy L Thompson @ref Developer 442eaf62fffSJeremy L Thompson **/ 4432b730f8bSJeremy L Thompson static int CeedSingleOperatorAssembleSymbolic(CeedOperator op, CeedInt offset, CeedInt *rows, CeedInt *cols) { 444f3d47e36SJeremy L Thompson Ceed ceed; 445f3d47e36SJeremy L Thompson bool is_composite; 44681670346SSebastian Grimberg CeedSize num_nodes_in, num_nodes_out, local_num_entries, count = 0; 447506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, layout_er_in[3]; 44881670346SSebastian Grimberg CeedInt num_elem_out, elem_size_out, num_comp_out, layout_er_out[3]; 4491c66c397SJeremy L Thompson CeedScalar *array; 450506b1a0cSSebastian Grimberg const CeedScalar *elem_dof_a_in, *elem_dof_a_out; 451506b1a0cSSebastian Grimberg CeedVector index_vec_in, index_vec_out, elem_dof_in, elem_dof_out; 452506b1a0cSSebastian Grimberg CeedElemRestriction elem_rstr_in, elem_rstr_out, index_elem_rstr_in, index_elem_rstr_out; 4531c66c397SJeremy L Thompson 454f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 455f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 4566574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 457eaf62fffSJeremy L Thompson 458506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveVectorLengths(op, &num_nodes_in, &num_nodes_out)); 459506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out)); 460506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in)); 461506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in)); 462506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in)); 46356c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(elem_rstr_in, layout_er_in)); 464eaf62fffSJeremy L Thompson 465506b1a0cSSebastian Grimberg // Determine elem_dof relation for input 466506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_nodes_in, &index_vec_in)); 467506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayWrite(index_vec_in, CEED_MEM_HOST, &array)); 468c81f2b9dSJames Wright for (CeedSize i = 0; i < num_nodes_in; i++) array[i] = i; 469506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArray(index_vec_in, &array)); 470506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_elem_in * elem_size_in * num_comp_in, &elem_dof_in)); 471506b1a0cSSebastian Grimberg CeedCall(CeedVectorSetValue(elem_dof_in, 0.0)); 472506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_in, &index_elem_rstr_in)); 473506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionApply(index_elem_rstr_in, CEED_NOTRANSPOSE, index_vec_in, elem_dof_in, CEED_REQUEST_IMMEDIATE)); 474506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(elem_dof_in, CEED_MEM_HOST, &elem_dof_a_in)); 475506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&index_vec_in)); 476506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_in)); 477506b1a0cSSebastian Grimberg 478506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 479506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out)); 480506b1a0cSSebastian Grimberg CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 4813f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 4823f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 4833f08121cSJeremy L Thompson num_elem_in, num_elem_out); 484506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out)); 485506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out)); 48656c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(elem_rstr_out, layout_er_out)); 487506b1a0cSSebastian Grimberg 488506b1a0cSSebastian Grimberg // Determine elem_dof relation for output 489506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_nodes_out, &index_vec_out)); 490506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayWrite(index_vec_out, CEED_MEM_HOST, &array)); 491c81f2b9dSJames Wright for (CeedSize i = 0; i < num_nodes_out; i++) array[i] = i; 492506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArray(index_vec_out, &array)); 493506b1a0cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed, num_elem_out * elem_size_out * num_comp_out, &elem_dof_out)); 494506b1a0cSSebastian Grimberg CeedCall(CeedVectorSetValue(elem_dof_out, 0.0)); 495506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr_out, &index_elem_rstr_out)); 496506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionApply(index_elem_rstr_out, CEED_NOTRANSPOSE, index_vec_out, elem_dof_out, CEED_REQUEST_IMMEDIATE)); 497506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(elem_dof_out, CEED_MEM_HOST, &elem_dof_a_out)); 498506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&index_vec_out)); 499506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&index_elem_rstr_out)); 500506b1a0cSSebastian Grimberg } else { 501506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 502506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 503506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 504506b1a0cSSebastian Grimberg layout_er_out[0] = layout_er_in[0]; 505506b1a0cSSebastian Grimberg layout_er_out[1] = layout_er_in[1]; 506506b1a0cSSebastian Grimberg layout_er_out[2] = layout_er_in[2]; 507506b1a0cSSebastian Grimberg elem_dof_a_out = elem_dof_a_in; 508506b1a0cSSebastian Grimberg } 509c81f2b9dSJames Wright local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in; 510eaf62fffSJeremy L Thompson 511eaf62fffSJeremy L Thompson // Determine i, j locations for element matrices 512506b1a0cSSebastian Grimberg for (CeedInt e = 0; e < num_elem_in; e++) { 513506b1a0cSSebastian Grimberg for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) { 514506b1a0cSSebastian Grimberg for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) { 515506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 516506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 517506b1a0cSSebastian Grimberg const CeedInt elem_dof_index_row = i * layout_er_out[0] + comp_out * layout_er_out[1] + e * layout_er_out[2]; 518506b1a0cSSebastian Grimberg const CeedInt elem_dof_index_col = j * layout_er_in[0] + comp_in * layout_er_in[1] + e * layout_er_in[2]; 519506b1a0cSSebastian Grimberg const CeedInt row = elem_dof_a_out[elem_dof_index_row]; 520506b1a0cSSebastian Grimberg const CeedInt col = elem_dof_a_in[elem_dof_index_col]; 521eaf62fffSJeremy L Thompson 522eaf62fffSJeremy L Thompson rows[offset + count] = row; 523eaf62fffSJeremy L Thompson cols[offset + count] = col; 524eaf62fffSJeremy L Thompson count++; 525eaf62fffSJeremy L Thompson } 526eaf62fffSJeremy L Thompson } 527eaf62fffSJeremy L Thompson } 528eaf62fffSJeremy L Thompson } 529eaf62fffSJeremy L Thompson } 5306574a04fSJeremy L Thompson CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing assembled entries"); 531506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArrayRead(elem_dof_in, &elem_dof_a_in)); 532506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&elem_dof_in)); 533506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 534506b1a0cSSebastian Grimberg CeedCall(CeedVectorRestoreArrayRead(elem_dof_out, &elem_dof_a_out)); 535506b1a0cSSebastian Grimberg CeedCall(CeedVectorDestroy(&elem_dof_out)); 536506b1a0cSSebastian Grimberg } 537*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 538*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 539eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 540eaf62fffSJeremy L Thompson } 541eaf62fffSJeremy L Thompson 542eaf62fffSJeremy L Thompson /** 543ca94c3ddSJeremy L Thompson @brief Assemble nonzero entries for non-composite `CeedOperator`. 544eaf62fffSJeremy L Thompson 545ca94c3ddSJeremy L Thompson Users should generally use @ref CeedOperatorLinearAssemble(). 546eaf62fffSJeremy L Thompson 547ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 548ea61e9acSJeremy L Thompson @param[in] offset Offset for number of entries 549eaf62fffSJeremy L Thompson @param[out] values Values to assemble into matrix 550eaf62fffSJeremy L Thompson 551eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 552eaf62fffSJeremy L Thompson 553eaf62fffSJeremy L Thompson @ref Developer 554eaf62fffSJeremy L Thompson **/ 5552b730f8bSJeremy L Thompson static int CeedSingleOperatorAssemble(CeedOperator op, CeedInt offset, CeedVector values) { 556f3d47e36SJeremy L Thompson Ceed ceed; 557f3d47e36SJeremy L Thompson bool is_composite; 5581c66c397SJeremy L Thompson 559f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 560f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 5616574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 562f3d47e36SJeremy L Thompson 563f3d47e36SJeremy L Thompson // Early exit for empty operator 564f3d47e36SJeremy L Thompson { 565f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 566f3d47e36SJeremy L Thompson 567f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 568f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 569f3d47e36SJeremy L Thompson } 570eaf62fffSJeremy L Thompson 571cefa2673SJeremy L Thompson if (op->LinearAssembleSingle) { 572cefa2673SJeremy L Thompson // Backend version 5732b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleSingle(op, offset, values)); 574cefa2673SJeremy L Thompson return CEED_ERROR_SUCCESS; 575cefa2673SJeremy L Thompson } else { 576cefa2673SJeremy L Thompson // Operator fallback 577cefa2673SJeremy L Thompson CeedOperator op_fallback; 578cefa2673SJeremy L Thompson 5792b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 580cefa2673SJeremy L Thompson if (op_fallback) { 5812b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(op_fallback, offset, values)); 582cefa2673SJeremy L Thompson return CEED_ERROR_SUCCESS; 583cefa2673SJeremy L Thompson } 584cefa2673SJeremy L Thompson } 585cefa2673SJeremy L Thompson 586eaf62fffSJeremy L Thompson // Assemble QFunction 587506b1a0cSSebastian Grimberg CeedInt layout_qf[3]; 5881c66c397SJeremy L Thompson const CeedScalar *assembled_qf_array; 589c5f45aeaSJeremy L Thompson CeedVector assembled_qf = NULL; 590506b1a0cSSebastian Grimberg CeedElemRestriction assembled_elem_rstr = NULL; 591eaf62fffSJeremy L Thompson 592506b1a0cSSebastian Grimberg CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled_qf, &assembled_elem_rstr, CEED_REQUEST_IMMEDIATE)); 59356c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(assembled_elem_rstr, layout_qf)); 594506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&assembled_elem_rstr)); 595506b1a0cSSebastian Grimberg CeedCall(CeedVectorGetArrayRead(assembled_qf, CEED_MEM_HOST, &assembled_qf_array)); 596eaf62fffSJeremy L Thompson 597ed9e99e6SJeremy L Thompson // Get assembly data 598506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, num_qpts_in; 59981670346SSebastian Grimberg CeedInt num_elem_out, elem_size_out, num_comp_out, num_qpts_out; 60081670346SSebastian Grimberg CeedSize local_num_entries, count = 0; 601506b1a0cSSebastian Grimberg const CeedEvalMode **eval_modes_in, **eval_modes_out; 602506b1a0cSSebastian Grimberg CeedInt num_active_bases_in, *num_eval_modes_in, num_active_bases_out, *num_eval_modes_out; 603506b1a0cSSebastian Grimberg CeedBasis *active_bases_in, *active_bases_out, basis_in, basis_out; 604506b1a0cSSebastian Grimberg const CeedScalar **B_mats_in, **B_mats_out, *B_mat_in, *B_mat_out; 605506b1a0cSSebastian Grimberg CeedElemRestriction elem_rstr_in, elem_rstr_out; 606506b1a0cSSebastian Grimberg CeedRestrictionType elem_rstr_type_in, elem_rstr_type_out; 607506b1a0cSSebastian Grimberg const bool *elem_rstr_orients_in = NULL, *elem_rstr_orients_out = NULL; 608506b1a0cSSebastian Grimberg const CeedInt8 *elem_rstr_curl_orients_in = NULL, *elem_rstr_curl_orients_out = NULL; 609506b1a0cSSebastian Grimberg CeedOperatorAssemblyData data; 610eaf62fffSJeremy L Thompson 611506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetOperatorAssemblyData(op, &data)); 612506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetEvalModes(data, &num_active_bases_in, &num_eval_modes_in, &eval_modes_in, NULL, &num_active_bases_out, 613506b1a0cSSebastian Grimberg &num_eval_modes_out, &eval_modes_out, NULL, NULL)); 614506b1a0cSSebastian Grimberg 6153f08121cSJeremy L Thompson CeedCheck(num_active_bases_in == 1 && num_active_bases_out == 1, ceed, CEED_ERROR_UNSUPPORTED, 616506b1a0cSSebastian Grimberg "Cannot assemble operator with multiple active bases"); 6176574a04fSJeremy 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"); 618eaf62fffSJeremy L Thompson 619506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetBases(data, NULL, &active_bases_in, &B_mats_in, NULL, &active_bases_out, &B_mats_out)); 620506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &elem_rstr_in, &elem_rstr_out)); 621506b1a0cSSebastian Grimberg basis_in = active_bases_in[0]; 622506b1a0cSSebastian Grimberg basis_out = active_bases_out[0]; 623506b1a0cSSebastian Grimberg B_mat_in = B_mats_in[0]; 624506b1a0cSSebastian Grimberg B_mat_out = B_mats_out[0]; 625eaf62fffSJeremy L Thompson 626506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_in, &num_elem_in)); 627506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_in, &elem_size_in)); 628506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_in, &num_comp_in)); 629506b1a0cSSebastian Grimberg if (basis_in == CEED_BASIS_NONE) num_qpts_in = elem_size_in; 630506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(basis_in, &num_qpts_in)); 631506b1a0cSSebastian Grimberg 632506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(elem_rstr_in, &elem_rstr_type_in)); 633506b1a0cSSebastian Grimberg if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) { 634506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_orients_in)); 635506b1a0cSSebastian Grimberg } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) { 636506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_in, CEED_MEM_HOST, &elem_rstr_curl_orients_in)); 6377c1dbaffSSebastian Grimberg } 6387c1dbaffSSebastian Grimberg 639506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 640506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(elem_rstr_out, &num_elem_out)); 641506b1a0cSSebastian Grimberg CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 6423f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 6433f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 6443f08121cSJeremy L Thompson num_elem_in, num_elem_out); 645506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(elem_rstr_out, &elem_size_out)); 646506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(elem_rstr_out, &num_comp_out)); 647506b1a0cSSebastian Grimberg if (basis_out == CEED_BASIS_NONE) num_qpts_out = elem_size_out; 648506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(basis_out, &num_qpts_out)); 649506b1a0cSSebastian Grimberg CeedCheck(num_qpts_in == num_qpts_out, ceed, CEED_ERROR_UNSUPPORTED, 6503f08121cSJeremy L Thompson "Active input and output bases must have the same number of quadrature points." 6513f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " points; output has %" CeedInt_FMT "points.", 6523f08121cSJeremy L Thompson num_qpts_in, num_qpts_out); 653eaf62fffSJeremy L Thompson 654506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(elem_rstr_out, &elem_rstr_type_out)); 655506b1a0cSSebastian Grimberg if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) { 656506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_orients_out)); 657506b1a0cSSebastian Grimberg } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) { 658506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCurlOrientations(elem_rstr_out, CEED_MEM_HOST, &elem_rstr_curl_orients_out)); 659506b1a0cSSebastian Grimberg } 660506b1a0cSSebastian Grimberg } else { 661506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 662506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 663506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 664506b1a0cSSebastian Grimberg num_qpts_out = num_qpts_in; 665506b1a0cSSebastian Grimberg 666506b1a0cSSebastian Grimberg elem_rstr_orients_out = elem_rstr_orients_in; 667506b1a0cSSebastian Grimberg elem_rstr_curl_orients_out = elem_rstr_curl_orients_in; 668506b1a0cSSebastian Grimberg } 669c81f2b9dSJames Wright local_num_entries = (CeedSize)elem_size_out * num_comp_out * elem_size_in * num_comp_in * num_elem_in; 670506b1a0cSSebastian Grimberg 671506b1a0cSSebastian Grimberg // Loop over elements and put in data structure 6727c1dbaffSSebastian Grimberg // We store B_mat_in, B_mat_out, BTD, elem_mat in row-major order 6730459ebd3SSebastian Grimberg CeedTensorContract contract; 674123d890dSSebastian Grimberg CeedScalar *vals, *BTD_mat = NULL, *elem_mat = NULL, *elem_mat_b = NULL; 675506b1a0cSSebastian Grimberg 676c22497adSSebastian Grimberg CeedCall(CeedBasisGetTensorContract(basis_in, &contract)); 677123d890dSSebastian Grimberg CeedCall(CeedCalloc(elem_size_out * num_qpts_in * num_eval_modes_in[0], &BTD_mat)); 678123d890dSSebastian Grimberg CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat)); 679506b1a0cSSebastian Grimberg if (elem_rstr_curl_orients_in || elem_rstr_curl_orients_out) CeedCall(CeedCalloc(elem_size_out * elem_size_in, &elem_mat_b)); 6801c66c397SJeremy L Thompson 68128ec399dSJeremy L Thompson CeedCall(CeedVectorGetArray(values, CEED_MEM_HOST, &vals)); 682506b1a0cSSebastian Grimberg for (CeedSize e = 0; e < num_elem_in; e++) { 683506b1a0cSSebastian Grimberg for (CeedInt comp_in = 0; comp_in < num_comp_in; comp_in++) { 684506b1a0cSSebastian Grimberg for (CeedInt comp_out = 0; comp_out < num_comp_out; comp_out++) { 685ed9e99e6SJeremy L Thompson // Compute B^T*D 686506b1a0cSSebastian Grimberg for (CeedSize n = 0; n < elem_size_out; n++) { 687506b1a0cSSebastian Grimberg for (CeedSize q = 0; q < num_qpts_in; q++) { 688437c7c90SJeremy L Thompson for (CeedInt e_in = 0; e_in < num_eval_modes_in[0]; e_in++) { 689506b1a0cSSebastian Grimberg const CeedSize btd_index = n * (num_qpts_in * num_eval_modes_in[0]) + q * num_eval_modes_in[0] + e_in; 690067fd99fSJeremy L Thompson CeedScalar sum = 0.0; 6911c66c397SJeremy L Thompson 692437c7c90SJeremy L Thompson for (CeedInt e_out = 0; e_out < num_eval_modes_out[0]; e_out++) { 693506b1a0cSSebastian Grimberg const CeedSize b_out_index = (q * num_eval_modes_out[0] + e_out) * elem_size_out + n; 694506b1a0cSSebastian 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; 695b94338b9SJed Brown const CeedSize qf_index = q * layout_qf[0] + eval_mode_index * layout_qf[1] + e * layout_qf[2]; 6961c66c397SJeremy L Thompson 697067fd99fSJeremy L Thompson sum += B_mat_out[b_out_index] * assembled_qf_array[qf_index]; 698eaf62fffSJeremy L Thompson } 699067fd99fSJeremy L Thompson BTD_mat[btd_index] = sum; 700ed9e99e6SJeremy L Thompson } 701ed9e99e6SJeremy L Thompson } 702eaf62fffSJeremy L Thompson } 7037c1dbaffSSebastian Grimberg 7047c1dbaffSSebastian Grimberg // Form element matrix itself (for each block component) 705e4065a52SSebastian Grimberg if (contract) { 7060459ebd3SSebastian Grimberg CeedCall(CeedTensorContractApply(contract, 1, num_qpts_in * num_eval_modes_in[0], elem_size_in, elem_size_out, BTD_mat, CEED_NOTRANSPOSE, 7070459ebd3SSebastian Grimberg false, B_mat_in, elem_mat)); 708e4065a52SSebastian Grimberg } else { 709e4065a52SSebastian 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])); 710e4065a52SSebastian Grimberg } 711eaf62fffSJeremy L Thompson 7127c1dbaffSSebastian Grimberg // Transform the element matrix if required 713506b1a0cSSebastian Grimberg if (elem_rstr_orients_out) { 714506b1a0cSSebastian Grimberg const bool *elem_orients = &elem_rstr_orients_out[e * elem_size_out]; 7151c66c397SJeremy L Thompson 716506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 717506b1a0cSSebastian Grimberg const double orient = elem_orients[i] ? -1.0 : 1.0; 718506b1a0cSSebastian Grimberg 719506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 720506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] *= orient; 7217c1dbaffSSebastian Grimberg } 7227c1dbaffSSebastian Grimberg } 723506b1a0cSSebastian Grimberg } else if (elem_rstr_curl_orients_out) { 724506b1a0cSSebastian Grimberg const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_out[e * 3 * elem_size_out]; 7251c66c397SJeremy L Thompson 7267c1dbaffSSebastian Grimberg // T^T*(B^T*D*B) 727506b1a0cSSebastian Grimberg memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar)); 728506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 729506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 730506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * i + 1] + 731506b1a0cSSebastian Grimberg (i > 0 ? elem_mat_b[(i - 1) * elem_size_in + j] * elem_curl_orients[3 * i - 1] : 0.0) + 732506b1a0cSSebastian Grimberg (i < elem_size_out - 1 ? elem_mat_b[(i + 1) * elem_size_in + j] * elem_curl_orients[3 * i + 3] : 0.0); 7337c1dbaffSSebastian Grimberg } 7347c1dbaffSSebastian Grimberg } 735506b1a0cSSebastian Grimberg } 736506b1a0cSSebastian Grimberg if (elem_rstr_orients_in) { 737506b1a0cSSebastian Grimberg const bool *elem_orients = &elem_rstr_orients_in[e * elem_size_in]; 738506b1a0cSSebastian Grimberg 739506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 740506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 741506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] *= elem_orients[j] ? -1.0 : 1.0; 742506b1a0cSSebastian Grimberg } 743506b1a0cSSebastian Grimberg } 744506b1a0cSSebastian Grimberg } else if (elem_rstr_curl_orients_in) { 745506b1a0cSSebastian Grimberg const CeedInt8 *elem_curl_orients = &elem_rstr_curl_orients_in[e * 3 * elem_size_in]; 746506b1a0cSSebastian Grimberg 747506b1a0cSSebastian Grimberg // (B^T*D*B)*T 748506b1a0cSSebastian Grimberg memcpy(elem_mat_b, elem_mat, elem_size_out * elem_size_in * sizeof(CeedScalar)); 749506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 750506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 751506b1a0cSSebastian Grimberg elem_mat[i * elem_size_in + j] = elem_mat_b[i * elem_size_in + j] * elem_curl_orients[3 * j + 1] + 752506b1a0cSSebastian Grimberg (j > 0 ? elem_mat_b[i * elem_size_in + j - 1] * elem_curl_orients[3 * j - 1] : 0.0) + 753506b1a0cSSebastian Grimberg (j < elem_size_in - 1 ? elem_mat_b[i * elem_size_in + j + 1] * elem_curl_orients[3 * j + 3] : 0.0); 7547c1dbaffSSebastian Grimberg } 7557c1dbaffSSebastian Grimberg } 7567c1dbaffSSebastian Grimberg } 7577c1dbaffSSebastian Grimberg 7587c1dbaffSSebastian Grimberg // Put element matrix in coordinate data structure 759506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < elem_size_out; i++) { 760506b1a0cSSebastian Grimberg for (CeedInt j = 0; j < elem_size_in; j++) { 761506b1a0cSSebastian Grimberg vals[offset + count] = elem_mat[i * elem_size_in + j]; 762eaf62fffSJeremy L Thompson count++; 763eaf62fffSJeremy L Thompson } 764eaf62fffSJeremy L Thompson } 765eaf62fffSJeremy L Thompson } 766eaf62fffSJeremy L Thompson } 767eaf62fffSJeremy L Thompson } 7686574a04fSJeremy L Thompson CeedCheck(count == local_num_entries, ceed, CEED_ERROR_MAJOR, "Error computing entries"); 7692b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(values, &vals)); 770eaf62fffSJeremy L Thompson 771506b1a0cSSebastian Grimberg // Cleanup 772123d890dSSebastian Grimberg CeedCall(CeedFree(&BTD_mat)); 773123d890dSSebastian Grimberg CeedCall(CeedFree(&elem_mat)); 774506b1a0cSSebastian Grimberg CeedCall(CeedFree(&elem_mat_b)); 775506b1a0cSSebastian Grimberg if (elem_rstr_type_in == CEED_RESTRICTION_ORIENTED) { 776506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_in, &elem_rstr_orients_in)); 777506b1a0cSSebastian Grimberg } else if (elem_rstr_type_in == CEED_RESTRICTION_CURL_ORIENTED) { 778506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_in, &elem_rstr_curl_orients_in)); 779506b1a0cSSebastian Grimberg } 780506b1a0cSSebastian Grimberg if (elem_rstr_in != elem_rstr_out) { 781506b1a0cSSebastian Grimberg if (elem_rstr_type_out == CEED_RESTRICTION_ORIENTED) { 782506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOrientations(elem_rstr_out, &elem_rstr_orients_out)); 783506b1a0cSSebastian Grimberg } else if (elem_rstr_type_out == CEED_RESTRICTION_CURL_ORIENTED) { 784506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreCurlOrientations(elem_rstr_out, &elem_rstr_curl_orients_out)); 785506b1a0cSSebastian Grimberg } 786506b1a0cSSebastian Grimberg } 7872b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled_qf, &assembled_qf_array)); 7882b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_qf)); 789*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 790*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 791eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 792eaf62fffSJeremy L Thompson } 793eaf62fffSJeremy L Thompson 794eaf62fffSJeremy L Thompson /** 795ca94c3ddSJeremy L Thompson @brief Count number of entries for assembled `CeedOperator` 796eaf62fffSJeremy L Thompson 797ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 798eaf62fffSJeremy L Thompson @param[out] num_entries Number of entries in assembled representation 799eaf62fffSJeremy L Thompson 800eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 801eaf62fffSJeremy L Thompson 802eaf62fffSJeremy L Thompson @ref Utility 803eaf62fffSJeremy L Thompson **/ 804b94338b9SJed Brown static int CeedSingleOperatorAssemblyCountEntries(CeedOperator op, CeedSize *num_entries) { 805b275c451SJeremy L Thompson bool is_composite; 806506b1a0cSSebastian Grimberg CeedInt num_elem_in, elem_size_in, num_comp_in, num_elem_out, elem_size_out, num_comp_out; 8071203703bSJeremy L Thompson Ceed ceed; 808506b1a0cSSebastian Grimberg CeedElemRestriction rstr_in, rstr_out; 809eaf62fffSJeremy L Thompson 8101203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 811b275c451SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 8121203703bSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Composite operator not supported"); 813506b1a0cSSebastian Grimberg 814506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetActiveElemRestrictions(op, &rstr_in, &rstr_out)); 815506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr_in, &num_elem_in)); 816506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr_in, &elem_size_in)); 817506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr_in, &num_comp_in)); 818506b1a0cSSebastian Grimberg if (rstr_in != rstr_out) { 819506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr_out, &num_elem_out)); 8201203703bSJeremy L Thompson CeedCheck(num_elem_in == num_elem_out, ceed, CEED_ERROR_UNSUPPORTED, 8213f08121cSJeremy L Thompson "Active input and output operator restrictions must have the same number of elements." 8223f08121cSJeremy L Thompson " Input has %" CeedInt_FMT " elements; output has %" CeedInt_FMT "elements.", 8233f08121cSJeremy L Thompson num_elem_in, num_elem_out); 824506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr_out, &elem_size_out)); 825506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr_out, &num_comp_out)); 826506b1a0cSSebastian Grimberg } else { 827506b1a0cSSebastian Grimberg num_elem_out = num_elem_in; 828506b1a0cSSebastian Grimberg elem_size_out = elem_size_in; 829506b1a0cSSebastian Grimberg num_comp_out = num_comp_in; 830506b1a0cSSebastian Grimberg } 831*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_in)); 832*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_out)); 833506b1a0cSSebastian Grimberg *num_entries = (CeedSize)elem_size_in * num_comp_in * elem_size_out * num_comp_out * num_elem_in; 834eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 835eaf62fffSJeremy L Thompson } 836eaf62fffSJeremy L Thompson 837eaf62fffSJeremy L Thompson /** 838ca94c3ddSJeremy L Thompson @brief Common code for creating a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` 839eaf62fffSJeremy L Thompson 840ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 841ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 842ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 843ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 844ca94c3ddSJeremy L Thompson @param[in] basis_c_to_f `CeedBasis` for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction operators 845ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 846ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 847ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 848eaf62fffSJeremy L Thompson 849eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 850eaf62fffSJeremy L Thompson 851eaf62fffSJeremy L Thompson @ref Developer 852eaf62fffSJeremy L Thompson **/ 8532b730f8bSJeremy L Thompson static int CeedSingleOperatorMultigridLevel(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 8547758292fSSebastian Grimberg CeedBasis basis_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) { 8551c66c397SJeremy L Thompson bool is_composite; 856eaf62fffSJeremy L Thompson Ceed ceed; 8571203703bSJeremy L Thompson CeedInt num_comp, num_input_fields, num_output_fields; 85885bb9dcfSJeremy L Thompson CeedVector mult_vec = NULL; 8591c66c397SJeremy L Thompson CeedElemRestriction rstr_p_mult_fine = NULL, rstr_fine = NULL; 8601203703bSJeremy L Thompson CeedOperatorField *input_fields, *output_fields; 8611c66c397SJeremy L Thompson 8622b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 863eaf62fffSJeremy L Thompson 864eaf62fffSJeremy L Thompson // Check for composite operator 8652b730f8bSJeremy L Thompson CeedCall(CeedOperatorIsComposite(op_fine, &is_composite)); 8666574a04fSJeremy L Thompson CeedCheck(!is_composite, ceed, CEED_ERROR_UNSUPPORTED, "Automatic multigrid setup for composite operators not supported"); 867eaf62fffSJeremy L Thompson 868eaf62fffSJeremy L Thompson // Coarse Grid 8692b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed, op_fine->qf, op_fine->dqf, op_fine->dqfT, op_coarse)); 8701203703bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op_fine, &num_input_fields, &input_fields, &num_output_fields, &output_fields)); 871eaf62fffSJeremy L Thompson // -- Clone input fields 8721203703bSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 8736f8994e9SJeremy L Thompson const char *field_name; 8741203703bSJeremy L Thompson CeedVector vec; 875*681d0ea7SJeremy L Thompson CeedElemRestriction rstr = NULL; 876*681d0ea7SJeremy L Thompson CeedBasis basis = NULL; 8771203703bSJeremy L Thompson 8781203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetName(input_fields[i], &field_name)); 8791203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(input_fields[i], &vec)); 8801203703bSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 881*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr)); 882*681d0ea7SJeremy L Thompson CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis)); 883*681d0ea7SJeremy L Thompson if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr_fine)); 884eaf62fffSJeremy L Thompson } else { 8851203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(input_fields[i], &rstr)); 8861203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(input_fields[i], &basis)); 887eaf62fffSJeremy L Thompson } 8881203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec)); 889*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 890*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 891*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 892eaf62fffSJeremy L Thompson } 893eaf62fffSJeremy L Thompson // -- Clone output fields 8941203703bSJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 8956f8994e9SJeremy L Thompson const char *field_name; 8961203703bSJeremy L Thompson CeedVector vec; 897*681d0ea7SJeremy L Thompson CeedElemRestriction rstr = NULL; 898*681d0ea7SJeremy L Thompson CeedBasis basis = NULL; 8991203703bSJeremy L Thompson 9001203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetName(output_fields[i], &field_name)); 9011203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(output_fields[i], &vec)); 9021203703bSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 903*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr_coarse, &rstr)); 904*681d0ea7SJeremy L Thompson CeedCall(CeedBasisReferenceCopy(basis_coarse, &basis)); 905*681d0ea7SJeremy L Thompson if (!rstr_fine) CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr_fine)); 906eaf62fffSJeremy L Thompson } else { 9071203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(output_fields[i], &rstr)); 9081203703bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(output_fields[i], &basis)); 909eaf62fffSJeremy L Thompson } 9101203703bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_coarse, field_name, rstr, basis, vec)); 911*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 912*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 913*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 914eaf62fffSJeremy L Thompson } 915af99e877SJeremy L Thompson // -- Clone QFunctionAssemblyData 9167d5185d7SSebastian Grimberg { 9177d5185d7SSebastian Grimberg CeedQFunctionAssemblyData fine_data; 9187d5185d7SSebastian Grimberg 9197d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op_fine, &fine_data)); 9207d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataReferenceCopy(fine_data, &(*op_coarse)->qf_assembled)); 9217d5185d7SSebastian Grimberg } 922eaf62fffSJeremy L Thompson 923eaf62fffSJeremy L Thompson // Multiplicity vector 9247758292fSSebastian Grimberg if (op_restrict || op_prolong) { 92585bb9dcfSJeremy L Thompson CeedVector mult_e_vec; 9261c66c397SJeremy L Thompson CeedRestrictionType rstr_type; 92785bb9dcfSJeremy L Thompson 9287c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionGetType(rstr_fine, &rstr_type)); 9297c1dbaffSSebastian Grimberg CeedCheck(rstr_type != CEED_RESTRICTION_CURL_ORIENTED, ceed, CEED_ERROR_UNSUPPORTED, 9307c1dbaffSSebastian Grimberg "Element restrictions created with CeedElemRestrictionCreateCurlOriented are not supported"); 9316574a04fSJeremy L Thompson CeedCheck(p_mult_fine, ceed, CEED_ERROR_INCOMPATIBLE, "Prolongation or restriction operator creation requires fine grid multiplicity vector"); 9327c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnsignedCopy(rstr_fine, &rstr_p_mult_fine)); 9332b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionCreateVector(rstr_fine, &mult_vec, &mult_e_vec)); 9342b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(mult_e_vec, 0.0)); 935c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_NOTRANSPOSE, p_mult_fine, mult_e_vec, CEED_REQUEST_IMMEDIATE)); 9362b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(mult_vec, 0.0)); 937c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionApply(rstr_p_mult_fine, CEED_TRANSPOSE, mult_e_vec, mult_vec, CEED_REQUEST_IMMEDIATE)); 9382b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&mult_e_vec)); 9392b730f8bSJeremy L Thompson CeedCall(CeedVectorReciprocal(mult_vec)); 94085bb9dcfSJeremy L Thompson } 941eaf62fffSJeremy L Thompson 942addd79feSZach Atkins // Clone name 943addd79feSZach Atkins bool has_name = op_fine->name; 944addd79feSZach Atkins size_t name_len = op_fine->name ? strlen(op_fine->name) : 0; 945addd79feSZach Atkins CeedCall(CeedOperatorSetName(*op_coarse, op_fine->name)); 946addd79feSZach Atkins 9477758292fSSebastian Grimberg // Check that coarse to fine basis is provided if prolong/restrict operators are requested 9487758292fSSebastian Grimberg CeedCheck(basis_c_to_f || (!op_restrict && !op_prolong), ceed, CEED_ERROR_INCOMPATIBLE, 9496574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine basis"); 95083d6adf3SZach Atkins 95185bb9dcfSJeremy L Thompson // Restriction/Prolongation Operators 9522b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_coarse, &num_comp)); 953addd79feSZach Atkins 954addd79feSZach Atkins // Restriction 9557758292fSSebastian Grimberg if (op_restrict) { 956eaf62fffSJeremy L Thompson CeedInt *num_comp_r_data; 95785bb9dcfSJeremy L Thompson CeedQFunctionContext ctx_r; 9587758292fSSebastian Grimberg CeedQFunction qf_restrict; 95985bb9dcfSJeremy L Thompson 9607758292fSSebastian Grimberg CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_restrict)); 9612b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_r_data)); 962eaf62fffSJeremy L Thompson num_comp_r_data[0] = num_comp; 9632b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_r)); 9642b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_r, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_r_data), num_comp_r_data)); 9657758292fSSebastian Grimberg CeedCall(CeedQFunctionSetContext(qf_restrict, ctx_r)); 9662b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_r)); 9677758292fSSebastian Grimberg CeedCall(CeedQFunctionAddInput(qf_restrict, "input", num_comp, CEED_EVAL_NONE)); 9687758292fSSebastian Grimberg CeedCall(CeedQFunctionAddInput(qf_restrict, "scale", num_comp, CEED_EVAL_NONE)); 9697758292fSSebastian Grimberg CeedCall(CeedQFunctionAddOutput(qf_restrict, "output", num_comp, CEED_EVAL_INTERP)); 9707758292fSSebastian Grimberg CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_restrict, num_comp)); 971eaf62fffSJeremy L Thompson 9727758292fSSebastian Grimberg CeedCall(CeedOperatorCreate(ceed, qf_restrict, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_restrict)); 9737758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "input", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE)); 9747758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec)); 9757758292fSSebastian Grimberg CeedCall(CeedOperatorSetField(*op_restrict, "output", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE)); 976eaf62fffSJeremy L Thompson 977addd79feSZach Atkins // Set name 978addd79feSZach Atkins char *restriction_name; 9791c66c397SJeremy L Thompson 980addd79feSZach Atkins CeedCall(CeedCalloc(17 + name_len, &restriction_name)); 981addd79feSZach Atkins sprintf(restriction_name, "restriction%s%s", has_name ? " for " : "", has_name ? op_fine->name : ""); 9827758292fSSebastian Grimberg CeedCall(CeedOperatorSetName(*op_restrict, restriction_name)); 983addd79feSZach Atkins CeedCall(CeedFree(&restriction_name)); 984addd79feSZach Atkins 985addd79feSZach Atkins // Check 9867758292fSSebastian Grimberg CeedCall(CeedOperatorCheckReady(*op_restrict)); 987addd79feSZach Atkins 988addd79feSZach Atkins // Cleanup 9897758292fSSebastian Grimberg CeedCall(CeedQFunctionDestroy(&qf_restrict)); 990addd79feSZach Atkins } 991addd79feSZach Atkins 992eaf62fffSJeremy L Thompson // Prolongation 993addd79feSZach Atkins if (op_prolong) { 994eaf62fffSJeremy L Thompson CeedInt *num_comp_p_data; 99585bb9dcfSJeremy L Thompson CeedQFunctionContext ctx_p; 9961c66c397SJeremy L Thompson CeedQFunction qf_prolong; 99785bb9dcfSJeremy L Thompson 99885bb9dcfSJeremy L Thompson CeedCall(CeedQFunctionCreateInteriorByName(ceed, "Scale", &qf_prolong)); 9992b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_p_data)); 1000eaf62fffSJeremy L Thompson num_comp_p_data[0] = num_comp; 10012b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_p)); 10022b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_p, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_p_data), num_comp_p_data)); 10032b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(qf_prolong, ctx_p)); 10042b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_p)); 10052b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_prolong, "input", num_comp, CEED_EVAL_INTERP)); 10062b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_prolong, "scale", num_comp, CEED_EVAL_NONE)); 10072b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(qf_prolong, "output", num_comp, CEED_EVAL_NONE)); 10082b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_prolong, num_comp)); 1009eaf62fffSJeremy L Thompson 10102b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed, qf_prolong, CEED_QFUNCTION_NONE, CEED_QFUNCTION_NONE, op_prolong)); 10112b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "input", rstr_coarse, basis_c_to_f, CEED_VECTOR_ACTIVE)); 1012356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "scale", rstr_p_mult_fine, CEED_BASIS_NONE, mult_vec)); 1013356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*op_prolong, "output", rstr_fine, CEED_BASIS_NONE, CEED_VECTOR_ACTIVE)); 1014eaf62fffSJeremy L Thompson 1015addd79feSZach Atkins // Set name 1016ea6b5821SJeremy L Thompson char *prolongation_name; 10171c66c397SJeremy L Thompson 10182b730f8bSJeremy L Thompson CeedCall(CeedCalloc(18 + name_len, &prolongation_name)); 10192b730f8bSJeremy L Thompson sprintf(prolongation_name, "prolongation%s%s", has_name ? " for " : "", has_name ? op_fine->name : ""); 10202b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetName(*op_prolong, prolongation_name)); 10212b730f8bSJeremy L Thompson CeedCall(CeedFree(&prolongation_name)); 1022addd79feSZach Atkins 1023addd79feSZach Atkins // Check 1024addd79feSZach Atkins CeedCall(CeedOperatorCheckReady(*op_prolong)); 1025addd79feSZach Atkins 1026addd79feSZach Atkins // Cleanup 1027addd79feSZach Atkins CeedCall(CeedQFunctionDestroy(&qf_prolong)); 1028ea6b5821SJeremy L Thompson } 1029ea6b5821SJeremy L Thompson 103058e4b056SJeremy L Thompson // Check 103158e4b056SJeremy L Thompson CeedCall(CeedOperatorCheckReady(*op_coarse)); 103258e4b056SJeremy L Thompson 1033eaf62fffSJeremy L Thompson // Cleanup 10342b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&mult_vec)); 1035*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_fine)); 1036c17ec2beSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_p_mult_fine)); 10372b730f8bSJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_c_to_f)); 1038eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1039eaf62fffSJeremy L Thompson } 1040eaf62fffSJeremy L Thompson 1041eaf62fffSJeremy L Thompson /** 1042eaf62fffSJeremy L Thompson @brief Build 1D mass matrix and Laplacian with perturbation 1043eaf62fffSJeremy L Thompson 1044eaf62fffSJeremy L Thompson @param[in] interp_1d Interpolation matrix in one dimension 1045eaf62fffSJeremy L Thompson @param[in] grad_1d Gradient matrix in one dimension 1046eaf62fffSJeremy L Thompson @param[in] q_weight_1d Quadrature weights in one dimension 1047eaf62fffSJeremy L Thompson @param[in] P_1d Number of basis nodes in one dimension 1048eaf62fffSJeremy L Thompson @param[in] Q_1d Number of quadrature points in one dimension 1049eaf62fffSJeremy L Thompson @param[in] dim Dimension of basis 1050eaf62fffSJeremy L Thompson @param[out] mass Assembled mass matrix in one dimension 1051eaf62fffSJeremy L Thompson @param[out] laplace Assembled perturbed Laplacian in one dimension 1052eaf62fffSJeremy L Thompson 1053eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1054eaf62fffSJeremy L Thompson 1055eaf62fffSJeremy L Thompson @ref Developer 1056eaf62fffSJeremy L Thompson **/ 10572c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOff 10582c2ea1dbSJeremy L Thompson static int CeedBuildMassLaplace(const CeedScalar *interp_1d, const CeedScalar *grad_1d, const CeedScalar *q_weight_1d, CeedInt P_1d, CeedInt Q_1d, 10592c2ea1dbSJeremy L Thompson CeedInt dim, CeedScalar *mass, CeedScalar *laplace) { 10602b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 1061eaf62fffSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) { 1062eaf62fffSJeremy L Thompson CeedScalar sum = 0.0; 10632b730f8bSJeremy 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]; 1064eaf62fffSJeremy L Thompson mass[i + j * P_1d] = sum; 1065eaf62fffSJeremy L Thompson } 10662b730f8bSJeremy L Thompson } 1067eaf62fffSJeremy L Thompson // -- Laplacian 10682b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 1069eaf62fffSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) { 1070eaf62fffSJeremy L Thompson CeedScalar sum = 0.0; 10711c66c397SJeremy L Thompson 10722b730f8bSJeremy 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]; 1073eaf62fffSJeremy L Thompson laplace[i + j * P_1d] = sum; 1074eaf62fffSJeremy L Thompson } 10752b730f8bSJeremy L Thompson } 1076eaf62fffSJeremy L Thompson CeedScalar perturbation = dim > 2 ? 1e-6 : 1e-4; 10772b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) laplace[i + P_1d * i] += perturbation; 1078eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1079eaf62fffSJeremy L Thompson } 10802c2ea1dbSJeremy L Thompson CeedPragmaOptimizeOn 1081eaf62fffSJeremy L Thompson 1082eaf62fffSJeremy L Thompson /// @} 1083eaf62fffSJeremy L Thompson 1084eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 1085480fae85SJeremy L Thompson /// CeedOperator Backend API 1086480fae85SJeremy L Thompson /// ---------------------------------------------------------------------------- 1087480fae85SJeremy L Thompson /// @addtogroup CeedOperatorBackend 1088480fae85SJeremy L Thompson /// @{ 1089480fae85SJeremy L Thompson 1090480fae85SJeremy L Thompson /** 1091004e4986SSebastian Grimberg @brief Select correct basis matrix pointer based on @ref CeedEvalMode 1092004e4986SSebastian Grimberg 1093004e4986SSebastian Grimberg @param[in] basis `CeedBasis` from which to get the basis matrix 1094004e4986SSebastian Grimberg @param[in] eval_mode Current basis evaluation mode 1095004e4986SSebastian Grimberg @param[in] identity Pointer to identity matrix 1096004e4986SSebastian Grimberg @param[out] basis_ptr `CeedBasis` pointer to set 1097004e4986SSebastian Grimberg 1098004e4986SSebastian Grimberg @ref Backend 1099004e4986SSebastian Grimberg **/ 1100004e4986SSebastian Grimberg int CeedOperatorGetBasisPointer(CeedBasis basis, CeedEvalMode eval_mode, const CeedScalar *identity, const CeedScalar **basis_ptr) { 1101004e4986SSebastian Grimberg switch (eval_mode) { 1102004e4986SSebastian Grimberg case CEED_EVAL_NONE: 1103004e4986SSebastian Grimberg *basis_ptr = identity; 1104004e4986SSebastian Grimberg break; 1105004e4986SSebastian Grimberg case CEED_EVAL_INTERP: 1106004e4986SSebastian Grimberg CeedCall(CeedBasisGetInterp(basis, basis_ptr)); 1107004e4986SSebastian Grimberg break; 1108004e4986SSebastian Grimberg case CEED_EVAL_GRAD: 1109004e4986SSebastian Grimberg CeedCall(CeedBasisGetGrad(basis, basis_ptr)); 1110004e4986SSebastian Grimberg break; 1111004e4986SSebastian Grimberg case CEED_EVAL_DIV: 1112004e4986SSebastian Grimberg CeedCall(CeedBasisGetDiv(basis, basis_ptr)); 1113004e4986SSebastian Grimberg break; 1114004e4986SSebastian Grimberg case CEED_EVAL_CURL: 1115004e4986SSebastian Grimberg CeedCall(CeedBasisGetCurl(basis, basis_ptr)); 1116004e4986SSebastian Grimberg break; 1117004e4986SSebastian Grimberg case CEED_EVAL_WEIGHT: 1118004e4986SSebastian Grimberg break; // Caught by QF Assembly 1119004e4986SSebastian Grimberg } 1120004e4986SSebastian Grimberg assert(*basis_ptr != NULL); 1121004e4986SSebastian Grimberg return CEED_ERROR_SUCCESS; 1122004e4986SSebastian Grimberg } 1123004e4986SSebastian Grimberg 1124004e4986SSebastian Grimberg /** 1125ca94c3ddSJeremy L Thompson @brief Create point block restriction for active `CeedOperatorField` 1126506b1a0cSSebastian Grimberg 1127ca94c3ddSJeremy L Thompson @param[in] rstr Original `CeedElemRestriction` for active field 1128ca94c3ddSJeremy L Thompson @param[out] point_block_rstr Address of the variable where the newly created `CeedElemRestriction` will be stored 1129506b1a0cSSebastian Grimberg 1130506b1a0cSSebastian Grimberg @return An error code: 0 - success, otherwise - failure 1131506b1a0cSSebastian Grimberg 1132506b1a0cSSebastian Grimberg @ref Backend 1133506b1a0cSSebastian Grimberg **/ 1134506b1a0cSSebastian Grimberg int CeedOperatorCreateActivePointBlockRestriction(CeedElemRestriction rstr, CeedElemRestriction *point_block_rstr) { 1135506b1a0cSSebastian Grimberg Ceed ceed; 1136506b1a0cSSebastian Grimberg CeedInt num_elem, num_comp, shift, elem_size, comp_stride, *point_block_offsets; 1137506b1a0cSSebastian Grimberg CeedSize l_size; 1138506b1a0cSSebastian Grimberg const CeedInt *offsets; 1139506b1a0cSSebastian Grimberg 1140506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCeed(rstr, &ceed)); 1141506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOffsets(rstr, CEED_MEM_HOST, &offsets)); 1142506b1a0cSSebastian Grimberg 1143506b1a0cSSebastian Grimberg // Expand offsets 1144506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem)); 1145506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetNumComponents(rstr, &num_comp)); 1146506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(rstr, &elem_size)); 1147506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetCompStride(rstr, &comp_stride)); 1148506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetLVectorSize(rstr, &l_size)); 1149506b1a0cSSebastian Grimberg shift = num_comp; 1150506b1a0cSSebastian Grimberg if (comp_stride != 1) shift *= num_comp; 1151506b1a0cSSebastian Grimberg CeedCall(CeedCalloc(num_elem * elem_size, &point_block_offsets)); 1152506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_elem * elem_size; i++) { 1153506b1a0cSSebastian Grimberg point_block_offsets[i] = offsets[i] * shift; 1154506b1a0cSSebastian Grimberg } 1155506b1a0cSSebastian Grimberg 1156506b1a0cSSebastian Grimberg // Create new restriction 1157506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionCreate(ceed, num_elem, elem_size, num_comp * num_comp, 1, l_size * num_comp, CEED_MEM_HOST, CEED_OWN_POINTER, 1158506b1a0cSSebastian Grimberg point_block_offsets, point_block_rstr)); 1159506b1a0cSSebastian Grimberg 1160506b1a0cSSebastian Grimberg // Cleanup 1161506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOffsets(rstr, &offsets)); 1162506b1a0cSSebastian Grimberg return CEED_ERROR_SUCCESS; 1163506b1a0cSSebastian Grimberg } 1164506b1a0cSSebastian Grimberg 1165506b1a0cSSebastian Grimberg /** 11667d5185d7SSebastian Grimberg @brief Get `CeedQFunctionAssemblyData` 11677d5185d7SSebastian Grimberg 11687d5185d7SSebastian Grimberg @param[in] op `CeedOperator` to assemble 11697d5185d7SSebastian Grimberg @param[out] data `CeedQFunctionAssemblyData` 11707d5185d7SSebastian Grimberg 11717d5185d7SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 11727d5185d7SSebastian Grimberg 11737d5185d7SSebastian Grimberg @ref Backend 11747d5185d7SSebastian Grimberg **/ 11757d5185d7SSebastian Grimberg int CeedOperatorGetQFunctionAssemblyData(CeedOperator op, CeedQFunctionAssemblyData *data) { 11767d5185d7SSebastian Grimberg if (!op->qf_assembled) { 11777d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 11787d5185d7SSebastian Grimberg 11797d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataCreate(op->ceed, &data)); 11807d5185d7SSebastian Grimberg op->qf_assembled = data; 11817d5185d7SSebastian Grimberg } 11827d5185d7SSebastian Grimberg *data = op->qf_assembled; 11837d5185d7SSebastian Grimberg return CEED_ERROR_SUCCESS; 11847d5185d7SSebastian Grimberg } 11857d5185d7SSebastian Grimberg 11867d5185d7SSebastian Grimberg /** 1187ca94c3ddSJeremy L Thompson @brief Create object holding `CeedQFunction` assembly data for `CeedOperator` 1188480fae85SJeremy L Thompson 1189ca94c3ddSJeremy L Thompson @param[in] ceed `Ceed` object used to create the `CeedQFunctionAssemblyData` 1190ca94c3ddSJeremy L Thompson @param[out] data Address of the variable where the newly created `CeedQFunctionAssemblyData` will be stored 1191480fae85SJeremy L Thompson 1192480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1193480fae85SJeremy L Thompson 1194480fae85SJeremy L Thompson @ref Backend 1195480fae85SJeremy L Thompson **/ 1196ea61e9acSJeremy L Thompson int CeedQFunctionAssemblyDataCreate(Ceed ceed, CeedQFunctionAssemblyData *data) { 11972b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, data)); 1198480fae85SJeremy L Thompson (*data)->ref_count = 1; 1199480fae85SJeremy L Thompson (*data)->ceed = ceed; 12002b730f8bSJeremy L Thompson CeedCall(CeedReference(ceed)); 1201480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1202480fae85SJeremy L Thompson } 1203480fae85SJeremy L Thompson 1204480fae85SJeremy L Thompson /** 1205ca94c3ddSJeremy L Thompson @brief Increment the reference counter for a `CeedQFunctionAssemblyData` 1206480fae85SJeremy L Thompson 1207ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to increment the reference counter 1208480fae85SJeremy L Thompson 1209480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1210480fae85SJeremy L Thompson 1211480fae85SJeremy L Thompson @ref Backend 1212480fae85SJeremy L Thompson **/ 1213480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataReference(CeedQFunctionAssemblyData data) { 1214480fae85SJeremy L Thompson data->ref_count++; 1215480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1216480fae85SJeremy L Thompson } 1217480fae85SJeremy L Thompson 1218480fae85SJeremy L Thompson /** 1219ca94c3ddSJeremy L Thompson @brief Set re-use of `CeedQFunctionAssemblyData` 12208b919e6bSJeremy L Thompson 1221ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to mark for reuse 1222ea61e9acSJeremy L Thompson @param[in] reuse_data Boolean flag indicating data re-use 12238b919e6bSJeremy L Thompson 12248b919e6bSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 12258b919e6bSJeremy L Thompson 12268b919e6bSJeremy L Thompson @ref Backend 12278b919e6bSJeremy L Thompson **/ 12282b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetReuse(CeedQFunctionAssemblyData data, bool reuse_data) { 1229beecbf24SJeremy L Thompson data->reuse_data = reuse_data; 1230beecbf24SJeremy L Thompson data->needs_data_update = true; 1231beecbf24SJeremy L Thompson return CEED_ERROR_SUCCESS; 1232beecbf24SJeremy L Thompson } 1233beecbf24SJeremy L Thompson 1234beecbf24SJeremy L Thompson /** 1235ca94c3ddSJeremy L Thompson @brief Mark `CeedQFunctionAssemblyData` as stale 1236beecbf24SJeremy L Thompson 1237ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to mark as stale 1238ea61e9acSJeremy L Thompson @param[in] needs_data_update Boolean flag indicating if update is needed or completed 1239beecbf24SJeremy L Thompson 1240beecbf24SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1241beecbf24SJeremy L Thompson 1242beecbf24SJeremy L Thompson @ref Backend 1243beecbf24SJeremy L Thompson **/ 12442b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetUpdateNeeded(CeedQFunctionAssemblyData data, bool needs_data_update) { 1245beecbf24SJeremy L Thompson data->needs_data_update = needs_data_update; 12468b919e6bSJeremy L Thompson return CEED_ERROR_SUCCESS; 12478b919e6bSJeremy L Thompson } 12488b919e6bSJeremy L Thompson 12498b919e6bSJeremy L Thompson /** 1250ca94c3ddSJeremy L Thompson @brief Determine if `CeedQFunctionAssemblyData` needs update 12518b919e6bSJeremy L Thompson 1252ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to mark as stale 12538b919e6bSJeremy L Thompson @param[out] is_update_needed Boolean flag indicating if re-assembly is required 12548b919e6bSJeremy L Thompson 12558b919e6bSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 12568b919e6bSJeremy L Thompson 12578b919e6bSJeremy L Thompson @ref Backend 12588b919e6bSJeremy L Thompson **/ 12592b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsUpdateNeeded(CeedQFunctionAssemblyData data, bool *is_update_needed) { 1260beecbf24SJeremy L Thompson *is_update_needed = !data->reuse_data || data->needs_data_update; 12618b919e6bSJeremy L Thompson return CEED_ERROR_SUCCESS; 12628b919e6bSJeremy L Thompson } 12638b919e6bSJeremy L Thompson 12648b919e6bSJeremy L Thompson /** 1265ca94c3ddSJeremy L Thompson @brief Copy the pointer to a `CeedQFunctionAssemblyData`. 12664385fb7fSSebastian Grimberg 1267ca94c3ddSJeremy L Thompson Both pointers should be destroyed with @ref CeedQFunctionAssemblyDataDestroy(). 1268512bb800SJeremy L Thompson 1269ca94c3ddSJeremy 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`. 1270ca94c3ddSJeremy L Thompson This `CeedQFunctionAssemblyData` will be destroyed if ` *data_copy` is the only reference to this `CeedQFunctionAssemblyData`. 1271480fae85SJeremy L Thompson 1272ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to copy reference to 1273ea61e9acSJeremy L Thompson @param[in,out] data_copy Variable to store copied reference 1274480fae85SJeremy L Thompson 1275480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1276480fae85SJeremy L Thompson 1277480fae85SJeremy L Thompson @ref Backend 1278480fae85SJeremy L Thompson **/ 12792b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataReferenceCopy(CeedQFunctionAssemblyData data, CeedQFunctionAssemblyData *data_copy) { 12802b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAssemblyDataReference(data)); 12812b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAssemblyDataDestroy(data_copy)); 1282480fae85SJeremy L Thompson *data_copy = data; 1283480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1284480fae85SJeremy L Thompson } 1285480fae85SJeremy L Thompson 1286480fae85SJeremy L Thompson /** 1287ca94c3ddSJeremy L Thompson @brief Get setup status for internal objects for `CeedQFunctionAssemblyData` 1288480fae85SJeremy L Thompson 1289ca94c3ddSJeremy L Thompson @param[in] data `CeedQFunctionAssemblyData` to retrieve status 1290480fae85SJeremy L Thompson @param[out] is_setup Boolean flag for setup status 1291480fae85SJeremy L Thompson 1292480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1293480fae85SJeremy L Thompson 1294480fae85SJeremy L Thompson @ref Backend 1295480fae85SJeremy L Thompson **/ 12962b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataIsSetup(CeedQFunctionAssemblyData data, bool *is_setup) { 1297480fae85SJeremy L Thompson *is_setup = data->is_setup; 1298480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1299480fae85SJeremy L Thompson } 1300480fae85SJeremy L Thompson 1301480fae85SJeremy L Thompson /** 1302ca94c3ddSJeremy L Thompson @brief Set internal objects for `CeedQFunctionAssemblyData` 1303480fae85SJeremy L Thompson 1304ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to set objects 1305ca94c3ddSJeremy L Thompson @param[in] vec `CeedVector` to store assembled `CeedQFunction` at quadrature points 1306ca94c3ddSJeremy L Thompson @param[in] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1307480fae85SJeremy L Thompson 1308480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1309480fae85SJeremy L Thompson 1310480fae85SJeremy L Thompson @ref Backend 1311480fae85SJeremy L Thompson **/ 13122b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataSetObjects(CeedQFunctionAssemblyData data, CeedVector vec, CeedElemRestriction rstr) { 13132b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(vec, &data->vec)); 13142b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(rstr, &data->rstr)); 1315480fae85SJeremy L Thompson 1316480fae85SJeremy L Thompson data->is_setup = true; 1317480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1318480fae85SJeremy L Thompson } 1319480fae85SJeremy L Thompson 13204dd1a9d2SSebastian Grimberg /** 1321ca94c3ddSJeremy L Thompson @brief Get internal objects for `CeedQFunctionAssemblyData` 13224dd1a9d2SSebastian Grimberg 1323ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to set objects 1324ca94c3ddSJeremy L Thompson @param[out] vec `CeedVector` to store assembled `CeedQFunction` at quadrature points 1325ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 13264dd1a9d2SSebastian Grimberg 13274dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 13284dd1a9d2SSebastian Grimberg 13294dd1a9d2SSebastian Grimberg @ref Backend 13304dd1a9d2SSebastian Grimberg **/ 13312b730f8bSJeremy L Thompson int CeedQFunctionAssemblyDataGetObjects(CeedQFunctionAssemblyData data, CeedVector *vec, CeedElemRestriction *rstr) { 13326574a04fSJeremy L Thompson CeedCheck(data->is_setup, data->ceed, CEED_ERROR_INCOMPLETE, "Internal objects not set; must call CeedQFunctionAssemblyDataSetObjects first."); 1333480fae85SJeremy L Thompson 13342b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(data->vec, vec)); 13352b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(data->rstr, rstr)); 1336480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1337480fae85SJeremy L Thompson } 1338480fae85SJeremy L Thompson 1339480fae85SJeremy L Thompson /** 1340ca94c3ddSJeremy L Thompson @brief Destroy `CeedQFunctionAssemblyData` 1341480fae85SJeremy L Thompson 1342ca94c3ddSJeremy L Thompson @param[in,out] data `CeedQFunctionAssemblyData` to destroy 1343480fae85SJeremy L Thompson 1344480fae85SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1345480fae85SJeremy L Thompson 1346480fae85SJeremy L Thompson @ref Backend 1347480fae85SJeremy L Thompson **/ 1348480fae85SJeremy L Thompson int CeedQFunctionAssemblyDataDestroy(CeedQFunctionAssemblyData *data) { 1349ad6481ceSJeremy L Thompson if (!*data || --(*data)->ref_count > 0) { 1350ad6481ceSJeremy L Thompson *data = NULL; 1351ad6481ceSJeremy L Thompson return CEED_ERROR_SUCCESS; 1352ad6481ceSJeremy L Thompson } 13532b730f8bSJeremy L Thompson CeedCall(CeedDestroy(&(*data)->ceed)); 13542b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&(*data)->vec)); 13552b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&(*data)->rstr)); 1356480fae85SJeremy L Thompson 13572b730f8bSJeremy L Thompson CeedCall(CeedFree(data)); 1358480fae85SJeremy L Thompson return CEED_ERROR_SUCCESS; 1359480fae85SJeremy L Thompson } 1360480fae85SJeremy L Thompson 1361ed9e99e6SJeremy L Thompson /** 1362ca94c3ddSJeremy L Thompson @brief Get `CeedOperatorAssemblyData` 1363ed9e99e6SJeremy L Thompson 1364ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 13657d5185d7SSebastian Grimberg @param[out] data `CeedOperatorAssemblyData` 1366ed9e99e6SJeremy L Thompson 1367ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1368ed9e99e6SJeremy L Thompson 1369ed9e99e6SJeremy L Thompson @ref Backend 1370ed9e99e6SJeremy L Thompson **/ 13712b730f8bSJeremy L Thompson int CeedOperatorGetOperatorAssemblyData(CeedOperator op, CeedOperatorAssemblyData *data) { 1372ed9e99e6SJeremy L Thompson if (!op->op_assembled) { 1373ed9e99e6SJeremy L Thompson CeedOperatorAssemblyData data; 1374ed9e99e6SJeremy L Thompson 13752b730f8bSJeremy L Thompson CeedCall(CeedOperatorAssemblyDataCreate(op->ceed, op, &data)); 1376ed9e99e6SJeremy L Thompson op->op_assembled = data; 1377ed9e99e6SJeremy L Thompson } 1378ed9e99e6SJeremy L Thompson *data = op->op_assembled; 1379ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1380ed9e99e6SJeremy L Thompson } 1381ed9e99e6SJeremy L Thompson 1382ed9e99e6SJeremy L Thompson /** 1383ca94c3ddSJeremy L Thompson @brief Create object holding `CeedOperator` assembly data. 1384ba746a46SJeremy L Thompson 1385ca94c3ddSJeremy L Thompson The `CeedOperatorAssemblyData` holds an array with references to every active `CeedBasis` used in the `CeedOperator`. 1386ca94c3ddSJeremy L Thompson An array with references to the corresponding active `CeedElemRestriction` is also stored. 1387ca94c3ddSJeremy L Thompson For each active `CeedBasis, the `CeedOperatorAssemblyData` holds an array of all input and output @ref CeedEvalMode for this `CeedBasis`. 1388ca94c3ddSJeremy L Thompson The `CeedOperatorAssemblyData` holds an array of offsets for indexing into the assembled `CeedQFunction` arrays to the row representing each @ref CeedEvalMode. 1389ca94c3ddSJeremy L Thompson The number of input columns across all active bases for the assembled `CeedQFunction` is also stored. 1390ca94c3ddSJeremy L Thompson Lastly, the `CeedOperatorAssembly` data holds assembled matrices representing the full action of the `CeedBasis` for all @ref CeedEvalMode. 1391ed9e99e6SJeremy L Thompson 1392ca94c3ddSJeremy L Thompson @param[in] ceed `Ceed` object used to create the `CeedOperatorAssemblyData` 1393ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to be assembled 1394ca94c3ddSJeremy L Thompson @param[out] data Address of the variable where the newly created `CeedOperatorAssemblyData` will be stored 1395ed9e99e6SJeremy L Thompson 1396ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1397ed9e99e6SJeremy L Thompson 1398ed9e99e6SJeremy L Thompson @ref Backend 1399ed9e99e6SJeremy L Thompson **/ 14002b730f8bSJeremy L Thompson int CeedOperatorAssemblyDataCreate(Ceed ceed, CeedOperator op, CeedOperatorAssemblyData *data) { 1401506b1a0cSSebastian Grimberg CeedInt num_active_bases_in = 0, num_active_bases_out = 0, offset = 0; 1402506b1a0cSSebastian Grimberg CeedInt num_input_fields, *num_eval_modes_in = NULL, num_output_fields, *num_eval_modes_out = NULL; 14031c66c397SJeremy L Thompson CeedSize **eval_mode_offsets_in = NULL, **eval_mode_offsets_out = NULL; 14041c66c397SJeremy L Thompson CeedEvalMode **eval_modes_in = NULL, **eval_modes_out = NULL; 14051c66c397SJeremy L Thompson CeedQFunctionField *qf_fields; 14061c66c397SJeremy L Thompson CeedQFunction qf; 14071c66c397SJeremy L Thompson CeedOperatorField *op_fields; 140801f0e615SJames Wright bool is_composite; 140901f0e615SJames Wright 141001f0e615SJames Wright CeedCall(CeedOperatorIsComposite(op, &is_composite)); 141101f0e615SJames Wright CeedCheck(!is_composite, ceed, CEED_ERROR_INCOMPATIBLE, "Can only create CeedOperator assembly data for non-composite operators."); 1412437c7c90SJeremy L Thompson 1413437c7c90SJeremy L Thompson // Allocate 14142b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, data)); 1415ed9e99e6SJeremy L Thompson (*data)->ceed = ceed; 14162b730f8bSJeremy L Thompson CeedCall(CeedReference(ceed)); 1417ed9e99e6SJeremy L Thompson 1418ed9e99e6SJeremy L Thompson // Build OperatorAssembly data 14192b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetQFunction(op, &qf)); 1420ed9e99e6SJeremy L Thompson 1421ed9e99e6SJeremy L Thompson // Determine active input basis 1422004e4986SSebastian Grimberg CeedCall(CeedQFunctionGetFields(qf, &num_input_fields, &qf_fields, NULL, NULL)); 1423004e4986SSebastian Grimberg CeedCall(CeedOperatorGetFields(op, NULL, &op_fields, NULL, NULL)); 1424ed9e99e6SJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 1425ed9e99e6SJeremy L Thompson CeedVector vec; 14261c66c397SJeremy L Thompson 14272b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 1428ed9e99e6SJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 14297c1dbaffSSebastian Grimberg CeedInt index = -1, num_comp, q_comp; 14301c66c397SJeremy L Thompson CeedEvalMode eval_mode; 14311c66c397SJeremy L Thompson CeedBasis basis_in = NULL; 14321c66c397SJeremy L Thompson 14332b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_in)); 14342b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 1435352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumComponents(basis_in, &num_comp)); 1436352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(basis_in, eval_mode, &q_comp)); 1437506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_active_bases_in; i++) { 1438506b1a0cSSebastian Grimberg if ((*data)->active_bases_in[i] == basis_in) index = i; 1439437c7c90SJeremy L Thompson } 1440437c7c90SJeremy L Thompson if (index == -1) { 1441437c7c90SJeremy L Thompson CeedElemRestriction elem_rstr_in; 14421c66c397SJeremy L Thompson 1443506b1a0cSSebastian Grimberg index = num_active_bases_in; 1444506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_bases_in)); 1445506b1a0cSSebastian Grimberg (*data)->active_bases_in[num_active_bases_in] = NULL; 1446506b1a0cSSebastian Grimberg CeedCall(CeedBasisReferenceCopy(basis_in, &(*data)->active_bases_in[num_active_bases_in])); 1447506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->active_elem_rstrs_in)); 1448506b1a0cSSebastian Grimberg (*data)->active_elem_rstrs_in[num_active_bases_in] = NULL; 1449437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_in)); 1450506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_in, &(*data)->active_elem_rstrs_in[num_active_bases_in])); 1451*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_in)); 1452506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &num_eval_modes_in)); 1453437c7c90SJeremy L Thompson num_eval_modes_in[index] = 0; 1454506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_modes_in)); 1455437c7c90SJeremy L Thompson eval_modes_in[index] = NULL; 1456506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &eval_mode_offsets_in)); 1457437c7c90SJeremy L Thompson eval_mode_offsets_in[index] = NULL; 1458506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_in + 1, &(*data)->assembled_bases_in)); 1459437c7c90SJeremy L Thompson (*data)->assembled_bases_in[index] = NULL; 1460506b1a0cSSebastian Grimberg num_active_bases_in++; 1461437c7c90SJeremy L Thompson } 1462352a5e7cSSebastian Grimberg if (eval_mode != CEED_EVAL_WEIGHT) { 1463352a5e7cSSebastian Grimberg // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly 1464352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_modes_in[index])); 1465352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_in[index] + q_comp, &eval_mode_offsets_in[index])); 1466352a5e7cSSebastian Grimberg for (CeedInt d = 0; d < q_comp; d++) { 1467437c7c90SJeremy L Thompson eval_modes_in[index][num_eval_modes_in[index] + d] = eval_mode; 1468437c7c90SJeremy L Thompson eval_mode_offsets_in[index][num_eval_modes_in[index] + d] = offset; 1469352a5e7cSSebastian Grimberg offset += num_comp; 1470ed9e99e6SJeremy L Thompson } 1471352a5e7cSSebastian Grimberg num_eval_modes_in[index] += q_comp; 1472ed9e99e6SJeremy L Thompson } 1473*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_in)); 1474ed9e99e6SJeremy L Thompson } 1475*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 1476ed9e99e6SJeremy L Thompson } 1477ed9e99e6SJeremy L Thompson 1478ed9e99e6SJeremy L Thompson // Determine active output basis 14792b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, NULL, NULL, &num_output_fields, &qf_fields)); 14802b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, NULL, NULL, NULL, &op_fields)); 1481437c7c90SJeremy L Thompson offset = 0; 1482ed9e99e6SJeremy L Thompson for (CeedInt i = 0; i < num_output_fields; i++) { 1483ed9e99e6SJeremy L Thompson CeedVector vec; 14841c66c397SJeremy L Thompson 14852b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 1486ed9e99e6SJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 14877c1dbaffSSebastian Grimberg CeedInt index = -1, num_comp, q_comp; 14881c66c397SJeremy L Thompson CeedEvalMode eval_mode; 14891c66c397SJeremy L Thompson CeedBasis basis_out = NULL; 14901c66c397SJeremy L Thompson 1491437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis_out)); 14922b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 1493352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumComponents(basis_out, &num_comp)); 1494352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(basis_out, eval_mode, &q_comp)); 1495506b1a0cSSebastian Grimberg for (CeedInt i = 0; i < num_active_bases_out; i++) { 1496506b1a0cSSebastian Grimberg if ((*data)->active_bases_out[i] == basis_out) index = i; 1497437c7c90SJeremy L Thompson } 1498437c7c90SJeremy L Thompson if (index == -1) { 1499437c7c90SJeremy L Thompson CeedElemRestriction elem_rstr_out; 15001c66c397SJeremy L Thompson 1501506b1a0cSSebastian Grimberg index = num_active_bases_out; 1502506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_bases_out)); 1503506b1a0cSSebastian Grimberg (*data)->active_bases_out[num_active_bases_out] = NULL; 1504506b1a0cSSebastian Grimberg CeedCall(CeedBasisReferenceCopy(basis_out, &(*data)->active_bases_out[num_active_bases_out])); 1505506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->active_elem_rstrs_out)); 1506506b1a0cSSebastian Grimberg (*data)->active_elem_rstrs_out[num_active_bases_out] = NULL; 1507437c7c90SJeremy L Thompson CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &elem_rstr_out)); 1508506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionReferenceCopy(elem_rstr_out, &(*data)->active_elem_rstrs_out[num_active_bases_out])); 1509*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr_out)); 1510506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &num_eval_modes_out)); 1511437c7c90SJeremy L Thompson num_eval_modes_out[index] = 0; 1512506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_modes_out)); 1513437c7c90SJeremy L Thompson eval_modes_out[index] = NULL; 1514506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &eval_mode_offsets_out)); 1515437c7c90SJeremy L Thompson eval_mode_offsets_out[index] = NULL; 1516506b1a0cSSebastian Grimberg CeedCall(CeedRealloc(num_active_bases_out + 1, &(*data)->assembled_bases_out)); 1517437c7c90SJeremy L Thompson (*data)->assembled_bases_out[index] = NULL; 1518506b1a0cSSebastian Grimberg num_active_bases_out++; 1519437c7c90SJeremy L Thompson } 1520352a5e7cSSebastian Grimberg if (eval_mode != CEED_EVAL_WEIGHT) { 1521352a5e7cSSebastian Grimberg // q_comp = 1 if CEED_EVAL_NONE, CEED_EVAL_WEIGHT caught by QF Assembly 1522352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_modes_out[index])); 1523352a5e7cSSebastian Grimberg CeedCall(CeedRealloc(num_eval_modes_out[index] + q_comp, &eval_mode_offsets_out[index])); 1524352a5e7cSSebastian Grimberg for (CeedInt d = 0; d < q_comp; d++) { 1525437c7c90SJeremy L Thompson eval_modes_out[index][num_eval_modes_out[index] + d] = eval_mode; 1526437c7c90SJeremy L Thompson eval_mode_offsets_out[index][num_eval_modes_out[index] + d] = offset; 1527352a5e7cSSebastian Grimberg offset += num_comp; 1528ed9e99e6SJeremy L Thompson } 1529352a5e7cSSebastian Grimberg num_eval_modes_out[index] += q_comp; 1530ed9e99e6SJeremy L Thompson } 1531*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_out)); 1532ed9e99e6SJeremy L Thompson } 1533*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 1534ed9e99e6SJeremy L Thompson } 1535506b1a0cSSebastian Grimberg (*data)->num_active_bases_in = num_active_bases_in; 153627789c4aSJed Brown (*data)->num_eval_modes_in = num_eval_modes_in; 153727789c4aSJed Brown (*data)->eval_modes_in = eval_modes_in; 153827789c4aSJed Brown (*data)->eval_mode_offsets_in = eval_mode_offsets_in; 1539506b1a0cSSebastian Grimberg (*data)->num_active_bases_out = num_active_bases_out; 1540437c7c90SJeremy L Thompson (*data)->num_eval_modes_out = num_eval_modes_out; 1541437c7c90SJeremy L Thompson (*data)->eval_modes_out = eval_modes_out; 1542437c7c90SJeremy L Thompson (*data)->eval_mode_offsets_out = eval_mode_offsets_out; 1543506b1a0cSSebastian Grimberg (*data)->num_output_components = offset; 1544ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1545ed9e99e6SJeremy L Thompson } 1546ed9e99e6SJeremy L Thompson 1547ed9e99e6SJeremy L Thompson /** 1548ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` @ref CeedEvalMode for assembly. 1549ba746a46SJeremy L Thompson 1550ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1551ed9e99e6SJeremy L Thompson 1552ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1553506b1a0cSSebastian Grimberg @param[out] num_active_bases_in Total number of active bases for input 1554ca94c3ddSJeremy L Thompson @param[out] num_eval_modes_in Pointer to hold array of numbers of input @ref CeedEvalMode, or `NULL`. 1555ca94c3ddSJeremy L Thompson `eval_modes_in[0]` holds an array of eval modes for the first active `CeedBasis`. 1556ca94c3ddSJeremy L Thompson @param[out] eval_modes_in Pointer to hold arrays of input @ref CeedEvalMode, or `NULL` 1557ca94c3ddSJeremy L Thompson @param[out] eval_mode_offsets_in Pointer to hold arrays of input offsets at each quadrature point 1558506b1a0cSSebastian Grimberg @param[out] num_active_bases_out Total number of active bases for output 1559ca94c3ddSJeremy L Thompson @param[out] num_eval_modes_out Pointer to hold array of numbers of output @ref CeedEvalMode, or `NULL` 1560ca94c3ddSJeremy L Thompson @param[out] eval_modes_out Pointer to hold arrays of output @ref CeedEvalMode, or `NULL` 1561437c7c90SJeremy L Thompson @param[out] eval_mode_offsets_out Pointer to hold arrays of output offsets at each quadrature point 1562ca94c3ddSJeremy 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 1563ed9e99e6SJeremy L Thompson 1564ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1565ed9e99e6SJeremy L Thompson 1566ed9e99e6SJeremy L Thompson @ref Backend 1567ed9e99e6SJeremy L Thompson **/ 1568506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetEvalModes(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedInt **num_eval_modes_in, 1569506b1a0cSSebastian Grimberg const CeedEvalMode ***eval_modes_in, CeedSize ***eval_mode_offsets_in, CeedInt *num_active_bases_out, 1570506b1a0cSSebastian Grimberg CeedInt **num_eval_modes_out, const CeedEvalMode ***eval_modes_out, CeedSize ***eval_mode_offsets_out, 1571506b1a0cSSebastian Grimberg CeedSize *num_output_components) { 1572506b1a0cSSebastian Grimberg if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in; 1573437c7c90SJeremy L Thompson if (num_eval_modes_in) *num_eval_modes_in = data->num_eval_modes_in; 1574437c7c90SJeremy L Thompson if (eval_modes_in) *eval_modes_in = (const CeedEvalMode **)data->eval_modes_in; 1575437c7c90SJeremy L Thompson if (eval_mode_offsets_in) *eval_mode_offsets_in = data->eval_mode_offsets_in; 1576506b1a0cSSebastian Grimberg if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out; 1577437c7c90SJeremy L Thompson if (num_eval_modes_out) *num_eval_modes_out = data->num_eval_modes_out; 1578437c7c90SJeremy L Thompson if (eval_modes_out) *eval_modes_out = (const CeedEvalMode **)data->eval_modes_out; 1579437c7c90SJeremy L Thompson if (eval_mode_offsets_out) *eval_mode_offsets_out = data->eval_mode_offsets_out; 1580437c7c90SJeremy L Thompson if (num_output_components) *num_output_components = data->num_output_components; 1581ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1582ed9e99e6SJeremy L Thompson } 1583ed9e99e6SJeremy L Thompson 1584ed9e99e6SJeremy L Thompson /** 1585ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` `CeedBasis` data for assembly. 1586ba746a46SJeremy L Thompson 1587ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1588ed9e99e6SJeremy L Thompson 1589ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1590ca94c3ddSJeremy L Thompson @param[out] num_active_bases_in Number of active input bases, or `NULL` 1591ca94c3ddSJeremy L Thompson @param[out] active_bases_in Pointer to hold active input `CeedBasis`, or `NULL` 1592ca94c3ddSJeremy L Thompson @param[out] assembled_bases_in Pointer to hold assembled active input `B` , or `NULL` 1593ca94c3ddSJeremy L Thompson @param[out] num_active_bases_out Number of active output bases, or `NULL` 1594ca94c3ddSJeremy L Thompson @param[out] active_bases_out Pointer to hold active output `CeedBasis`, or `NULL` 1595ca94c3ddSJeremy L Thompson @param[out] assembled_bases_out Pointer to hold assembled active output `B` , or `NULL` 1596ed9e99e6SJeremy L Thompson 1597ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1598ed9e99e6SJeremy L Thompson 1599ed9e99e6SJeremy L Thompson @ref Backend 1600ed9e99e6SJeremy L Thompson **/ 1601506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetBases(CeedOperatorAssemblyData data, CeedInt *num_active_bases_in, CeedBasis **active_bases_in, 1602506b1a0cSSebastian Grimberg const CeedScalar ***assembled_bases_in, CeedInt *num_active_bases_out, CeedBasis **active_bases_out, 1603506b1a0cSSebastian Grimberg const CeedScalar ***assembled_bases_out) { 1604ed9e99e6SJeremy L Thompson // Assemble B_in, B_out if needed 1605437c7c90SJeremy L Thompson if (assembled_bases_in && !data->assembled_bases_in[0]) { 1606437c7c90SJeremy L Thompson CeedInt num_qpts; 1607437c7c90SJeremy L Thompson 1608506b1a0cSSebastian Grimberg if (data->active_bases_in[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[0], &num_qpts)); 1609506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_in[0], &num_qpts)); 1610506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < data->num_active_bases_in; b++) { 16111c66c397SJeremy L Thompson bool has_eval_none = false; 1612352a5e7cSSebastian Grimberg CeedInt num_nodes; 1613437c7c90SJeremy L Thompson CeedScalar *B_in = NULL, *identity = NULL; 1614ed9e99e6SJeremy L Thompson 1615506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_in[b], &num_nodes)); 1616352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_in[b], &B_in)); 1617ed9e99e6SJeremy L Thompson 1618437c7c90SJeremy L Thompson for (CeedInt i = 0; i < data->num_eval_modes_in[b]; i++) { 1619437c7c90SJeremy L Thompson has_eval_none = has_eval_none || (data->eval_modes_in[b][i] == CEED_EVAL_NONE); 1620ed9e99e6SJeremy L Thompson } 1621ed9e99e6SJeremy L Thompson if (has_eval_none) { 1622352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 1623352a5e7cSSebastian Grimberg for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) { 1624352a5e7cSSebastian Grimberg identity[i * num_nodes + i] = 1.0; 1625ed9e99e6SJeremy L Thompson } 1626ed9e99e6SJeremy L Thompson } 1627ed9e99e6SJeremy L Thompson 1628ed9e99e6SJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 1629352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 1630352a5e7cSSebastian Grimberg CeedInt d_in = 0, q_comp_in; 1631352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_in_prev = CEED_EVAL_NONE; 16321c66c397SJeremy L Thompson 1633437c7c90SJeremy L Thompson for (CeedInt e_in = 0; e_in < data->num_eval_modes_in[b]; e_in++) { 1634437c7c90SJeremy L Thompson const CeedInt qq = data->num_eval_modes_in[b] * q; 1635437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 16361c66c397SJeremy L Thompson 1637506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(data->active_bases_in[b], data->eval_modes_in[b][e_in], identity, &B)); 1638506b1a0cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_in[b], data->eval_modes_in[b][e_in], &q_comp_in)); 1639352a5e7cSSebastian Grimberg if (q_comp_in > 1) { 1640352a5e7cSSebastian Grimberg if (e_in == 0 || data->eval_modes_in[b][e_in] != eval_mode_in_prev) d_in = 0; 1641352a5e7cSSebastian Grimberg else B = &B[(++d_in) * num_qpts * num_nodes]; 1642352a5e7cSSebastian Grimberg } 1643352a5e7cSSebastian Grimberg eval_mode_in_prev = data->eval_modes_in[b][e_in]; 1644352a5e7cSSebastian Grimberg B_in[(qq + e_in) * num_nodes + n] = B[q * num_nodes + n]; 1645ed9e99e6SJeremy L Thompson } 1646ed9e99e6SJeremy L Thompson } 1647ed9e99e6SJeremy L Thompson } 16487c1dbaffSSebastian Grimberg if (identity) CeedCall(CeedFree(&identity)); 1649437c7c90SJeremy L Thompson data->assembled_bases_in[b] = B_in; 1650437c7c90SJeremy L Thompson } 1651ed9e99e6SJeremy L Thompson } 1652ed9e99e6SJeremy L Thompson 1653437c7c90SJeremy L Thompson if (assembled_bases_out && !data->assembled_bases_out[0]) { 1654437c7c90SJeremy L Thompson CeedInt num_qpts; 1655437c7c90SJeremy L Thompson 1656506b1a0cSSebastian Grimberg if (data->active_bases_out[0] == CEED_BASIS_NONE) CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[0], &num_qpts)); 1657506b1a0cSSebastian Grimberg else CeedCall(CeedBasisGetNumQuadraturePoints(data->active_bases_out[0], &num_qpts)); 1658506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < data->num_active_bases_out; b++) { 1659ed9e99e6SJeremy L Thompson bool has_eval_none = false; 16601c66c397SJeremy L Thompson CeedInt num_nodes; 1661437c7c90SJeremy L Thompson CeedScalar *B_out = NULL, *identity = NULL; 1662ed9e99e6SJeremy L Thompson 1663506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetElementSize(data->active_elem_rstrs_out[b], &num_nodes)); 1664352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes * data->num_eval_modes_out[b], &B_out)); 1665ed9e99e6SJeremy L Thompson 1666437c7c90SJeremy L Thompson for (CeedInt i = 0; i < data->num_eval_modes_out[b]; i++) { 1667437c7c90SJeremy L Thompson has_eval_none = has_eval_none || (data->eval_modes_out[b][i] == CEED_EVAL_NONE); 1668ed9e99e6SJeremy L Thompson } 1669ed9e99e6SJeremy L Thompson if (has_eval_none) { 1670352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_qpts * num_nodes, &identity)); 1671352a5e7cSSebastian Grimberg for (CeedInt i = 0; i < (num_nodes < num_qpts ? num_nodes : num_qpts); i++) { 1672352a5e7cSSebastian Grimberg identity[i * num_nodes + i] = 1.0; 1673ed9e99e6SJeremy L Thompson } 1674ed9e99e6SJeremy L Thompson } 1675ed9e99e6SJeremy L Thompson 1676ed9e99e6SJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 1677352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 1678352a5e7cSSebastian Grimberg CeedInt d_out = 0, q_comp_out; 1679352a5e7cSSebastian Grimberg CeedEvalMode eval_mode_out_prev = CEED_EVAL_NONE; 16801c66c397SJeremy L Thompson 1681437c7c90SJeremy L Thompson for (CeedInt e_out = 0; e_out < data->num_eval_modes_out[b]; e_out++) { 1682437c7c90SJeremy L Thompson const CeedInt qq = data->num_eval_modes_out[b] * q; 1683437c7c90SJeremy L Thompson const CeedScalar *B = NULL; 16841c66c397SJeremy L Thompson 1685506b1a0cSSebastian Grimberg CeedCall(CeedOperatorGetBasisPointer(data->active_bases_out[b], data->eval_modes_out[b][e_out], identity, &B)); 1686506b1a0cSSebastian Grimberg CeedCall(CeedBasisGetNumQuadratureComponents(data->active_bases_out[b], data->eval_modes_out[b][e_out], &q_comp_out)); 1687352a5e7cSSebastian Grimberg if (q_comp_out > 1) { 1688352a5e7cSSebastian Grimberg if (e_out == 0 || data->eval_modes_out[b][e_out] != eval_mode_out_prev) d_out = 0; 1689352a5e7cSSebastian Grimberg else B = &B[(++d_out) * num_qpts * num_nodes]; 1690352a5e7cSSebastian Grimberg } 1691352a5e7cSSebastian Grimberg eval_mode_out_prev = data->eval_modes_out[b][e_out]; 1692352a5e7cSSebastian Grimberg B_out[(qq + e_out) * num_nodes + n] = B[q * num_nodes + n]; 1693ed9e99e6SJeremy L Thompson } 1694ed9e99e6SJeremy L Thompson } 1695ed9e99e6SJeremy L Thompson } 16967c1dbaffSSebastian Grimberg if (identity) CeedCall(CeedFree(&identity)); 1697437c7c90SJeremy L Thompson data->assembled_bases_out[b] = B_out; 1698437c7c90SJeremy L Thompson } 1699ed9e99e6SJeremy L Thompson } 1700ed9e99e6SJeremy L Thompson 1701437c7c90SJeremy L Thompson // Pass out assembled data 1702506b1a0cSSebastian Grimberg if (num_active_bases_in) *num_active_bases_in = data->num_active_bases_in; 1703506b1a0cSSebastian Grimberg if (active_bases_in) *active_bases_in = data->active_bases_in; 1704437c7c90SJeremy L Thompson if (assembled_bases_in) *assembled_bases_in = (const CeedScalar **)data->assembled_bases_in; 1705506b1a0cSSebastian Grimberg if (num_active_bases_out) *num_active_bases_out = data->num_active_bases_out; 1706506b1a0cSSebastian Grimberg if (active_bases_out) *active_bases_out = data->active_bases_out; 1707437c7c90SJeremy L Thompson if (assembled_bases_out) *assembled_bases_out = (const CeedScalar **)data->assembled_bases_out; 1708437c7c90SJeremy L Thompson return CEED_ERROR_SUCCESS; 1709437c7c90SJeremy L Thompson } 1710437c7c90SJeremy L Thompson 1711437c7c90SJeremy L Thompson /** 1712ca94c3ddSJeremy L Thompson @brief Get `CeedOperator` `CeedBasis` data for assembly. 1713ba746a46SJeremy L Thompson 1714ca94c3ddSJeremy L Thompson Note: See @ref CeedOperatorAssemblyDataCreate() for a full description of the data stored in this object. 1715437c7c90SJeremy L Thompson 1716ca94c3ddSJeremy L Thompson @param[in] data `CeedOperatorAssemblyData` 1717ca94c3ddSJeremy L Thompson @param[out] num_active_elem_rstrs_in Number of active input element restrictions, or `NULL` 1718ca94c3ddSJeremy L Thompson @param[out] active_elem_rstrs_in Pointer to hold active input `CeedElemRestriction`, or `NULL` 1719ca94c3ddSJeremy L Thompson @param[out] num_active_elem_rstrs_out Number of active output element restrictions, or `NULL` 1720ca94c3ddSJeremy L Thompson @param[out] active_elem_rstrs_out Pointer to hold active output `CeedElemRestriction`, or `NULL` 1721437c7c90SJeremy L Thompson 1722437c7c90SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1723437c7c90SJeremy L Thompson 1724437c7c90SJeremy L Thompson @ref Backend 1725437c7c90SJeremy L Thompson **/ 1726506b1a0cSSebastian Grimberg int CeedOperatorAssemblyDataGetElemRestrictions(CeedOperatorAssemblyData data, CeedInt *num_active_elem_rstrs_in, 1727506b1a0cSSebastian Grimberg CeedElemRestriction **active_elem_rstrs_in, CeedInt *num_active_elem_rstrs_out, 1728506b1a0cSSebastian Grimberg CeedElemRestriction **active_elem_rstrs_out) { 1729506b1a0cSSebastian Grimberg if (num_active_elem_rstrs_in) *num_active_elem_rstrs_in = data->num_active_bases_in; 1730506b1a0cSSebastian Grimberg if (active_elem_rstrs_in) *active_elem_rstrs_in = data->active_elem_rstrs_in; 1731506b1a0cSSebastian Grimberg if (num_active_elem_rstrs_out) *num_active_elem_rstrs_out = data->num_active_bases_out; 1732506b1a0cSSebastian Grimberg if (active_elem_rstrs_out) *active_elem_rstrs_out = data->active_elem_rstrs_out; 1733ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1734ed9e99e6SJeremy L Thompson } 1735ed9e99e6SJeremy L Thompson 1736ed9e99e6SJeremy L Thompson /** 1737ca94c3ddSJeremy L Thompson @brief Destroy `CeedOperatorAssemblyData` 1738ed9e99e6SJeremy L Thompson 1739ca94c3ddSJeremy L Thompson @param[in,out] data `CeedOperatorAssemblyData` to destroy 1740ed9e99e6SJeremy L Thompson 1741ed9e99e6SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1742ed9e99e6SJeremy L Thompson 1743ed9e99e6SJeremy L Thompson @ref Backend 1744ed9e99e6SJeremy L Thompson **/ 1745ed9e99e6SJeremy L Thompson int CeedOperatorAssemblyDataDestroy(CeedOperatorAssemblyData *data) { 1746ad6481ceSJeremy L Thompson if (!*data) { 1747ad6481ceSJeremy L Thompson *data = NULL; 1748ad6481ceSJeremy L Thompson return CEED_ERROR_SUCCESS; 1749ad6481ceSJeremy L Thompson } 17502b730f8bSJeremy L Thompson CeedCall(CeedDestroy(&(*data)->ceed)); 1751506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < (*data)->num_active_bases_in; b++) { 1752506b1a0cSSebastian Grimberg CeedCall(CeedBasisDestroy(&(*data)->active_bases_in[b])); 1753506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_in[b])); 1754437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_in[b])); 1755437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_in[b])); 1756437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_in[b])); 1757506b1a0cSSebastian Grimberg } 1758506b1a0cSSebastian Grimberg for (CeedInt b = 0; b < (*data)->num_active_bases_out; b++) { 1759506b1a0cSSebastian Grimberg CeedCall(CeedBasisDestroy(&(*data)->active_bases_out[b])); 1760506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&(*data)->active_elem_rstrs_out[b])); 1761506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->eval_modes_out[b])); 1762506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->eval_mode_offsets_out[b])); 1763437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_out[b])); 1764437c7c90SJeremy L Thompson } 1765506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_bases_in)); 1766506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_bases_out)); 1767506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_elem_rstrs_in)); 1768506b1a0cSSebastian Grimberg CeedCall(CeedFree(&(*data)->active_elem_rstrs_out)); 1769437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->num_eval_modes_in)); 1770437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->num_eval_modes_out)); 1771437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_in)); 1772437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_modes_out)); 1773437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_in)); 1774437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->eval_mode_offsets_out)); 1775437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_in)); 1776437c7c90SJeremy L Thompson CeedCall(CeedFree(&(*data)->assembled_bases_out)); 1777ed9e99e6SJeremy L Thompson 17782b730f8bSJeremy L Thompson CeedCall(CeedFree(data)); 1779ed9e99e6SJeremy L Thompson return CEED_ERROR_SUCCESS; 1780ed9e99e6SJeremy L Thompson } 1781ed9e99e6SJeremy L Thompson 17824dd1a9d2SSebastian Grimberg /** 1783ca94c3ddSJeremy L Thompson @brief Retrieve fallback `CeedOperator` with a reference `Ceed` for advanced `CeedOperator` functionality 17844dd1a9d2SSebastian Grimberg 1785ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to retrieve fallback for 1786ca94c3ddSJeremy L Thompson @param[out] op_fallback Fallback `CeedOperator` 17874dd1a9d2SSebastian Grimberg 17884dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 17894dd1a9d2SSebastian Grimberg 17904dd1a9d2SSebastian Grimberg @ref Backend 17914dd1a9d2SSebastian Grimberg **/ 17924dd1a9d2SSebastian Grimberg int CeedOperatorGetFallback(CeedOperator op, CeedOperator *op_fallback) { 17934dd1a9d2SSebastian Grimberg // Create if needed 17944dd1a9d2SSebastian Grimberg if (!op->op_fallback) CeedCall(CeedOperatorCreateFallback(op)); 17954dd1a9d2SSebastian Grimberg if (op->op_fallback) { 17964dd1a9d2SSebastian Grimberg bool is_debug; 17971203703bSJeremy L Thompson Ceed ceed; 17984dd1a9d2SSebastian Grimberg 17994dd1a9d2SSebastian Grimberg CeedCall(CeedOperatorGetCeed(op, &ceed)); 18001203703bSJeremy L Thompson CeedCall(CeedIsDebug(ceed, &is_debug)); 18011203703bSJeremy L Thompson if (is_debug) { 18021203703bSJeremy L Thompson Ceed ceed_fallback; 18031203703bSJeremy L Thompson const char *resource, *resource_fallback; 18041203703bSJeremy L Thompson 18054dd1a9d2SSebastian Grimberg CeedCall(CeedGetOperatorFallbackCeed(ceed, &ceed_fallback)); 18064dd1a9d2SSebastian Grimberg CeedCall(CeedGetResource(ceed, &resource)); 18074dd1a9d2SSebastian Grimberg CeedCall(CeedGetResource(ceed_fallback, &resource_fallback)); 18084dd1a9d2SSebastian Grimberg 18094dd1a9d2SSebastian Grimberg CeedDebug256(ceed, CEED_DEBUG_COLOR_SUCCESS, "---------- CeedOperator Fallback ----------\n"); 1810249f8407SJeremy 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); 18114dd1a9d2SSebastian Grimberg } 18124dd1a9d2SSebastian Grimberg } 18134dd1a9d2SSebastian Grimberg *op_fallback = op->op_fallback; 18144dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18154dd1a9d2SSebastian Grimberg } 18164dd1a9d2SSebastian Grimberg 18174dd1a9d2SSebastian Grimberg /** 1818ca94c3ddSJeremy L Thompson @brief Get the parent `CeedOperator` for a fallback `CeedOperator` 18194dd1a9d2SSebastian Grimberg 1820ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` context 1821ca94c3ddSJeremy L Thompson @param[out] parent Variable to store parent `CeedOperator` context 18224dd1a9d2SSebastian Grimberg 18234dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 18244dd1a9d2SSebastian Grimberg 18254dd1a9d2SSebastian Grimberg @ref Backend 18264dd1a9d2SSebastian Grimberg **/ 18274dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParent(CeedOperator op, CeedOperator *parent) { 18284dd1a9d2SSebastian Grimberg *parent = op->op_fallback_parent ? op->op_fallback_parent : NULL; 18294dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18304dd1a9d2SSebastian Grimberg } 18314dd1a9d2SSebastian Grimberg 18324dd1a9d2SSebastian Grimberg /** 1833ca94c3ddSJeremy L Thompson @brief Get the `Ceed` context of the parent `CeedOperator` for a fallback `CeedOperator` 18344dd1a9d2SSebastian Grimberg 1835ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` context 1836ca94c3ddSJeremy L Thompson @param[out] parent Variable to store parent `Ceed` context 18374dd1a9d2SSebastian Grimberg 18384dd1a9d2SSebastian Grimberg @return An error code: 0 - success, otherwise - failure 18394dd1a9d2SSebastian Grimberg 18404dd1a9d2SSebastian Grimberg @ref Backend 18414dd1a9d2SSebastian Grimberg **/ 18424dd1a9d2SSebastian Grimberg int CeedOperatorGetFallbackParentCeed(CeedOperator op, Ceed *parent) { 18434dd1a9d2SSebastian Grimberg *parent = op->op_fallback_parent ? op->op_fallback_parent->ceed : op->ceed; 18444dd1a9d2SSebastian Grimberg return CEED_ERROR_SUCCESS; 18454dd1a9d2SSebastian Grimberg } 18464dd1a9d2SSebastian Grimberg 1847480fae85SJeremy L Thompson /// @} 1848480fae85SJeremy L Thompson 1849480fae85SJeremy L Thompson /// ---------------------------------------------------------------------------- 1850eaf62fffSJeremy L Thompson /// CeedOperator Public API 1851eaf62fffSJeremy L Thompson /// ---------------------------------------------------------------------------- 1852eaf62fffSJeremy L Thompson /// @addtogroup CeedOperatorUser 1853eaf62fffSJeremy L Thompson /// @{ 1854eaf62fffSJeremy L Thompson 1855eaf62fffSJeremy L Thompson /** 1856ca94c3ddSJeremy L Thompson @brief Assemble a linear `CeedQFunction` associated with a `CeedOperator`. 1857eaf62fffSJeremy L Thompson 1858ca94c3ddSJeremy L Thompson This returns a `CeedVector` containing a matrix at each quadrature point providing the action of the `CeedQFunction` associated with the `CeedOperator`. 1859ca94c3ddSJeremy 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. 1860859c15bbSJames Wright 1861ca94c3ddSJeremy L Thompson Inputs and outputs are in the order provided by the user when adding `CeedOperator` fields. 1862ca94c3ddSJeremy 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]`. 1863eaf62fffSJeremy L Thompson 1864ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 1865f04ea552SJeremy L Thompson 1866ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1867ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points 1868ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1869ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 1870eaf62fffSJeremy L Thompson 1871eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1872eaf62fffSJeremy L Thompson 1873eaf62fffSJeremy L Thompson @ref User 1874eaf62fffSJeremy L Thompson **/ 18752b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunction(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) { 18762b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 1877eaf62fffSJeremy L Thompson 1878eaf62fffSJeremy L Thompson if (op->LinearAssembleQFunction) { 1879d04bbc78SJeremy L Thompson // Backend version 18802b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleQFunction(op, assembled, rstr, request)); 1881eaf62fffSJeremy L Thompson } else { 1882d04bbc78SJeremy L Thompson // Operator fallback 18831203703bSJeremy L Thompson Ceed ceed; 1884d04bbc78SJeremy L Thompson CeedOperator op_fallback; 1885d04bbc78SJeremy L Thompson 18861203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 18872b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 18886574a04fSJeremy L Thompson if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunction(op_fallback, assembled, rstr, request)); 18891203703bSJeremy L Thompson else return CeedError(ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunction"); 189070a7ffb3SJeremy L Thompson } 1891eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 1892eaf62fffSJeremy L Thompson } 189370a7ffb3SJeremy L Thompson 189470a7ffb3SJeremy L Thompson /** 1895ca94c3ddSJeremy L Thompson @brief Assemble `CeedQFunction` and store result internally. 18964385fb7fSSebastian Grimberg 1897ea61e9acSJeremy L Thompson Return copied references of stored data to the caller. 1898ea61e9acSJeremy L Thompson Caller is responsible for ownership and destruction of the copied references. 1899ca94c3ddSJeremy L Thompson See also @ref CeedOperatorLinearAssembleQFunction(). 190070a7ffb3SJeremy L Thompson 1901ca94c3ddSJeremy 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. 1902c5f45aeaSJeremy L Thompson These objects will be destroyed if `*assembled` or `*rstr` is the only reference to the object. 1903c5f45aeaSJeremy L Thompson 1904ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1905ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedQFunction` at quadrature points 1906ca94c3ddSJeremy L Thompson @param[out] rstr `CeedElemRestriction` for `CeedVector` containing assembled `CeedQFunction` 1907ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 190870a7ffb3SJeremy L Thompson 190970a7ffb3SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 191070a7ffb3SJeremy L Thompson 191170a7ffb3SJeremy L Thompson @ref User 191270a7ffb3SJeremy L Thompson **/ 19132b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleQFunctionBuildOrUpdate(CeedOperator op, CeedVector *assembled, CeedElemRestriction *rstr, CeedRequest *request) { 1914b05f7e9fSJeremy L Thompson int (*LinearAssembleQFunctionUpdate)(CeedOperator, CeedVector, CeedElemRestriction, CeedRequest *) = NULL; 1915b05f7e9fSJeremy L Thompson CeedOperator op_assemble = NULL; 1916bb229da9SJeremy L Thompson CeedOperator op_fallback_parent = NULL; 1917b05f7e9fSJeremy L Thompson 19182b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 191970a7ffb3SJeremy L Thompson 1920b05f7e9fSJeremy L Thompson // Determine if fallback parent or operator has implementation 1921bb229da9SJeremy L Thompson CeedCall(CeedOperatorGetFallbackParent(op, &op_fallback_parent)); 1922bb229da9SJeremy L Thompson if (op_fallback_parent && op_fallback_parent->LinearAssembleQFunctionUpdate) { 1923b05f7e9fSJeremy L Thompson // -- Backend version for op fallback parent is faster, if it exists 1924bb229da9SJeremy L Thompson LinearAssembleQFunctionUpdate = op_fallback_parent->LinearAssembleQFunctionUpdate; 1925bb229da9SJeremy L Thompson op_assemble = op_fallback_parent; 1926b05f7e9fSJeremy L Thompson } else if (op->LinearAssembleQFunctionUpdate) { 1927b05f7e9fSJeremy L Thompson // -- Backend version for op 1928b05f7e9fSJeremy L Thompson LinearAssembleQFunctionUpdate = op->LinearAssembleQFunctionUpdate; 1929b05f7e9fSJeremy L Thompson op_assemble = op; 1930b05f7e9fSJeremy L Thompson } 1931b05f7e9fSJeremy L Thompson 1932b05f7e9fSJeremy L Thompson // Assemble QFunction 1933b05f7e9fSJeremy L Thompson if (LinearAssembleQFunctionUpdate) { 1934b05f7e9fSJeremy L Thompson // Backend or fallback parent version 19357d5185d7SSebastian Grimberg CeedQFunctionAssemblyData data; 19367d5185d7SSebastian Grimberg bool data_is_setup; 19372efa2d85SJeremy L Thompson CeedVector assembled_vec = NULL; 19382efa2d85SJeremy L Thompson CeedElemRestriction assembled_rstr = NULL; 1939480fae85SJeremy L Thompson 19407d5185d7SSebastian Grimberg CeedCall(CeedOperatorGetQFunctionAssemblyData(op, &data)); 19417d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataIsSetup(data, &data_is_setup)); 19427d5185d7SSebastian Grimberg if (data_is_setup) { 1943d04bbc78SJeremy L Thompson bool update_needed; 1944d04bbc78SJeremy L Thompson 19457d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataGetObjects(data, &assembled_vec, &assembled_rstr)); 19467d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataIsUpdateNeeded(data, &update_needed)); 1947b05f7e9fSJeremy L Thompson if (update_needed) CeedCall(LinearAssembleQFunctionUpdate(op_assemble, assembled_vec, assembled_rstr, request)); 194870a7ffb3SJeremy L Thompson } else { 1949b05f7e9fSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunction(op_assemble, &assembled_vec, &assembled_rstr, request)); 19507d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataSetObjects(data, assembled_vec, assembled_rstr)); 195170a7ffb3SJeremy L Thompson } 19527d5185d7SSebastian Grimberg CeedCall(CeedQFunctionAssemblyDataSetUpdateNeeded(data, false)); 19532efa2d85SJeremy L Thompson 1954d04bbc78SJeremy L Thompson // Copy reference from internally held copy 19552b730f8bSJeremy L Thompson CeedCall(CeedVectorReferenceCopy(assembled_vec, assembled)); 19562b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionReferenceCopy(assembled_rstr, rstr)); 1957c5f45aeaSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled_vec)); 19582b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&assembled_rstr)); 195970a7ffb3SJeremy L Thompson } else { 1960d04bbc78SJeremy L Thompson // Operator fallback 19611203703bSJeremy L Thompson Ceed ceed; 1962d04bbc78SJeremy L Thompson CeedOperator op_fallback; 1963d04bbc78SJeremy L Thompson 19641203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 19652b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 19666574a04fSJeremy L Thompson if (op_fallback) CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op_fallback, assembled, rstr, request)); 19671203703bSJeremy L Thompson else return CeedError(ceed, CEED_ERROR_UNSUPPORTED, "Backend does not support CeedOperatorLinearAssembleQFunctionUpdate"); 196870a7ffb3SJeremy L Thompson } 196970a7ffb3SJeremy L Thompson return CEED_ERROR_SUCCESS; 1970eaf62fffSJeremy L Thompson } 1971eaf62fffSJeremy L Thompson 1972eaf62fffSJeremy L Thompson /** 1973ca94c3ddSJeremy L Thompson @brief Assemble the diagonal of a square linear `CeedOperator` 1974eaf62fffSJeremy L Thompson 1975ca94c3ddSJeremy L Thompson This overwrites a `CeedVector` with the diagonal of a linear `CeedOperator`. 1976eaf62fffSJeremy L Thompson 1977ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 1978eaf62fffSJeremy L Thompson 1979ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 1980f04ea552SJeremy L Thompson 1981ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 1982ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal 1983ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 1984eaf62fffSJeremy L Thompson 1985eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 1986eaf62fffSJeremy L Thompson 1987eaf62fffSJeremy L Thompson @ref User 1988eaf62fffSJeremy L Thompson **/ 19892b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 1990f3d47e36SJeremy L Thompson bool is_composite; 19911c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 19921203703bSJeremy L Thompson Ceed ceed; 19931c66c397SJeremy L Thompson 19941203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 19952b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 1996f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 1997eaf62fffSJeremy L Thompson 19982b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 19991203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2000c9366a6bSJeremy L Thompson 2001f3d47e36SJeremy L Thompson // Early exit for empty operator 2002f3d47e36SJeremy L Thompson if (!is_composite) { 2003f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2004f3d47e36SJeremy L Thompson 2005f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2006f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2007f3d47e36SJeremy L Thompson } 2008f3d47e36SJeremy L Thompson 2009eaf62fffSJeremy L Thompson if (op->LinearAssembleDiagonal) { 2010d04bbc78SJeremy L Thompson // Backend version 20112b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleDiagonal(op, assembled, request)); 2012eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2013eaf62fffSJeremy L Thompson } else if (op->LinearAssembleAddDiagonal) { 2014d04bbc78SJeremy L Thompson // Backend version with zeroing first 20152b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 20162b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request)); 2017eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2018eaf62fffSJeremy L Thompson } else { 2019d04bbc78SJeremy L Thompson // Operator fallback 2020d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2021d04bbc78SJeremy L Thompson 20222b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2023d04bbc78SJeremy L Thompson if (op_fallback) { 20242b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleDiagonal(op_fallback, assembled, request)); 2025eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2026eaf62fffSJeremy L Thompson } 2027eaf62fffSJeremy L Thompson } 2028eaf62fffSJeremy L Thompson // Default interface implementation 20292b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 20302b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(op, assembled, request)); 2031eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2032eaf62fffSJeremy L Thompson } 2033eaf62fffSJeremy L Thompson 2034eaf62fffSJeremy L Thompson /** 2035ca94c3ddSJeremy L Thompson @brief Assemble the diagonal of a square linear `CeedOperator`. 2036eaf62fffSJeremy L Thompson 2037ca94c3ddSJeremy L Thompson This sums into a `CeedVector` the diagonal of a linear `CeedOperator`. 2038eaf62fffSJeremy L Thompson 2039ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2040eaf62fffSJeremy L Thompson 2041ea61e9acSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the CeedOperator as immutable. 2042f04ea552SJeremy L Thompson 2043ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2044ca94c3ddSJeremy L Thompson @param[out] assembled `CeedVector` to store assembled `CeedOperator` diagonal 2045ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2046eaf62fffSJeremy L Thompson 2047eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2048eaf62fffSJeremy L Thompson 2049eaf62fffSJeremy L Thompson @ref User 2050eaf62fffSJeremy L Thompson **/ 20512b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2052f3d47e36SJeremy L Thompson bool is_composite; 20531c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 20541203703bSJeremy L Thompson Ceed ceed; 20551c66c397SJeremy L Thompson 20561203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 20572b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2058f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2059eaf62fffSJeremy L Thompson 20602b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 20611203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2062c9366a6bSJeremy L Thompson 2063f3d47e36SJeremy L Thompson // Early exit for empty operator 2064f3d47e36SJeremy L Thompson if (!is_composite) { 2065f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2066f3d47e36SJeremy L Thompson 2067f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2068f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2069f3d47e36SJeremy L Thompson } 2070f3d47e36SJeremy L Thompson 2071eaf62fffSJeremy L Thompson if (op->LinearAssembleAddDiagonal) { 2072d04bbc78SJeremy L Thompson // Backend version 20732b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddDiagonal(op, assembled, request)); 2074eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2075eaf62fffSJeremy L Thompson } else { 2076d04bbc78SJeremy L Thompson // Operator fallback 2077d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2078d04bbc78SJeremy L Thompson 20792b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2080d04bbc78SJeremy L Thompson if (op_fallback) { 20812b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddDiagonal(op_fallback, assembled, request)); 2082eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2083eaf62fffSJeremy L Thompson } 2084eaf62fffSJeremy L Thompson } 2085eaf62fffSJeremy L Thompson // Default interface implementation 2086eaf62fffSJeremy L Thompson if (is_composite) { 20872b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, false, assembled)); 2088eaf62fffSJeremy L Thompson } else { 2089f3bd9308SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal(op, request, false, assembled)); 2090eaf62fffSJeremy L Thompson } 2091d04bbc78SJeremy L Thompson return CEED_ERROR_SUCCESS; 2092eaf62fffSJeremy L Thompson } 2093eaf62fffSJeremy L Thompson 2094eaf62fffSJeremy L Thompson /** 2095ca94c3ddSJeremy L Thompson @brief Fully assemble the point-block diagonal pattern of a linear `CeedOperator`. 209601f0e615SJames Wright 2097ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssemblePointBlockDiagonal(). 209801f0e615SJames Wright 2099ca94c3ddSJeremy 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)`. 2100ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are unique. 2101ca94c3ddSJeremy L Thompson This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemblePointBlockDiagonal() provides the values in the same ordering. 210201f0e615SJames Wright 210301f0e615SJames Wright This will generally be slow unless your operator is low-order. 210401f0e615SJames Wright 2105ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 210601f0e615SJames Wright 2107ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 210801f0e615SJames Wright @param[out] num_entries Number of entries in coordinate nonzero pattern 210901f0e615SJames Wright @param[out] rows Row number for each entry 211001f0e615SJames Wright @param[out] cols Column number for each entry 211101f0e615SJames Wright 211201f0e615SJames Wright @ref User 211301f0e615SJames Wright **/ 211401f0e615SJames Wright int CeedOperatorLinearAssemblePointBlockDiagonalSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) { 211501f0e615SJames Wright Ceed ceed; 211601f0e615SJames Wright bool is_composite; 211701f0e615SJames Wright CeedInt num_active_components, num_sub_operators; 211801f0e615SJames Wright CeedOperator *sub_operators; 211901f0e615SJames Wright 212001f0e615SJames Wright CeedCall(CeedOperatorGetCeed(op, &ceed)); 212101f0e615SJames Wright CeedCall(CeedOperatorIsComposite(op, &is_composite)); 212201f0e615SJames Wright 212301f0e615SJames Wright CeedSize input_size = 0, output_size = 0; 212401f0e615SJames Wright CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 212501f0e615SJames Wright CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 212601f0e615SJames Wright 212701f0e615SJames Wright if (is_composite) { 212801f0e615SJames Wright CeedCall(CeedCompositeOperatorGetNumSub(op, &num_sub_operators)); 212901f0e615SJames Wright CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 213001f0e615SJames Wright } else { 213101f0e615SJames Wright sub_operators = &op; 213201f0e615SJames Wright num_sub_operators = 1; 213301f0e615SJames Wright } 213401f0e615SJames Wright 2135506b1a0cSSebastian Grimberg // Verify operator can be assembled correctly 2136506b1a0cSSebastian Grimberg { 213701f0e615SJames Wright CeedOperatorAssemblyData data; 2138506b1a0cSSebastian Grimberg CeedInt num_active_elem_rstrs, comp_stride; 213901f0e615SJames Wright CeedElemRestriction *active_elem_rstrs; 214001f0e615SJames Wright 214101f0e615SJames Wright // Get initial values to check against 214201f0e615SJames Wright CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[0], &data)); 2143506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL)); 214401f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[0], &comp_stride)); 214501f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[0], &num_active_components)); 214601f0e615SJames Wright 2147506b1a0cSSebastian Grimberg // Verify that all active element restrictions have same component stride and number of components 214801f0e615SJames Wright for (CeedInt k = 0; k < num_sub_operators; k++) { 214901f0e615SJames Wright CeedCall(CeedOperatorGetOperatorAssemblyData(sub_operators[k], &data)); 2150506b1a0cSSebastian Grimberg CeedCall(CeedOperatorAssemblyDataGetElemRestrictions(data, &num_active_elem_rstrs, &active_elem_rstrs, NULL, NULL)); 215101f0e615SJames Wright for (CeedInt i = 0; i < num_active_elem_rstrs; i++) { 2152506b1a0cSSebastian Grimberg CeedInt comp_stride_sub, num_active_components_sub; 2153506b1a0cSSebastian Grimberg 215401f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstrs[i], &comp_stride_sub)); 215501f0e615SJames Wright CeedCheck(comp_stride == comp_stride_sub, ceed, CEED_ERROR_DIMENSION, 215601f0e615SJames Wright "Active element restrictions must have the same component stride: %d vs %d", comp_stride, comp_stride_sub); 215701f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumComponents(active_elem_rstrs[i], &num_active_components_sub)); 215801f0e615SJames Wright CeedCheck(num_active_components == num_active_components_sub, ceed, CEED_ERROR_INCOMPATIBLE, 21593f08121cSJeremy L Thompson "All suboperators must have the same number of output components." 21603f08121cSJeremy L Thompson " Previous: %" CeedInt_FMT " Current: %" CeedInt_FMT, 21613f08121cSJeremy L Thompson num_active_components, num_active_components_sub); 216201f0e615SJames Wright } 216301f0e615SJames Wright } 216401f0e615SJames Wright } 216501f0e615SJames Wright *num_entries = input_size * num_active_components; 216601f0e615SJames Wright CeedCall(CeedCalloc(*num_entries, rows)); 216701f0e615SJames Wright CeedCall(CeedCalloc(*num_entries, cols)); 216801f0e615SJames Wright 216901f0e615SJames Wright for (CeedInt o = 0; o < num_sub_operators; o++) { 2170506b1a0cSSebastian Grimberg CeedElemRestriction active_elem_rstr, point_block_active_elem_rstr; 217101f0e615SJames Wright CeedInt comp_stride, num_elem, elem_size; 2172506b1a0cSSebastian Grimberg const CeedInt *offsets, *point_block_offsets; 217301f0e615SJames Wright 217401f0e615SJames Wright CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[o], &active_elem_rstr)); 217501f0e615SJames Wright CeedCall(CeedElemRestrictionGetCompStride(active_elem_rstr, &comp_stride)); 217601f0e615SJames Wright CeedCall(CeedElemRestrictionGetNumElements(active_elem_rstr, &num_elem)); 217701f0e615SJames Wright CeedCall(CeedElemRestrictionGetElementSize(active_elem_rstr, &elem_size)); 217801f0e615SJames Wright CeedCall(CeedElemRestrictionGetOffsets(active_elem_rstr, CEED_MEM_HOST, &offsets)); 217901f0e615SJames Wright 2180506b1a0cSSebastian Grimberg CeedCall(CeedOperatorCreateActivePointBlockRestriction(active_elem_rstr, &point_block_active_elem_rstr)); 2181506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionGetOffsets(point_block_active_elem_rstr, CEED_MEM_HOST, &point_block_offsets)); 218201f0e615SJames Wright 218301f0e615SJames Wright for (CeedSize i = 0; i < num_elem * elem_size; i++) { 218401f0e615SJames Wright for (CeedInt c_out = 0; c_out < num_active_components; c_out++) { 218501f0e615SJames Wright for (CeedInt c_in = 0; c_in < num_active_components; c_in++) { 2186506b1a0cSSebastian Grimberg (*rows)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_out * comp_stride; 2187506b1a0cSSebastian Grimberg (*cols)[point_block_offsets[i] + c_out * num_active_components + c_in] = offsets[i] + c_in * comp_stride; 218801f0e615SJames Wright } 218901f0e615SJames Wright } 219001f0e615SJames Wright } 219101f0e615SJames Wright 219201f0e615SJames Wright CeedCall(CeedElemRestrictionRestoreOffsets(active_elem_rstr, &offsets)); 2193506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionRestoreOffsets(point_block_active_elem_rstr, &point_block_offsets)); 2194*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&active_elem_rstr)); 2195506b1a0cSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&point_block_active_elem_rstr)); 219601f0e615SJames Wright } 219701f0e615SJames Wright return CEED_ERROR_SUCCESS; 219801f0e615SJames Wright } 219901f0e615SJames Wright 220001f0e615SJames Wright /** 2201ca94c3ddSJeremy L Thompson @brief Assemble the point block diagonal of a square linear `CeedOperator`. 2202eaf62fffSJeremy L Thompson 2203ca94c3ddSJeremy L Thompson This overwrites a `CeedVector` with the point block diagonal of a linear `CeedOperator`. 2204eaf62fffSJeremy L Thompson 2205ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2206eaf62fffSJeremy L Thompson 2207ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2208f04ea552SJeremy L Thompson 2209ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2210ca94c3ddSJeremy 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. 2211ca94c3ddSJeremy L Thompson The dimensions of this vector are derived from the active vector for the `CeedOperator`. 2212ca94c3ddSJeremy L Thompson The array has shape `[nodes, component out, component in]`. 2213ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2214eaf62fffSJeremy L Thompson 2215eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2216eaf62fffSJeremy L Thompson 2217eaf62fffSJeremy L Thompson @ref User 2218eaf62fffSJeremy L Thompson **/ 22192b730f8bSJeremy L Thompson int CeedOperatorLinearAssemblePointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2220f3d47e36SJeremy L Thompson bool is_composite; 22211c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 22221203703bSJeremy L Thompson Ceed ceed; 22231c66c397SJeremy L Thompson 22241203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 22252b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2226f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2227eaf62fffSJeremy L Thompson 22282b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 22291203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2230c9366a6bSJeremy L Thompson 2231f3d47e36SJeremy L Thompson // Early exit for empty operator 2232f3d47e36SJeremy L Thompson if (!is_composite) { 2233f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2234f3d47e36SJeremy L Thompson 2235f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2236f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2237f3d47e36SJeremy L Thompson } 2238f3d47e36SJeremy L Thompson 2239eaf62fffSJeremy L Thompson if (op->LinearAssemblePointBlockDiagonal) { 2240d04bbc78SJeremy L Thompson // Backend version 22412b730f8bSJeremy L Thompson CeedCall(op->LinearAssemblePointBlockDiagonal(op, assembled, request)); 2242eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2243eaf62fffSJeremy L Thompson } else if (op->LinearAssembleAddPointBlockDiagonal) { 2244d04bbc78SJeremy L Thompson // Backend version with zeroing first 22452b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 22462b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2247eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2248eaf62fffSJeremy L Thompson } else { 2249d04bbc78SJeremy L Thompson // Operator fallback 2250d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2251d04bbc78SJeremy L Thompson 22522b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2253d04bbc78SJeremy L Thompson if (op_fallback) { 22542b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssemblePointBlockDiagonal(op_fallback, assembled, request)); 2255eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2256eaf62fffSJeremy L Thompson } 2257eaf62fffSJeremy L Thompson } 2258eaf62fffSJeremy L Thompson // Default interface implementation 22592b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(assembled, 0.0)); 22602b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2261eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2262eaf62fffSJeremy L Thompson } 2263eaf62fffSJeremy L Thompson 2264eaf62fffSJeremy L Thompson /** 2265ca94c3ddSJeremy L Thompson @brief Assemble the point block diagonal of a square linear `CeedOperator`. 2266eaf62fffSJeremy L Thompson 2267ca94c3ddSJeremy L Thompson This sums into a `CeedVector` with the point block diagonal of a linear `CeedOperator`. 2268eaf62fffSJeremy L Thompson 2269ca94c3ddSJeremy L Thompson Note: Currently only non-composite `CeedOperator` with a single field and composite `CeedOperator` with single field sub-operators are supported. 2270eaf62fffSJeremy L Thompson 2271ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2272f04ea552SJeremy L Thompson 2273ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble `CeedQFunction` 2274ca94c3ddSJeremy 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. 2275ca94c3ddSJeremy L Thompson The dimensions of this vector are derived from the active vector for the `CeedOperator`. 2276ca94c3ddSJeremy L Thompson The array has shape `[nodes, component out, component in]`. 2277ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2278eaf62fffSJeremy L Thompson 2279eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2280eaf62fffSJeremy L Thompson 2281eaf62fffSJeremy L Thompson @ref User 2282eaf62fffSJeremy L Thompson **/ 22832b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleAddPointBlockDiagonal(CeedOperator op, CeedVector assembled, CeedRequest *request) { 2284f3d47e36SJeremy L Thompson bool is_composite; 22851c66c397SJeremy L Thompson CeedSize input_size = 0, output_size = 0; 22861203703bSJeremy L Thompson Ceed ceed; 22871c66c397SJeremy L Thompson 22881203703bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 22892b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2290f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2291eaf62fffSJeremy L Thompson 22922b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveVectorLengths(op, &input_size, &output_size)); 22931203703bSJeremy L Thompson CeedCheck(input_size == output_size, ceed, CEED_ERROR_DIMENSION, "Operator must be square"); 2294c9366a6bSJeremy L Thompson 2295f3d47e36SJeremy L Thompson // Early exit for empty operator 2296f3d47e36SJeremy L Thompson if (!is_composite) { 2297f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2298f3d47e36SJeremy L Thompson 2299f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2300f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2301f3d47e36SJeremy L Thompson } 2302f3d47e36SJeremy L Thompson 2303eaf62fffSJeremy L Thompson if (op->LinearAssembleAddPointBlockDiagonal) { 2304d04bbc78SJeremy L Thompson // Backend version 23052b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleAddPointBlockDiagonal(op, assembled, request)); 2306eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2307eaf62fffSJeremy L Thompson } else { 2308d04bbc78SJeremy L Thompson // Operator fallback 2309d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2310d04bbc78SJeremy L Thompson 23112b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2312d04bbc78SJeremy L Thompson if (op_fallback) { 23132b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleAddPointBlockDiagonal(op_fallback, assembled, request)); 2314eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2315eaf62fffSJeremy L Thompson } 2316eaf62fffSJeremy L Thompson } 2317ea61e9acSJeremy L Thompson // Default interface implementation 2318eaf62fffSJeremy L Thompson if (is_composite) { 23192b730f8bSJeremy L Thompson CeedCall(CeedCompositeOperatorLinearAssembleAddDiagonal(op, request, true, assembled)); 2320eaf62fffSJeremy L Thompson } else { 2321f3bd9308SJeremy L Thompson CeedCall(CeedSingleOperatorLinearAssembleAddDiagonal(op, request, true, assembled)); 2322eaf62fffSJeremy L Thompson } 2323d04bbc78SJeremy L Thompson return CEED_ERROR_SUCCESS; 2324eaf62fffSJeremy L Thompson } 2325eaf62fffSJeremy L Thompson 2326eaf62fffSJeremy L Thompson /** 2327ca94c3ddSJeremy L Thompson @brief Fully assemble the nonzero pattern of a linear `CeedOperator`. 2328eaf62fffSJeremy L Thompson 2329ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssemble(). 2330eaf62fffSJeremy L Thompson 2331ca94c3ddSJeremy 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)`. 2332ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are not unique and may repeat. 2333ca94c3ddSJeremy L Thompson This function returns the number of entries and their `(i, j)` locations, while @ref CeedOperatorLinearAssemble() provides the values in the same ordering. 2334eaf62fffSJeremy L Thompson 2335eaf62fffSJeremy L Thompson This will generally be slow unless your operator is low-order. 2336eaf62fffSJeremy L Thompson 2337ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2338f04ea552SJeremy L Thompson 2339ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 2340eaf62fffSJeremy L Thompson @param[out] num_entries Number of entries in coordinate nonzero pattern 2341eaf62fffSJeremy L Thompson @param[out] rows Row number for each entry 2342eaf62fffSJeremy L Thompson @param[out] cols Column number for each entry 2343eaf62fffSJeremy L Thompson 2344eaf62fffSJeremy L Thompson @ref User 2345eaf62fffSJeremy L Thompson **/ 23462b730f8bSJeremy L Thompson int CeedOperatorLinearAssembleSymbolic(CeedOperator op, CeedSize *num_entries, CeedInt **rows, CeedInt **cols) { 23471c66c397SJeremy L Thompson bool is_composite; 23481c66c397SJeremy L Thompson CeedInt num_suboperators, offset = 0; 2349b94338b9SJed Brown CeedSize single_entries; 2350eaf62fffSJeremy L Thompson CeedOperator *sub_operators; 23511c66c397SJeremy L Thompson 23522b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2353f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2354eaf62fffSJeremy L Thompson 2355eaf62fffSJeremy L Thompson if (op->LinearAssembleSymbolic) { 2356d04bbc78SJeremy L Thompson // Backend version 23572b730f8bSJeremy L Thompson CeedCall(op->LinearAssembleSymbolic(op, num_entries, rows, cols)); 2358eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2359eaf62fffSJeremy L Thompson } else { 2360d04bbc78SJeremy L Thompson // Operator fallback 2361d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2362d04bbc78SJeremy L Thompson 23632b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2364d04bbc78SJeremy L Thompson if (op_fallback) { 23652b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleSymbolic(op_fallback, num_entries, rows, cols)); 2366eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2367eaf62fffSJeremy L Thompson } 2368eaf62fffSJeremy L Thompson } 2369eaf62fffSJeremy L Thompson 2370eaf62fffSJeremy L Thompson // Default interface implementation 2371eaf62fffSJeremy L Thompson 2372506b1a0cSSebastian Grimberg // Count entries and allocate rows, cols arrays 2373eaf62fffSJeremy L Thompson *num_entries = 0; 2374eaf62fffSJeremy L Thompson if (is_composite) { 2375c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2376c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 237792ae7e47SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; ++k) { 23782b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2379eaf62fffSJeremy L Thompson *num_entries += single_entries; 2380eaf62fffSJeremy L Thompson } 2381eaf62fffSJeremy L Thompson } else { 23822b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(op, &single_entries)); 2383eaf62fffSJeremy L Thompson *num_entries += single_entries; 2384eaf62fffSJeremy L Thompson } 23852b730f8bSJeremy L Thompson CeedCall(CeedCalloc(*num_entries, rows)); 23862b730f8bSJeremy L Thompson CeedCall(CeedCalloc(*num_entries, cols)); 2387eaf62fffSJeremy L Thompson 2388506b1a0cSSebastian Grimberg // Assemble nonzero locations 2389eaf62fffSJeremy L Thompson if (is_composite) { 2390c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2391c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 239292ae7e47SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; ++k) { 23932b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssembleSymbolic(sub_operators[k], offset, *rows, *cols)); 23942b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2395eaf62fffSJeremy L Thompson offset += single_entries; 2396eaf62fffSJeremy L Thompson } 2397eaf62fffSJeremy L Thompson } else { 23982b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssembleSymbolic(op, offset, *rows, *cols)); 2399eaf62fffSJeremy L Thompson } 2400eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2401eaf62fffSJeremy L Thompson } 2402eaf62fffSJeremy L Thompson 2403eaf62fffSJeremy L Thompson /** 2404eaf62fffSJeremy L Thompson @brief Fully assemble the nonzero entries of a linear operator. 2405eaf62fffSJeremy L Thompson 2406ca94c3ddSJeremy L Thompson Expected to be used in conjunction with @ref CeedOperatorLinearAssembleSymbolic(). 2407eaf62fffSJeremy L Thompson 2408ca94c3ddSJeremy 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)`. 2409ca94c3ddSJeremy L Thompson Note that the `(i, j)` pairs are not unique and may repeat. 2410ca94c3ddSJeremy L Thompson This function returns the values of the nonzero entries to be added, their `(i, j)` locations are provided by @ref CeedOperatorLinearAssembleSymbolic(). 2411eaf62fffSJeremy L Thompson 2412eaf62fffSJeremy L Thompson This will generally be slow unless your operator is low-order. 2413eaf62fffSJeremy L Thompson 2414ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2415f04ea552SJeremy L Thompson 2416ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to assemble 2417eaf62fffSJeremy L Thompson @param[out] values Values to assemble into matrix 2418eaf62fffSJeremy L Thompson 2419eaf62fffSJeremy L Thompson @ref User 2420eaf62fffSJeremy L Thompson **/ 2421eaf62fffSJeremy L Thompson int CeedOperatorLinearAssemble(CeedOperator op, CeedVector values) { 24221c66c397SJeremy L Thompson bool is_composite; 24231c66c397SJeremy L Thompson CeedInt num_suboperators, offset = 0; 2424b94338b9SJed Brown CeedSize single_entries = 0; 2425eaf62fffSJeremy L Thompson CeedOperator *sub_operators; 24261c66c397SJeremy L Thompson 24272b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2428f3d47e36SJeremy L Thompson CeedCall(CeedOperatorIsComposite(op, &is_composite)); 2429f3d47e36SJeremy L Thompson 2430f3d47e36SJeremy L Thompson // Early exit for empty operator 2431f3d47e36SJeremy L Thompson if (!is_composite) { 2432f3d47e36SJeremy L Thompson CeedInt num_elem = 0; 2433f3d47e36SJeremy L Thompson 2434f3d47e36SJeremy L Thompson CeedCall(CeedOperatorGetNumElements(op, &num_elem)); 2435f3d47e36SJeremy L Thompson if (num_elem == 0) return CEED_ERROR_SUCCESS; 2436f3d47e36SJeremy L Thompson } 2437eaf62fffSJeremy L Thompson 2438eaf62fffSJeremy L Thompson if (op->LinearAssemble) { 2439d04bbc78SJeremy L Thompson // Backend version 24402b730f8bSJeremy L Thompson CeedCall(op->LinearAssemble(op, values)); 2441eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2442eaf62fffSJeremy L Thompson } else { 2443d04bbc78SJeremy L Thompson // Operator fallback 2444d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2445d04bbc78SJeremy L Thompson 24462b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2447d04bbc78SJeremy L Thompson if (op_fallback) { 24482b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssemble(op_fallback, values)); 2449eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2450eaf62fffSJeremy L Thompson } 2451eaf62fffSJeremy L Thompson } 2452eaf62fffSJeremy L Thompson 2453eaf62fffSJeremy L Thompson // Default interface implementation 245428ec399dSJeremy L Thompson CeedCall(CeedVectorSetValue(values, 0.0)); 2455eaf62fffSJeremy L Thompson if (is_composite) { 2456c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2457c6ebc35dSJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 2458cefa2673SJeremy L Thompson for (CeedInt k = 0; k < num_suboperators; k++) { 24592b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(sub_operators[k], offset, values)); 24602b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemblyCountEntries(sub_operators[k], &single_entries)); 2461eaf62fffSJeremy L Thompson offset += single_entries; 2462eaf62fffSJeremy L Thompson } 2463eaf62fffSJeremy L Thompson } else { 24642b730f8bSJeremy L Thompson CeedCall(CeedSingleOperatorAssemble(op, offset, values)); 2465eaf62fffSJeremy L Thompson } 2466eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2467eaf62fffSJeremy L Thompson } 2468eaf62fffSJeremy L Thompson 2469eaf62fffSJeremy L Thompson /** 2470ca94c3ddSJeremy L Thompson @brief Get the multiplicity of nodes across sub-operators in a composite `CeedOperator`. 247175f0d5a4SJeremy L Thompson 2472ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 247375f0d5a4SJeremy L Thompson 2474ca94c3ddSJeremy L Thompson @param[in] op Composite `CeedOperator` 2475ca94c3ddSJeremy L Thompson @param[in] num_skip_indices Number of sub-operators to skip 2476ca94c3ddSJeremy L Thompson @param[in] skip_indices Array of indices of sub-operators to skip 2477ca94c3ddSJeremy L Thompson @param[out] mult Vector to store multiplicity (of size `l_size` ) 247875f0d5a4SJeremy L Thompson 247975f0d5a4SJeremy L Thompson @return An error code: 0 - success, otherwise - failure 248075f0d5a4SJeremy L Thompson 248175f0d5a4SJeremy L Thompson @ref User 248275f0d5a4SJeremy L Thompson **/ 248375f0d5a4SJeremy L Thompson int CeedCompositeOperatorGetMultiplicity(CeedOperator op, CeedInt num_skip_indices, CeedInt *skip_indices, CeedVector mult) { 248475f0d5a4SJeremy L Thompson Ceed ceed; 2485b275c451SJeremy L Thompson CeedInt num_suboperators; 248675f0d5a4SJeremy L Thompson CeedSize l_vec_len; 248775f0d5a4SJeremy L Thompson CeedScalar *mult_array; 248875f0d5a4SJeremy L Thompson CeedVector ones_l_vec; 24897c1dbaffSSebastian Grimberg CeedElemRestriction elem_rstr, mult_elem_rstr; 2490b275c451SJeremy L Thompson CeedOperator *sub_operators; 249175f0d5a4SJeremy L Thompson 24921c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 24931c66c397SJeremy L Thompson 249475f0d5a4SJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 249575f0d5a4SJeremy L Thompson 249675f0d5a4SJeremy L Thompson // Zero mult vector 249775f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(mult, 0.0)); 249875f0d5a4SJeremy L Thompson 249975f0d5a4SJeremy L Thompson // Get suboperators 2500b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetNumSub(op, &num_suboperators)); 2501b275c451SJeremy L Thompson CeedCall(CeedCompositeOperatorGetSubList(op, &sub_operators)); 2502b275c451SJeremy L Thompson if (num_suboperators == 0) return CEED_ERROR_SUCCESS; 250375f0d5a4SJeremy L Thompson 250475f0d5a4SJeremy L Thompson // Work vector 250575f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetLength(mult, &l_vec_len)); 250675f0d5a4SJeremy L Thompson CeedCall(CeedVectorCreate(ceed, l_vec_len, &ones_l_vec)); 250775f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(ones_l_vec, 1.0)); 250875f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetArray(mult, CEED_MEM_HOST, &mult_array)); 250975f0d5a4SJeremy L Thompson 251075f0d5a4SJeremy L Thompson // Compute multiplicity across suboperators 2511b275c451SJeremy L Thompson for (CeedInt i = 0; i < num_suboperators; i++) { 251275f0d5a4SJeremy L Thompson const CeedScalar *sub_mult_array; 251375f0d5a4SJeremy L Thompson CeedVector sub_mult_l_vec, ones_e_vec; 251475f0d5a4SJeremy L Thompson 251575f0d5a4SJeremy L Thompson // -- Check for suboperator to skip 251675f0d5a4SJeremy L Thompson for (CeedInt j = 0; j < num_skip_indices; j++) { 251775f0d5a4SJeremy L Thompson if (skip_indices[j] == i) continue; 251875f0d5a4SJeremy L Thompson } 251975f0d5a4SJeremy L Thompson 252075f0d5a4SJeremy L Thompson // -- Sub operator multiplicity 2521437c7c90SJeremy L Thompson CeedCall(CeedOperatorGetActiveElemRestriction(sub_operators[i], &elem_rstr)); 25227c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateUnorientedCopy(elem_rstr, &mult_elem_rstr)); 2523*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&elem_rstr)); 25247c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionCreateVector(mult_elem_rstr, &sub_mult_l_vec, &ones_e_vec)); 252575f0d5a4SJeremy L Thompson CeedCall(CeedVectorSetValue(sub_mult_l_vec, 0.0)); 25267c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_NOTRANSPOSE, ones_l_vec, ones_e_vec, CEED_REQUEST_IMMEDIATE)); 25277c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionApply(mult_elem_rstr, CEED_TRANSPOSE, ones_e_vec, sub_mult_l_vec, CEED_REQUEST_IMMEDIATE)); 252875f0d5a4SJeremy L Thompson CeedCall(CeedVectorGetArrayRead(sub_mult_l_vec, CEED_MEM_HOST, &sub_mult_array)); 252975f0d5a4SJeremy L Thompson // ---- Flag every node present in the current suboperator 2530c81f2b9dSJames Wright for (CeedSize j = 0; j < l_vec_len; j++) { 253175f0d5a4SJeremy L Thompson if (sub_mult_array[j] > 0.0) mult_array[j] += 1.0; 253275f0d5a4SJeremy L Thompson } 253375f0d5a4SJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(sub_mult_l_vec, &sub_mult_array)); 253475f0d5a4SJeremy L Thompson CeedCall(CeedVectorDestroy(&sub_mult_l_vec)); 253575f0d5a4SJeremy L Thompson CeedCall(CeedVectorDestroy(&ones_e_vec)); 25367c1dbaffSSebastian Grimberg CeedCall(CeedElemRestrictionDestroy(&mult_elem_rstr)); 253775f0d5a4SJeremy L Thompson } 253875f0d5a4SJeremy L Thompson CeedCall(CeedVectorRestoreArray(mult, &mult_array)); 2539811d0ccfSJeremy L Thompson CeedCall(CeedVectorDestroy(&ones_l_vec)); 254075f0d5a4SJeremy L Thompson return CEED_ERROR_SUCCESS; 254175f0d5a4SJeremy L Thompson } 254275f0d5a4SJeremy L Thompson 254375f0d5a4SJeremy L Thompson /** 2544ca94c3ddSJeremy 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. 2545eaf62fffSJeremy L Thompson 2546ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2547f04ea552SJeremy L Thompson 2548ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2549ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2550ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2551ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2552ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2553ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2554ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2555eaf62fffSJeremy L Thompson 2556eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2557eaf62fffSJeremy L Thompson 2558eaf62fffSJeremy L Thompson @ref User 2559eaf62fffSJeremy L Thompson **/ 25602b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreate(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 25617758292fSSebastian Grimberg CeedOperator *op_coarse, CeedOperator *op_prolong, CeedOperator *op_restrict) { 25621c66c397SJeremy L Thompson CeedBasis basis_c_to_f = NULL; 25631c66c397SJeremy L Thompson 25642b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 2565eaf62fffSJeremy L Thompson 256683d6adf3SZach Atkins // Build prolongation matrix, if required 25677758292fSSebastian Grimberg if (op_prolong || op_restrict) { 256883d6adf3SZach Atkins CeedBasis basis_fine; 25691c66c397SJeremy L Thompson 25702b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 25712b730f8bSJeremy L Thompson CeedCall(CeedBasisCreateProjection(basis_coarse, basis_fine, &basis_c_to_f)); 2572*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 257383d6adf3SZach Atkins } 2574eaf62fffSJeremy L Thompson 2575f113e5dcSJeremy L Thompson // Core code 25767758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2577eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2578eaf62fffSJeremy L Thompson } 2579eaf62fffSJeremy L Thompson 2580eaf62fffSJeremy L Thompson /** 2581ca94c3ddSJeremy L Thompson @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a tensor basis for the active basis. 2582eaf62fffSJeremy L Thompson 2583ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2584f04ea552SJeremy L Thompson 2585ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2586ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2587ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2588ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2589ca94c3ddSJeremy L Thompson @param[in] interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator` 2590ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2591ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2592ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2593eaf62fffSJeremy L Thompson 2594eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2595eaf62fffSJeremy L Thompson 2596eaf62fffSJeremy L Thompson @ref User 2597eaf62fffSJeremy L Thompson **/ 25982b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateTensorH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 25992b730f8bSJeremy L Thompson const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, 26007758292fSSebastian Grimberg CeedOperator *op_restrict) { 2601eaf62fffSJeremy L Thompson Ceed ceed; 26021c66c397SJeremy L Thompson CeedInt Q_f, Q_c; 26031c66c397SJeremy L Thompson CeedBasis basis_fine, basis_c_to_f = NULL; 26041c66c397SJeremy L Thompson 26051c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 26062b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 2607eaf62fffSJeremy L Thompson 2608eaf62fffSJeremy L Thompson // Check for compatible quadrature spaces 26092b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 26102b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f)); 26112b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c)); 26123f08121cSJeremy L Thompson CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, 26133f08121cSJeremy L Thompson "Bases must have compatible quadrature spaces." 26143f08121cSJeremy L Thompson " Fine grid: %" CeedInt_FMT " points, Coarse grid: %" CeedInt_FMT " points", 26153f08121cSJeremy L Thompson Q_f, Q_c); 2616eaf62fffSJeremy L Thompson 261783d6adf3SZach Atkins // Create coarse to fine basis, if required 26187758292fSSebastian Grimberg if (op_prolong || op_restrict) { 26191c66c397SJeremy L Thompson CeedInt dim, num_comp, num_nodes_c, P_1d_f, P_1d_c; 26201c66c397SJeremy L Thompson CeedScalar *q_ref, *q_weight, *grad; 26211c66c397SJeremy L Thompson 262283d6adf3SZach Atkins // Check if interpolation matrix is provided 26236574a04fSJeremy L Thompson CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE, 26246574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix"); 26252b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis_fine, &dim)); 26262b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp)); 26272b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes1D(basis_fine, &P_1d_f)); 2628*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 26292b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c)); 26302b730f8bSJeremy L Thompson P_1d_c = dim == 1 ? num_nodes_c : dim == 2 ? sqrt(num_nodes_c) : cbrt(num_nodes_c); 26312b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f, &q_ref)); 26322b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f, &q_weight)); 26332b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d_f * P_1d_c * dim, &grad)); 26342b730f8bSJeremy 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)); 26352b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref)); 26362b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight)); 26372b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad)); 263883d6adf3SZach Atkins } 2639eaf62fffSJeremy L Thompson 2640eaf62fffSJeremy L Thompson // Core code 26417758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2642eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2643eaf62fffSJeremy L Thompson } 2644eaf62fffSJeremy L Thompson 2645eaf62fffSJeremy L Thompson /** 2646ca94c3ddSJeremy L Thompson @brief Create a multigrid coarse `CeedOperator` and level transfer `CeedOperator` for a `CeedOperator` with a non-tensor basis for the active vector 2647eaf62fffSJeremy L Thompson 2648ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets all four `CeedOperator` as immutable. 2649f04ea552SJeremy L Thompson 2650ca94c3ddSJeremy L Thompson @param[in] op_fine Fine grid `CeedOperator` 2651ca94c3ddSJeremy L Thompson @param[in] p_mult_fine L-vector multiplicity in parallel gather/scatter, or `NULL` if not creating prolongation/restriction `CeedOperator` 2652ca94c3ddSJeremy L Thompson @param[in] rstr_coarse Coarse grid `CeedElemRestriction` 2653ca94c3ddSJeremy L Thompson @param[in] basis_coarse Coarse grid active vector `CeedBasis` 2654ca94c3ddSJeremy L Thompson @param[in] interp_c_to_f Matrix for coarse to fine interpolation, or `NULL` if not creating prolongation/restriction `CeedOperator` 2655ca94c3ddSJeremy L Thompson @param[out] op_coarse Coarse grid `CeedOperator` 2656ca94c3ddSJeremy L Thompson @param[out] op_prolong Coarse to fine `CeedOperator`, or `NULL` 2657ca94c3ddSJeremy L Thompson @param[out] op_restrict Fine to coarse `CeedOperator`, or `NULL` 2658eaf62fffSJeremy L Thompson 2659eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2660eaf62fffSJeremy L Thompson 2661eaf62fffSJeremy L Thompson @ref User 2662eaf62fffSJeremy L Thompson **/ 26632b730f8bSJeremy L Thompson int CeedOperatorMultigridLevelCreateH1(CeedOperator op_fine, CeedVector p_mult_fine, CeedElemRestriction rstr_coarse, CeedBasis basis_coarse, 26647758292fSSebastian Grimberg const CeedScalar *interp_c_to_f, CeedOperator *op_coarse, CeedOperator *op_prolong, 26657758292fSSebastian Grimberg CeedOperator *op_restrict) { 2666eaf62fffSJeremy L Thompson Ceed ceed; 26671c66c397SJeremy L Thompson CeedInt Q_f, Q_c; 26681c66c397SJeremy L Thompson CeedBasis basis_fine, basis_c_to_f = NULL; 26691c66c397SJeremy L Thompson 26701c66c397SJeremy L Thompson CeedCall(CeedOperatorCheckReady(op_fine)); 26712b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op_fine, &ceed)); 2672eaf62fffSJeremy L Thompson 2673eaf62fffSJeremy L Thompson // Check for compatible quadrature spaces 26742b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetActiveBasis(op_fine, &basis_fine)); 26752b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_fine, &Q_f)); 26762b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis_coarse, &Q_c)); 26776574a04fSJeremy L Thompson CeedCheck(Q_f == Q_c, ceed, CEED_ERROR_DIMENSION, "Bases must have compatible quadrature spaces"); 2678eaf62fffSJeremy L Thompson 2679eaf62fffSJeremy L Thompson // Coarse to fine basis 26807758292fSSebastian Grimberg if (op_prolong || op_restrict) { 26811c66c397SJeremy L Thompson CeedInt dim, num_comp, num_nodes_c, num_nodes_f; 26821c66c397SJeremy L Thompson CeedScalar *q_ref, *q_weight, *grad; 26831c66c397SJeremy L Thompson CeedElemTopology topo; 26841c66c397SJeremy L Thompson 268583d6adf3SZach Atkins // Check if interpolation matrix is provided 26866574a04fSJeremy L Thompson CeedCheck(interp_c_to_f, ceed, CEED_ERROR_INCOMPATIBLE, 26876574a04fSJeremy L Thompson "Prolongation or restriction operator creation requires coarse-to-fine interpolation matrix"); 26882b730f8bSJeremy L Thompson CeedCall(CeedBasisGetTopology(basis_fine, &topo)); 26892b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis_fine, &dim)); 26902b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis_fine, &num_comp)); 26912b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes(basis_fine, &num_nodes_f)); 2692*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis_fine)); 26932b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetElementSize(rstr_coarse, &num_nodes_c)); 26942b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f * dim, &q_ref)); 26952b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f, &q_weight)); 26962b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_nodes_f * num_nodes_c * dim, &grad)); 26972b730f8bSJeremy 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)); 26982b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref)); 26992b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight)); 27002b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad)); 270183d6adf3SZach Atkins } 2702eaf62fffSJeremy L Thompson 2703eaf62fffSJeremy L Thompson // Core code 27047758292fSSebastian Grimberg CeedCall(CeedSingleOperatorMultigridLevel(op_fine, p_mult_fine, rstr_coarse, basis_coarse, basis_c_to_f, op_coarse, op_prolong, op_restrict)); 2705eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2706eaf62fffSJeremy L Thompson } 2707eaf62fffSJeremy L Thompson 2708eaf62fffSJeremy L Thompson /** 2709ca94c3ddSJeremy L Thompson @brief Build a FDM based approximate inverse for each element for a `CeedOperator`. 2710eaf62fffSJeremy L Thompson 2711ca94c3ddSJeremy L Thompson This returns a `CeedOperator` and `CeedVector` to apply a Fast Diagonalization Method based approximate inverse. 2712859c15bbSJames 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$. 2713ca94c3ddSJeremy 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$. 2714ca94c3ddSJeremy L Thompson The `CeedOperator` must be linear and non-composite. 2715ca94c3ddSJeremy L Thompson The associated `CeedQFunction` must therefore also be linear. 2716eaf62fffSJeremy L Thompson 2717ca94c3ddSJeremy L Thompson Note: Calling this function asserts that setup is complete and sets the `CeedOperator` as immutable. 2718f04ea552SJeremy L Thompson 2719ca94c3ddSJeremy L Thompson @param[in] op `CeedOperator` to create element inverses 2720ca94c3ddSJeremy L Thompson @param[out] fdm_inv `CeedOperator` to apply the action of a FDM based inverse for each element 2721ca94c3ddSJeremy L Thompson @param[in] request Address of @ref CeedRequest for non-blocking completion, else @ref CEED_REQUEST_IMMEDIATE 2722eaf62fffSJeremy L Thompson 2723eaf62fffSJeremy L Thompson @return An error code: 0 - success, otherwise - failure 2724eaf62fffSJeremy L Thompson 2725480fae85SJeremy L Thompson @ref User 2726eaf62fffSJeremy L Thompson **/ 27272b730f8bSJeremy L Thompson int CeedOperatorCreateFDMElementInverse(CeedOperator op, CeedOperator *fdm_inv, CeedRequest *request) { 27281c66c397SJeremy L Thompson Ceed ceed, ceed_parent; 27291c66c397SJeremy L Thompson bool interp = false, grad = false, is_tensor_basis = true; 27301c66c397SJeremy L Thompson CeedInt num_input_fields, P_1d, Q_1d, num_nodes, num_qpts, dim, num_comp = 1, num_elem = 1; 27311c66c397SJeremy L Thompson CeedScalar *mass, *laplace, *x, *fdm_interp, *lambda, *elem_avg; 27321c66c397SJeremy L Thompson const CeedScalar *interp_1d, *grad_1d, *q_weight_1d; 27331c66c397SJeremy L Thompson CeedVector q_data; 27341c66c397SJeremy L Thompson CeedElemRestriction rstr = NULL, rstr_qd_i; 27351c66c397SJeremy L Thompson CeedBasis basis = NULL, fdm_basis; 27361c66c397SJeremy L Thompson CeedQFunctionContext ctx_fdm; 27371c66c397SJeremy L Thompson CeedQFunctionField *qf_fields; 27381c66c397SJeremy L Thompson CeedQFunction qf, qf_fdm; 27391c66c397SJeremy L Thompson CeedOperatorField *op_fields; 27401c66c397SJeremy L Thompson 27412b730f8bSJeremy L Thompson CeedCall(CeedOperatorCheckReady(op)); 2742eaf62fffSJeremy L Thompson 2743eaf62fffSJeremy L Thompson if (op->CreateFDMElementInverse) { 2744d04bbc78SJeremy L Thompson // Backend version 27452b730f8bSJeremy L Thompson CeedCall(op->CreateFDMElementInverse(op, fdm_inv, request)); 2746eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2747eaf62fffSJeremy L Thompson } else { 2748d04bbc78SJeremy L Thompson // Operator fallback 2749d04bbc78SJeremy L Thompson CeedOperator op_fallback; 2750d04bbc78SJeremy L Thompson 27512b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFallback(op, &op_fallback)); 2752d04bbc78SJeremy L Thompson if (op_fallback) { 27532b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreateFDMElementInverse(op_fallback, fdm_inv, request)); 2754eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2755eaf62fffSJeremy L Thompson } 2756eaf62fffSJeremy L Thompson } 2757eaf62fffSJeremy L Thompson 2758d04bbc78SJeremy L Thompson // Default interface implementation 27592b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetCeed(op, &ceed)); 2760bb229da9SJeremy L Thompson CeedCall(CeedOperatorGetFallbackParentCeed(op, &ceed_parent)); 27612b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetQFunction(op, &qf)); 2762eaf62fffSJeremy L Thompson 2763eaf62fffSJeremy L Thompson // Determine active input basis 27642b730f8bSJeremy L Thompson CeedCall(CeedOperatorGetFields(op, &num_input_fields, &op_fields, NULL, NULL)); 27652b730f8bSJeremy L Thompson CeedCall(CeedQFunctionGetFields(qf, NULL, &qf_fields, NULL, NULL)); 2766eaf62fffSJeremy L Thompson for (CeedInt i = 0; i < num_input_fields; i++) { 2767eaf62fffSJeremy L Thompson CeedVector vec; 27681c66c397SJeremy L Thompson 27692b730f8bSJeremy L Thompson CeedCall(CeedOperatorFieldGetVector(op_fields[i], &vec)); 2770eaf62fffSJeremy L Thompson if (vec == CEED_VECTOR_ACTIVE) { 2771eaf62fffSJeremy L Thompson CeedEvalMode eval_mode; 27721c66c397SJeremy L Thompson 27732b730f8bSJeremy L Thompson CeedCall(CeedQFunctionFieldGetEvalMode(qf_fields[i], &eval_mode)); 2774eaf62fffSJeremy L Thompson interp = interp || eval_mode == CEED_EVAL_INTERP; 2775eaf62fffSJeremy L Thompson grad = grad || eval_mode == CEED_EVAL_GRAD; 2776*681d0ea7SJeremy L Thompson if (!basis) CeedCall(CeedOperatorFieldGetBasis(op_fields[i], &basis)); 2777*681d0ea7SJeremy L Thompson if (!rstr) CeedCall(CeedOperatorFieldGetElemRestriction(op_fields[i], &rstr)); 2778eaf62fffSJeremy L Thompson } 2779*681d0ea7SJeremy L Thompson CeedCall(CeedVectorDestroy(&vec)); 2780eaf62fffSJeremy L Thompson } 27816574a04fSJeremy L Thompson CeedCheck(basis, ceed, CEED_ERROR_BACKEND, "No active field set"); 27822b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumNodes1D(basis, &P_1d)); 2783352a5e7cSSebastian Grimberg CeedCall(CeedBasisGetNumNodes(basis, &num_nodes)); 27842b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints1D(basis, &Q_1d)); 27852b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumQuadraturePoints(basis, &num_qpts)); 27862b730f8bSJeremy L Thompson CeedCall(CeedBasisGetDimension(basis, &dim)); 27872b730f8bSJeremy L Thompson CeedCall(CeedBasisGetNumComponents(basis, &num_comp)); 27882b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionGetNumElements(rstr, &num_elem)); 2789eaf62fffSJeremy L Thompson 2790eaf62fffSJeremy L Thompson // Build and diagonalize 1D Mass and Laplacian 27916574a04fSJeremy L Thompson CeedCall(CeedBasisIsTensor(basis, &is_tensor_basis)); 27926574a04fSJeremy L Thompson CeedCheck(is_tensor_basis, ceed, CEED_ERROR_BACKEND, "FDMElementInverse only supported for tensor bases"); 27932b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &mass)); 27942b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &laplace)); 27952b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &x)); 27962b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &fdm_interp)); 27972b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &lambda)); 2798eaf62fffSJeremy L Thompson // -- Build matrices 27992b730f8bSJeremy L Thompson CeedCall(CeedBasisGetInterp1D(basis, &interp_1d)); 28002b730f8bSJeremy L Thompson CeedCall(CeedBasisGetGrad1D(basis, &grad_1d)); 28012b730f8bSJeremy L Thompson CeedCall(CeedBasisGetQWeights(basis, &q_weight_1d)); 28022b730f8bSJeremy L Thompson CeedCall(CeedBuildMassLaplace(interp_1d, grad_1d, q_weight_1d, P_1d, Q_1d, dim, mass, laplace)); 2803eaf62fffSJeremy L Thompson 2804eaf62fffSJeremy L Thompson // -- Diagonalize 28052b730f8bSJeremy L Thompson CeedCall(CeedSimultaneousDiagonalization(ceed, laplace, mass, x, lambda, P_1d)); 28062b730f8bSJeremy L Thompson CeedCall(CeedFree(&mass)); 28072b730f8bSJeremy L Thompson CeedCall(CeedFree(&laplace)); 28082b730f8bSJeremy L Thompson for (CeedInt i = 0; i < P_1d; i++) { 28092b730f8bSJeremy L Thompson for (CeedInt j = 0; j < P_1d; j++) fdm_interp[i + j * P_1d] = x[j + i * P_1d]; 28102b730f8bSJeremy L Thompson } 28112b730f8bSJeremy L Thompson CeedCall(CeedFree(&x)); 2812eaf62fffSJeremy L Thompson 28131c66c397SJeremy L Thompson { 28141c66c397SJeremy L Thompson CeedInt layout[3], num_modes = (interp ? 1 : 0) + (grad ? dim : 0); 28151c66c397SJeremy L Thompson CeedScalar max_norm = 0; 28161c66c397SJeremy L Thompson const CeedScalar *assembled_array, *q_weight_array; 28171c66c397SJeremy L Thompson CeedVector assembled = NULL, q_weight; 2818c5f45aeaSJeremy L Thompson CeedElemRestriction rstr_qf = NULL; 28191c66c397SJeremy L Thompson 28201c66c397SJeremy L Thompson // Assemble QFunction 28212b730f8bSJeremy L Thompson CeedCall(CeedOperatorLinearAssembleQFunctionBuildOrUpdate(op, &assembled, &rstr_qf, request)); 282256c48462SJeremy L Thompson CeedCall(CeedElemRestrictionGetELayout(rstr_qf, layout)); 28232b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_qf)); 28242b730f8bSJeremy L Thompson CeedCall(CeedVectorNorm(assembled, CEED_NORM_MAX, &max_norm)); 2825eaf62fffSJeremy L Thompson 2826eaf62fffSJeremy L Thompson // Calculate element averages 28272b730f8bSJeremy L Thompson CeedCall(CeedVectorCreate(ceed_parent, num_qpts, &q_weight)); 28282b730f8bSJeremy L Thompson CeedCall(CeedBasisApply(basis, 1, CEED_NOTRANSPOSE, CEED_EVAL_WEIGHT, CEED_VECTOR_NONE, q_weight)); 28292b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayRead(assembled, CEED_MEM_HOST, &assembled_array)); 28302b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayRead(q_weight, CEED_MEM_HOST, &q_weight_array)); 28312b730f8bSJeremy L Thompson CeedCall(CeedCalloc(num_elem, &elem_avg)); 2832eaf62fffSJeremy L Thompson const CeedScalar qf_value_bound = max_norm * 100 * CEED_EPSILON; 28331c66c397SJeremy L Thompson 2834eaf62fffSJeremy L Thompson for (CeedInt e = 0; e < num_elem; e++) { 2835eaf62fffSJeremy L Thompson CeedInt count = 0; 28361c66c397SJeremy L Thompson 28372b730f8bSJeremy L Thompson for (CeedInt q = 0; q < num_qpts; q++) { 28382b730f8bSJeremy L Thompson for (CeedInt i = 0; i < num_comp * num_comp * num_modes * num_modes; i++) { 28392b730f8bSJeremy L Thompson if (fabs(assembled_array[q * layout[0] + i * layout[1] + e * layout[2]]) > qf_value_bound) { 28402b730f8bSJeremy L Thompson elem_avg[e] += assembled_array[q * layout[0] + i * layout[1] + e * layout[2]] / q_weight_array[q]; 2841eaf62fffSJeremy L Thompson count++; 2842eaf62fffSJeremy L Thompson } 28432b730f8bSJeremy L Thompson } 28442b730f8bSJeremy L Thompson } 2845eaf62fffSJeremy L Thompson if (count) { 2846eaf62fffSJeremy L Thompson elem_avg[e] /= count; 2847eaf62fffSJeremy L Thompson } else { 2848eaf62fffSJeremy L Thompson elem_avg[e] = 1.0; 2849eaf62fffSJeremy L Thompson } 2850eaf62fffSJeremy L Thompson } 28512b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(assembled, &assembled_array)); 28522b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&assembled)); 28532b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArrayRead(q_weight, &q_weight_array)); 28542b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&q_weight)); 28551c66c397SJeremy L Thompson } 2856eaf62fffSJeremy L Thompson 2857eaf62fffSJeremy L Thompson // Build FDM diagonal 28581c66c397SJeremy L Thompson { 2859eaf62fffSJeremy L Thompson CeedScalar *q_data_array, *fdm_diagonal; 28601c66c397SJeremy L Thompson 2861352a5e7cSSebastian Grimberg CeedCall(CeedCalloc(num_comp * num_nodes, &fdm_diagonal)); 2862352a5e7cSSebastian Grimberg const CeedScalar fdm_diagonal_bound = num_nodes * CEED_EPSILON; 28632b730f8bSJeremy L Thompson for (CeedInt c = 0; c < num_comp; c++) { 2864352a5e7cSSebastian Grimberg for (CeedInt n = 0; n < num_nodes; n++) { 2865352a5e7cSSebastian Grimberg if (interp) fdm_diagonal[c * num_nodes + n] = 1.0; 28662b730f8bSJeremy L Thompson if (grad) { 2867eaf62fffSJeremy L Thompson for (CeedInt d = 0; d < dim; d++) { 2868eaf62fffSJeremy L Thompson CeedInt i = (n / CeedIntPow(P_1d, d)) % P_1d; 2869352a5e7cSSebastian Grimberg fdm_diagonal[c * num_nodes + n] += lambda[i]; 2870eaf62fffSJeremy L Thompson } 2871eaf62fffSJeremy L Thompson } 2872352a5e7cSSebastian Grimberg if (fabs(fdm_diagonal[c * num_nodes + n]) < fdm_diagonal_bound) fdm_diagonal[c * num_nodes + n] = fdm_diagonal_bound; 28732b730f8bSJeremy L Thompson } 28742b730f8bSJeremy L Thompson } 2875352a5e7cSSebastian Grimberg CeedCall(CeedVectorCreate(ceed_parent, num_elem * num_comp * num_nodes, &q_data)); 28762b730f8bSJeremy L Thompson CeedCall(CeedVectorSetValue(q_data, 0.0)); 28772b730f8bSJeremy L Thompson CeedCall(CeedVectorGetArrayWrite(q_data, CEED_MEM_HOST, &q_data_array)); 28782b730f8bSJeremy L Thompson for (CeedInt e = 0; e < num_elem; e++) { 28792b730f8bSJeremy L Thompson for (CeedInt c = 0; c < num_comp; c++) { 28806c10af5dSJeremy L Thompson for (CeedInt n = 0; n < num_nodes; n++) { 28811c66c397SJeremy L Thompson q_data_array[(e * num_comp + c) * num_nodes + n] = 1. / (elem_avg[e] * fdm_diagonal[c * num_nodes + n]); 28822b730f8bSJeremy L Thompson } 28832b730f8bSJeremy L Thompson } 28846c10af5dSJeremy L Thompson } 28852b730f8bSJeremy L Thompson CeedCall(CeedFree(&elem_avg)); 28862b730f8bSJeremy L Thompson CeedCall(CeedFree(&fdm_diagonal)); 28872b730f8bSJeremy L Thompson CeedCall(CeedVectorRestoreArray(q_data, &q_data_array)); 28881c66c397SJeremy L Thompson } 2889eaf62fffSJeremy L Thompson 2890eaf62fffSJeremy L Thompson // Setup FDM operator 2891eaf62fffSJeremy L Thompson // -- Basis 28921c66c397SJeremy L Thompson { 2893eaf62fffSJeremy L Thompson CeedScalar *grad_dummy, *q_ref_dummy, *q_weight_dummy; 28941c66c397SJeremy L Thompson 28952b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d * P_1d, &grad_dummy)); 28962b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &q_ref_dummy)); 28972b730f8bSJeremy L Thompson CeedCall(CeedCalloc(P_1d, &q_weight_dummy)); 28982b730f8bSJeremy 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)); 28992b730f8bSJeremy L Thompson CeedCall(CeedFree(&fdm_interp)); 29002b730f8bSJeremy L Thompson CeedCall(CeedFree(&grad_dummy)); 29012b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_ref_dummy)); 29022b730f8bSJeremy L Thompson CeedCall(CeedFree(&q_weight_dummy)); 29032b730f8bSJeremy L Thompson CeedCall(CeedFree(&lambda)); 29041c66c397SJeremy L Thompson } 2905eaf62fffSJeremy L Thompson 2906eaf62fffSJeremy L Thompson // -- Restriction 29071c66c397SJeremy L Thompson { 2908352a5e7cSSebastian Grimberg CeedInt strides[3] = {1, num_nodes, num_nodes * num_comp}; 29090a5597ceSJeremy L Thompson CeedCall(CeedElemRestrictionCreateStrided(ceed_parent, num_elem, num_nodes, num_comp, 29100a5597ceSJeremy L Thompson (CeedSize)num_elem * (CeedSize)num_comp * (CeedSize)num_nodes, strides, &rstr_qd_i)); 29111c66c397SJeremy L Thompson } 29121c66c397SJeremy L Thompson 2913eaf62fffSJeremy L Thompson // -- QFunction 29142b730f8bSJeremy L Thompson CeedCall(CeedQFunctionCreateInteriorByName(ceed_parent, "Scale", &qf_fdm)); 29152b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_fdm, "input", num_comp, CEED_EVAL_INTERP)); 29162b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddInput(qf_fdm, "scale", num_comp, CEED_EVAL_NONE)); 29172b730f8bSJeremy L Thompson CeedCall(CeedQFunctionAddOutput(qf_fdm, "output", num_comp, CEED_EVAL_INTERP)); 29182b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetUserFlopsEstimate(qf_fdm, num_comp)); 29191c66c397SJeremy L Thompson 2920eaf62fffSJeremy L Thompson // -- QFunction context 29211c66c397SJeremy L Thompson { 2922eaf62fffSJeremy L Thompson CeedInt *num_comp_data; 29231c66c397SJeremy L Thompson 29242b730f8bSJeremy L Thompson CeedCall(CeedCalloc(1, &num_comp_data)); 2925eaf62fffSJeremy L Thompson num_comp_data[0] = num_comp; 29262b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextCreate(ceed, &ctx_fdm)); 29272b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextSetData(ctx_fdm, CEED_MEM_HOST, CEED_OWN_POINTER, sizeof(*num_comp_data), num_comp_data)); 29281c66c397SJeremy L Thompson } 29292b730f8bSJeremy L Thompson CeedCall(CeedQFunctionSetContext(qf_fdm, ctx_fdm)); 29302b730f8bSJeremy L Thompson CeedCall(CeedQFunctionContextDestroy(&ctx_fdm)); 29311c66c397SJeremy L Thompson 2932eaf62fffSJeremy L Thompson // -- Operator 29332b730f8bSJeremy L Thompson CeedCall(CeedOperatorCreate(ceed_parent, qf_fdm, NULL, NULL, fdm_inv)); 29342b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "input", rstr, fdm_basis, CEED_VECTOR_ACTIVE)); 2935356036faSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "scale", rstr_qd_i, CEED_BASIS_NONE, q_data)); 29362b730f8bSJeremy L Thompson CeedCall(CeedOperatorSetField(*fdm_inv, "output", rstr, fdm_basis, CEED_VECTOR_ACTIVE)); 2937eaf62fffSJeremy L Thompson 2938eaf62fffSJeremy L Thompson // Cleanup 29392b730f8bSJeremy L Thompson CeedCall(CeedVectorDestroy(&q_data)); 2940*681d0ea7SJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr)); 29412b730f8bSJeremy L Thompson CeedCall(CeedElemRestrictionDestroy(&rstr_qd_i)); 2942*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&basis)); 2943*681d0ea7SJeremy L Thompson CeedCall(CeedBasisDestroy(&fdm_basis)); 29442b730f8bSJeremy L Thompson CeedCall(CeedQFunctionDestroy(&qf_fdm)); 2945eaf62fffSJeremy L Thompson return CEED_ERROR_SUCCESS; 2946eaf62fffSJeremy L Thompson } 2947eaf62fffSJeremy L Thompson 2948eaf62fffSJeremy L Thompson /// @} 2949