1 // SPDX-FileCopyrightText: Copyright (c) 2017-2024, HONEE contributors. 2 // SPDX-License-Identifier: Apache-2.0 OR BSD-2-Clause 3 #pragma once 4 5 #include <ceed.h> 6 #include <bc_definition.h> 7 #include <dm-utils.h> 8 #include <honee-file.h> 9 #include <honee.h> 10 #include <log_events.h> 11 #include <mat-ceed.h> 12 #include <petsc-ceed-utils.h> 13 #include <petscts.h> 14 #include <stdbool.h> 15 #include <time.h> 16 17 #include <nodal_projection.h> 18 19 #include <petsc_ops.h> 20 #include "../qfunctions/newtonian_types.h" 21 22 #if PETSC_VERSION_LT(3, 23, 0) 23 #error "PETSc v3.23 or later is required" 24 #endif 25 26 // ----------------------------------------------------------------------------- 27 // Enums 28 // ----------------------------------------------------------------------------- 29 30 // Euler - test cases 31 typedef enum { 32 EULER_TEST_ISENTROPIC_VORTEX = 0, 33 EULER_TEST_1 = 1, 34 EULER_TEST_2 = 2, 35 EULER_TEST_3 = 3, 36 EULER_TEST_4 = 4, 37 EULER_TEST_5 = 5, 38 } EulerTestType; 39 static const char *const EulerTestTypes[] = {"ISENTROPIC_VORTEX", "1", "2", "3", "4", "5", "EulerTestType", "EULER_TEST_", NULL}; 40 41 // Test mode type 42 typedef enum { 43 TESTTYPE_NONE = 0, 44 TESTTYPE_SOLVER = 1, 45 TESTTYPE_TURB_SPANSTATS = 2, 46 TESTTYPE_DIFF_FILTER = 3, 47 } TestType; 48 static const char *const TestTypes[] = {"NONE", "SOLVER", "TURB_SPANSTATS", "DIFF_FILTER", "TestType", "TESTTYPE_", NULL}; 49 50 // Subgrid-Stress mode type 51 typedef enum { 52 SGS_MODEL_NONE = 0, 53 SGS_MODEL_DATA_DRIVEN = 1, 54 } SGSModelType; 55 static const char *const SGSModelTypes[] = {"NONE", "DATA_DRIVEN", "SGSModelType", "SGS_MODEL_", NULL}; 56 57 // Subgrid-Stress mode type 58 typedef enum { 59 SGS_MODEL_DD_FUSED = 0, 60 SGS_MODEL_DD_SEQENTIAL_CEED = 1, 61 SGS_MODEL_DD_SEQENTIAL_TORCH = 2, 62 } SGSModelDDImplementation; 63 static const char *const SGSModelDDImplementations[] = {"FUSED", "SEQUENTIAL_CEED", "SEQUENTIAL_TORCH", "SGSModelDDImplementation", "SGS_MODEL_DD_", 64 NULL}; 65 66 // Mesh transformation type 67 typedef enum { 68 MESH_TRANSFORM_NONE = 0, 69 MESH_TRANSFORM_PLATEMESH = 1, 70 } MeshTransformType; 71 static const char *const MeshTransformTypes[] = {"NONE", "PLATEMESH", "MeshTransformType", "MESH_TRANSFORM_", NULL}; 72 73 // ----------------------------------------------------------------------------- 74 // Structs 75 // ----------------------------------------------------------------------------- 76 // Structs declarations 77 typedef struct AppCtx_private *AppCtx; 78 typedef struct Units_private *Units; 79 typedef struct SimpleBC_private *SimpleBC; 80 typedef struct Physics_private *Physics; 81 typedef struct ProblemData_private *ProblemData; 82 83 // Application context from user command line options 84 struct AppCtx_private { 85 // libCEED arguments 86 char ceed_resource[PETSC_MAX_PATH_LEN]; // libCEED backend 87 PetscInt degree; 88 PetscInt q_extra; 89 // Solver arguments 90 MatType amat_type; 91 // Post-processing arguments 92 PetscInt checkpoint_interval; 93 PetscInt viz_refine; 94 PetscBool use_continue_file; 95 PetscInt cont_steps; 96 PetscReal cont_time; 97 char cont_file[PETSC_MAX_PATH_LEN]; 98 char output_dir[PETSC_MAX_PATH_LEN]; 99 PetscBool add_stepnum2bin; 100 PetscBool checkpoint_vtk; 101 // Problem type arguments 102 PetscFunctionList problems; 103 char problem_name[PETSC_MAX_PATH_LEN]; 104 // Test mode arguments 105 TestType test_type; 106 PetscScalar test_tol; 107 char test_file_path[PETSC_MAX_PATH_LEN]; 108 // Wall forces 109 struct { 110 PetscInt num_wall; 111 PetscInt *walls; 112 PetscViewer viewer; 113 PetscViewerFormat viewer_format; 114 PetscBool header_written; 115 } wall_forces; 116 // Subgrid Stress Model 117 SGSModelType sgs_model_type; 118 PetscBool sgs_train_enable; 119 120 MeshTransformType mesh_transform_type; 121 // Divergence of Diffusive Flux Projection 122 DivDiffFluxProjectionMethod divFdiffproj_method; 123 124 PetscInt check_step_interval; 125 }; 126 127 typedef struct DivDiffFluxProjectionData_private *DivDiffFluxProjectionData; 128 129 struct DivDiffFluxProjectionData_private { 130 PetscInt num_diff_flux_comps; 131 DivDiffFluxProjectionMethod method; 132 NodalProjectionData projection; 133 134 // CeedOperator Objects 135 CeedElemRestriction elem_restr_div_diff_flux; 136 CeedBasis basis_div_diff_flux; 137 CeedEvalMode eval_mode_div_diff_flux; 138 CeedVector div_diff_flux_ceed; 139 140 // Problem specific setup functions 141 PetscErrorCode (*CreateRHSOperator_Direct)(Honee, DivDiffFluxProjectionData, CeedOperator *); 142 PetscErrorCode (*CreateRHSOperator_Indirect)(Honee, DivDiffFluxProjectionData, CeedOperator *); 143 144 // Only used for direct method: 145 Vec DivDiffFlux_loc; 146 PetscMemType DivDiffFlux_memtype; 147 PetscBool ceed_vec_has_array; 148 149 // Only used for indirect method: 150 OperatorApplyContext calc_div_diff_flux; 151 }; 152 153 typedef struct _HoneeOps *HoneeOps; 154 struct _HoneeOps {}; 155 156 PetscErrorCode HoneeInit(MPI_Comm comm, Honee *honee); 157 PetscErrorCode HoneeDestroy(Honee *honee); 158 159 // PETSc user data 160 struct Honee_private { 161 PETSCHEADER(struct _HoneeOps); 162 MPI_Comm comm; 163 DM dm; 164 DM dm_viz; 165 Mat interp_viz; 166 Ceed ceed; 167 Units units; 168 Vec Q_loc, Q_dot_loc; 169 Physics phys; 170 AppCtx app_ctx; 171 CeedVector q_ceed, q_dot_ceed, g_ceed, x_ceed; 172 CeedOperator op_ifunction; 173 Mat mat_ijacobian; 174 KSP mass_ksp; 175 OperatorApplyContext op_rhs_ctx, op_strong_bc_ctx; 176 CeedScalar time_bc_set; 177 DivDiffFluxProjectionData diff_flux_proj; 178 179 ProblemData problem_data; 180 181 // old CeedData 182 CeedVector x_coord; 183 CeedBasis basis_x, basis_q; 184 CeedElemRestriction elem_restr_x, elem_restr_q; 185 OperatorApplyContext op_ics_ctx; 186 187 PetscBool set_poststep; 188 time_t start_time; 189 time_t max_wall_time; 190 PetscInt max_wall_time_interval; 191 }; 192 193 // Units 194 struct Units_private { 195 // fundamental units 196 PetscScalar meter; 197 PetscScalar kilogram; 198 PetscScalar second; 199 PetscScalar Kelvin; 200 // derived units 201 PetscScalar Pascal; 202 PetscScalar J_per_kg_K; 203 PetscScalar m_per_squared_s; 204 PetscScalar W_per_m_K; 205 PetscScalar Joule; 206 }; 207 208 // Struct that contains all enums and structs used for the physics of all problems 209 struct Physics_private { 210 PetscBool implicit; 211 StateVariable state_var; 212 CeedContextFieldLabel solution_time_label; 213 CeedContextFieldLabel stg_solution_time_label; 214 CeedContextFieldLabel timestep_size_label; 215 CeedContextFieldLabel ics_time_label; 216 }; 217 218 typedef struct { 219 Honee honee; 220 CeedInt num_comps_jac_data; 221 CeedQFunctionContext qfctx; 222 void *ctx; 223 PetscCtxDestroyFn *DestroyCtx; 224 } *HoneeBCStruct; 225 226 PetscErrorCode BoundaryConditionSetUp(Honee honee, ProblemData problem, AppCtx app_ctx); 227 PetscErrorCode HoneeBCDestroy(void **ctx); 228 PetscErrorCode HoneeBCCreateIFunctionQF(BCDefinition bc_def, CeedQFunctionUser qf_func_ptr, const char *qf_loc, CeedQFunctionContext qfctx, 229 CeedQFunction *qf_ifunc); 230 PetscErrorCode HoneeBCCreateIJacobianQF(BCDefinition bc_def, CeedQFunctionUser qf_func_ptr, const char *qf_loc, CeedQFunctionContext qfctx, 231 CeedQFunction *qf_ijac); 232 PetscErrorCode HoneeBCAddIFunctionOp(BCDefinition bc_def, DMLabel domain_label, PetscInt label_value, CeedQFunction qf_ifunc, CeedOperator op_ifunc, 233 CeedOperator *sub_op_ifunc); 234 PetscErrorCode HoneeBCAddIJacobianOp(BCDefinition bc_def, CeedOperator sub_op_ifunc, DMLabel domain_label, PetscInt label_value, 235 CeedQFunction qf_ijac, CeedOperator op_ijac); 236 237 typedef struct { 238 CeedQFunctionUser qf_func_ptr; // !< QFunction function pointer 239 const char *qf_loc; // !< Absolute path to QFunction source file 240 CeedQFunctionContext qfctx; // !< QFunctionContext to attach to QFunction 241 } ProblemQFunctionSpec; 242 243 // Problem specific data 244 struct ProblemData_private { 245 CeedInt num_comps_jac_data; 246 ProblemQFunctionSpec ics, apply_vol_rhs, apply_vol_ifunction, apply_vol_ijacobian; 247 bool compute_exact_solution_error; 248 PetscBool set_bc_from_ics, use_strong_bc_ceed; 249 PetscCount num_bc_defs; 250 BCDefinition *bc_defs; 251 PetscErrorCode (*print_info)(Honee, ProblemData, AppCtx); 252 PetscErrorCode (*create_mass_operator)(Honee, CeedOperator *); 253 }; 254 255 extern int FreeContextPetsc(void *); 256 257 // ----------------------------------------------------------------------------- 258 // Set up problems 259 // ----------------------------------------------------------------------------- 260 // Set up function for each problem 261 extern PetscErrorCode NS_TAYLOR_GREEN(ProblemData problem, DM dm, void *ctx); 262 extern PetscErrorCode NS_GAUSSIAN_WAVE(ProblemData problem, DM dm, void *ctx); 263 extern PetscErrorCode NS_CHANNEL(ProblemData problem, DM dm, void *ctx); 264 extern PetscErrorCode NS_BLASIUS(ProblemData problem, DM dm, void *ctx); 265 extern PetscErrorCode NS_NEWTONIAN_IG(ProblemData problem, DM dm, void *ctx); 266 extern PetscErrorCode NS_DENSITY_CURRENT(ProblemData problem, DM dm, void *ctx); 267 extern PetscErrorCode NS_EULER_VORTEX(ProblemData problem, DM dm, void *ctx); 268 extern PetscErrorCode NS_SHOCKTUBE(ProblemData problem, DM dm, void *ctx); 269 extern PetscErrorCode NS_ADVECTION(ProblemData problem, DM dm, void *ctx); 270 271 // Print function for each problem 272 extern PetscErrorCode PRINT_NEWTONIAN(Honee honee, ProblemData problem, AppCtx app_ctx); 273 extern PetscErrorCode PRINT_EULER_VORTEX(Honee honee, ProblemData problem, AppCtx app_ctx); 274 extern PetscErrorCode PRINT_SHOCKTUBE(Honee honee, ProblemData problem, AppCtx app_ctx); 275 extern PetscErrorCode PRINT_ADVECTION(Honee honee, ProblemData problem, AppCtx app_ctx); 276 extern PetscErrorCode PRINT_ADVECTION2D(Honee honee, ProblemData problem, AppCtx app_ctx); 277 278 PetscErrorCode PrintRunInfo(Honee honee, Physics phys_ctx, ProblemData problem, TS ts); 279 280 // ----------------------------------------------------------------------------- 281 // libCEED functions 282 // ----------------------------------------------------------------------------- 283 PetscErrorCode SetupLibceed(Ceed ceed, DM dm, Honee honee, AppCtx app_ctx, ProblemData problem); 284 285 PetscErrorCode QDataGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedElemRestriction elem_restr_x, CeedBasis basis_x, 286 CeedVector x_coord, CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 287 PetscErrorCode QDataGetNumComponents(DM dm, CeedInt *q_data_size); 288 PetscErrorCode QDataBoundaryGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedElemRestriction elem_restr_x, CeedBasis basis_x, 289 CeedVector x_coord, CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 290 PetscErrorCode QDataBoundaryGetNumComponents(DM dm, CeedInt *q_data_size); 291 PetscErrorCode QDataBoundaryGradientGetNumComponents(DM dm, CeedInt *q_data_size); 292 PetscErrorCode QDataBoundaryGradientGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedVector x_coord, 293 CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 294 PetscErrorCode QDataClearStoredData(); 295 // ----------------------------------------------------------------------------- 296 // Time-stepping functions 297 // ----------------------------------------------------------------------------- 298 PetscErrorCode RHS_NS(TS ts, PetscReal t, Vec Q, Vec G, void *user_data); 299 PetscErrorCode IFunction_NS(TS ts, PetscReal t, Vec Q, Vec Q_dot, Vec G, void *user_data); 300 PetscErrorCode TSMonitor_NS(TS ts, PetscInt step_no, PetscReal time, Vec Q, void *ctx); 301 PetscErrorCode TSSolve_NS(DM dm, Honee honee, AppCtx app_ctx, Physics phys, ProblemData problem, Vec Q, PetscScalar *f_time, TS *ts); 302 PetscErrorCode UpdateBoundaryValues(Honee honee, Vec Q_loc, PetscReal t); 303 304 // ----------------------------------------------------------------------------- 305 // Setup DM 306 // ----------------------------------------------------------------------------- 307 PetscErrorCode CreateDM(MPI_Comm comm, ProblemData problem, MatType, VecType, DM *dm); 308 PetscErrorCode SetUpDM(DM dm, ProblemData problem, PetscInt degree, PetscInt q_extra, Physics phys); 309 PetscErrorCode VizRefineDM(DM dm, Honee honee, ProblemData problem, Physics phys); 310 311 PetscErrorCode DMSetupByOrderBegin_FEM(PetscBool setup_faces, PetscBool setup_coords, PetscInt degree, PetscInt coord_order, PetscInt q_extra, 312 PetscInt num_fields, const PetscInt *field_sizes, DM dm); 313 PetscErrorCode DMSetupByOrderEnd_FEM(PetscBool setup_coords, DM dm); 314 PetscErrorCode DMSetupByOrder_FEM(PetscBool setup_faces, PetscBool setup_coords, PetscInt degree, PetscInt coord_order, PetscInt q_extra, 315 PetscInt num_fields, const PetscInt *field_sizes, DM dm); 316 317 // ----------------------------------------------------------------------------- 318 // Process command line options 319 // ----------------------------------------------------------------------------- 320 PetscErrorCode ProcessCommandLineOptions(Honee honee); 321 PetscErrorCode HoneeOptionsSetValueDefault(PetscOptions options, const char name[], const char value[]); 322 323 // ----------------------------------------------------------------------------- 324 // Miscellaneous utility functions 325 // ----------------------------------------------------------------------------- 326 PetscErrorCode GetInverseMultiplicity(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, PetscInt height, PetscInt dm_field, 327 PetscBool get_global_multiplicity, CeedElemRestriction *elem_restr_inv_multiplicity, 328 CeedVector *inv_multiplicity); 329 PetscErrorCode ICs_FixMultiplicity(DM dm, Honee honee, Vec Q_loc, Vec Q, CeedScalar time); 330 331 PetscErrorCode DMPlexInsertBoundaryValues_FromICs(DM dm, PetscBool insert_essential, Vec Q_loc, PetscReal time, Vec face_geom_FVM, Vec cell_geom_FVM, 332 Vec grad_FVM); 333 334 PetscErrorCode RegressionTest(AppCtx app_ctx, Vec Q); 335 PetscErrorCode PrintError(DM dm, Honee honee, Vec Q, PetscScalar final_time); 336 PetscErrorCode PostProcess(TS ts, DM dm, ProblemData problem, Honee honee, Vec Q, PetscScalar final_time); 337 PetscErrorCode SetBCsFromICs(DM dm, Vec Q, Vec Q_loc); 338 PetscErrorCode HoneeMassQFunctionCreate(Ceed ceed, CeedInt N, CeedInt q_data_size, CeedQFunction *qf); 339 PetscErrorCode HoneeCalculateDomainSize(Honee honee, PetscScalar *volume); 340 341 // ----------------------------------------------------------------------------- 342 // Turbulence Statistics Collection Functions 343 // ----------------------------------------------------------------------------- 344 PetscErrorCode SpanwiseStatisticsSetup_Turbulence(TS ts, PetscViewerAndFormat *ctx); 345 PetscErrorCode TSMonitor_TurbulenceSpanwiseStatistics(TS ts, PetscInt steps, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 346 347 // ----------------------------------------------------------------------------- 348 // Data-Driven Subgrid Stress (DD-SGS) Modeling Functions 349 // ----------------------------------------------------------------------------- 350 PetscErrorCode SgsDDSetup(Ceed ceed, Honee honee, ProblemData problem); 351 PetscErrorCode SgsDDApplyIFunction(Honee honee, const Vec Q_loc, Vec G_loc); 352 PetscErrorCode VelocityGradientProjectionSetup(Ceed ceed, Honee honee, ProblemData problem, StateVariable state_var_input, 353 CeedElemRestriction elem_restr_input, CeedBasis basis_input, NodalProjectionData *pgrad_velo_proj); 354 PetscErrorCode VelocityGradientProjectionApply(NodalProjectionData grad_velo_proj, Vec Q_loc, Vec VelocityGradient); 355 PetscErrorCode GridAnisotropyTensorProjectionSetupApply(Ceed ceed, Honee honee, CeedElemRestriction *elem_restr_grid_aniso, 356 CeedVector *grid_aniso_vector); 357 PetscErrorCode GridAnisotropyTensorCalculateCollocatedVector(Ceed ceed, Honee honee, CeedElemRestriction *elem_restr_grid_aniso, 358 CeedVector *aniso_colloc_ceed, PetscInt *num_comp_aniso); 359 360 // ----------------------------------------------------------------------------- 361 // Boundary Condition Related Functions 362 // ----------------------------------------------------------------------------- 363 PetscErrorCode SetupStrongBC_Ceed(Ceed ceed, DM dm, Honee honee, ProblemData problem); 364 PetscErrorCode FreestreamBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, NewtonianIdealGasContext newtonian_ig_ctx, 365 const StatePrimitive *reference); 366 PetscErrorCode OutflowBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, NewtonianIdealGasContext newtonian_ig_ctx, 367 const StatePrimitive *reference); 368 PetscErrorCode SlipBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, CeedQFunctionContext newtonian_ig_qfctx); 369 370 // ----------------------------------------------------------------------------- 371 // SGS Data-Driven Training via SmartSim 372 // ----------------------------------------------------------------------------- 373 PetscErrorCode SGS_DD_TrainingSetup(Ceed ceed, Honee honee, ProblemData problem); 374 PetscErrorCode TSMonitor_SGS_DD_Training(TS ts, PetscInt step_num, PetscReal solution_time, Vec Q, void *ctx); 375 PetscErrorCode TSPostStep_SGS_DD_Training(TS ts); 376 377 // ----------------------------------------------------------------------------- 378 // Divergence of Diffusive Flux Projection 379 // ----------------------------------------------------------------------------- 380 PetscErrorCode DivDiffFluxProjectionCreate(Honee honee, PetscInt num_diff_flux_comps, DivDiffFluxProjectionData *pdiff_flux_proj); 381 PetscErrorCode DivDiffFluxProjectionGetOperatorFieldData(DivDiffFluxProjectionData diff_flux_proj, CeedElemRestriction *elem_restr, CeedBasis *basis, 382 CeedVector *vector, CeedEvalMode *eval_mode); 383 PetscErrorCode DivDiffFluxProjectionSetup(Honee honee, DivDiffFluxProjectionData diff_flux_proj); 384 PetscErrorCode DivDiffFluxProjectionApply(DivDiffFluxProjectionData diff_flux_proj, Vec Q_loc); 385 PetscErrorCode DivDiffFluxProjectionDataDestroy(DivDiffFluxProjectionData diff_flux_proj); 386 387 PetscErrorCode SetupMontiorTotalKineticEnergy(TS ts, PetscViewerAndFormat *ctx); 388 PetscErrorCode TSMonitor_TotalKineticEnergy(TS ts, PetscInt steps, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 389 390 PetscErrorCode SetupMontiorCfl(TS ts, PetscViewerAndFormat *ctx); 391 PetscErrorCode TSMonitor_Cfl(TS ts, PetscInt step, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 392 393 PetscErrorCode KSPPostSolve_Honee(KSP ksp, Vec rhs, Vec x, void *ctx); 394