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 PetscErrorCode PrintRunInfo(Honee honee, Physics phys_ctx, ProblemData problem, TS ts); 272 273 // ----------------------------------------------------------------------------- 274 // libCEED functions 275 // ----------------------------------------------------------------------------- 276 PetscErrorCode SetupLibceed(Ceed ceed, DM dm, Honee honee, AppCtx app_ctx, ProblemData problem); 277 278 PetscErrorCode QDataGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedElemRestriction elem_restr_x, CeedBasis basis_x, 279 CeedVector x_coord, CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 280 PetscErrorCode QDataGetNumComponents(DM dm, CeedInt *q_data_size); 281 PetscErrorCode QDataBoundaryGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedElemRestriction elem_restr_x, CeedBasis basis_x, 282 CeedVector x_coord, CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 283 PetscErrorCode QDataBoundaryGetNumComponents(DM dm, CeedInt *q_data_size); 284 PetscErrorCode QDataBoundaryGradientGetNumComponents(DM dm, CeedInt *q_data_size); 285 PetscErrorCode QDataBoundaryGradientGet(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, CeedVector x_coord, 286 CeedElemRestriction *elem_restr_qd, CeedVector *q_data, CeedInt *q_data_size); 287 PetscErrorCode QDataClearStoredData(); 288 // ----------------------------------------------------------------------------- 289 // Time-stepping functions 290 // ----------------------------------------------------------------------------- 291 PetscErrorCode TSSolve_NS(DM dm, Honee honee, AppCtx app_ctx, Physics phys, ProblemData problem, Vec Q, PetscScalar *f_time, TS *ts); 292 PetscErrorCode UpdateBoundaryValues(Honee honee, Vec Q_loc, PetscReal t); 293 294 // ----------------------------------------------------------------------------- 295 // Setup DM 296 // ----------------------------------------------------------------------------- 297 PetscErrorCode CreateDM(MPI_Comm comm, ProblemData problem, MatType, VecType, DM *dm); 298 PetscErrorCode SetUpDM(DM dm, ProblemData problem, PetscInt degree, PetscInt q_extra, Physics phys); 299 PetscErrorCode VizRefineDM(DM dm, Honee honee, ProblemData problem, Physics phys); 300 301 PetscErrorCode DMSetupByOrderBegin_FEM(PetscBool setup_faces, PetscBool setup_coords, PetscInt degree, PetscInt coord_order, PetscInt q_extra, 302 PetscInt num_fields, const PetscInt *field_sizes, DM dm); 303 PetscErrorCode DMSetupByOrderEnd_FEM(PetscBool setup_coords, DM dm); 304 PetscErrorCode DMSetupByOrder_FEM(PetscBool setup_faces, PetscBool setup_coords, PetscInt degree, PetscInt coord_order, PetscInt q_extra, 305 PetscInt num_fields, const PetscInt *field_sizes, DM dm); 306 307 // ----------------------------------------------------------------------------- 308 // Process command line options 309 // ----------------------------------------------------------------------------- 310 PetscErrorCode ProcessCommandLineOptions(Honee honee); 311 PetscErrorCode HoneeOptionsSetValueDefault(PetscOptions options, const char name[], const char value[]); 312 313 // ----------------------------------------------------------------------------- 314 // Miscellaneous utility functions 315 // ----------------------------------------------------------------------------- 316 PetscErrorCode GetInverseMultiplicity(Ceed ceed, DM dm, DMLabel domain_label, PetscInt label_value, PetscInt height, PetscInt dm_field, 317 PetscBool get_global_multiplicity, CeedElemRestriction *elem_restr_inv_multiplicity, 318 CeedVector *inv_multiplicity); 319 PetscErrorCode ICs_FixMultiplicity(DM dm, Honee honee, Vec Q_loc, Vec Q, CeedScalar time); 320 321 PetscErrorCode DMPlexInsertBoundaryValues_FromICs(DM dm, PetscBool insert_essential, Vec Q_loc, PetscReal time, Vec face_geom_FVM, Vec cell_geom_FVM, 322 Vec grad_FVM); 323 324 PetscErrorCode RegressionTest(AppCtx app_ctx, Vec Q); 325 PetscErrorCode PrintError(DM dm, Honee honee, Vec Q, PetscScalar final_time); 326 PetscErrorCode PostProcess(TS ts, DM dm, ProblemData problem, Honee honee, Vec Q, PetscScalar final_time); 327 PetscErrorCode SetBCsFromICs(DM dm, Vec Q, Vec Q_loc); 328 PetscErrorCode HoneeMassQFunctionCreate(Ceed ceed, CeedInt N, CeedInt q_data_size, CeedQFunction *qf); 329 PetscErrorCode HoneeCalculateDomainSize(Honee honee, PetscScalar *volume); 330 331 // ----------------------------------------------------------------------------- 332 // Turbulence Statistics Collection Functions 333 // ----------------------------------------------------------------------------- 334 PetscErrorCode SpanwiseStatisticsSetup_Turbulence(TS ts, PetscViewerAndFormat *ctx); 335 PetscErrorCode TSMonitor_TurbulenceSpanwiseStatistics(TS ts, PetscInt steps, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 336 337 // ----------------------------------------------------------------------------- 338 // Data-Driven Subgrid Stress (DD-SGS) Modeling Functions 339 // ----------------------------------------------------------------------------- 340 PetscErrorCode SgsDDSetup(Ceed ceed, Honee honee, ProblemData problem); 341 PetscErrorCode SgsDDApplyIFunction(Honee honee, const Vec Q_loc, Vec G_loc); 342 PetscErrorCode VelocityGradientProjectionSetup(Ceed ceed, Honee honee, ProblemData problem, StateVariable state_var_input, 343 CeedElemRestriction elem_restr_input, CeedBasis basis_input, NodalProjectionData *pgrad_velo_proj); 344 PetscErrorCode VelocityGradientProjectionApply(NodalProjectionData grad_velo_proj, Vec Q_loc, Vec VelocityGradient); 345 PetscErrorCode GridAnisotropyTensorProjectionSetupApply(Ceed ceed, Honee honee, CeedElemRestriction *elem_restr_grid_aniso, 346 CeedVector *grid_aniso_vector); 347 PetscErrorCode GridAnisotropyTensorCalculateCollocatedVector(Ceed ceed, Honee honee, CeedElemRestriction *elem_restr_grid_aniso, 348 CeedVector *aniso_colloc_ceed, PetscInt *num_comp_aniso); 349 350 // ----------------------------------------------------------------------------- 351 // Boundary Condition Related Functions 352 // ----------------------------------------------------------------------------- 353 PetscErrorCode SetupStrongBC_Ceed(Ceed ceed, DM dm, Honee honee, ProblemData problem); 354 PetscErrorCode FreestreamBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, NewtonianIdealGasContext newtonian_ig_ctx, 355 const StatePrimitive *reference); 356 PetscErrorCode OutflowBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, NewtonianIdealGasContext newtonian_ig_ctx, 357 const StatePrimitive *reference); 358 PetscErrorCode SlipBCSetup(BCDefinition bc_def, ProblemData problem, DM dm, void *ctx, CeedQFunctionContext newtonian_ig_qfctx); 359 360 // ----------------------------------------------------------------------------- 361 // SGS Data-Driven Training via SmartSim 362 // ----------------------------------------------------------------------------- 363 PetscErrorCode SGS_DD_TrainingSetup(Ceed ceed, Honee honee, ProblemData problem); 364 PetscErrorCode TSMonitor_SGS_DD_Training(TS ts, PetscInt step_num, PetscReal solution_time, Vec Q, void *ctx); 365 PetscErrorCode TSPostStep_SGS_DD_Training(TS ts); 366 367 // ----------------------------------------------------------------------------- 368 // Divergence of Diffusive Flux Projection 369 // ----------------------------------------------------------------------------- 370 PetscErrorCode DivDiffFluxProjectionCreate(Honee honee, PetscInt num_diff_flux_comps, DivDiffFluxProjectionData *pdiff_flux_proj); 371 PetscErrorCode DivDiffFluxProjectionGetOperatorFieldData(DivDiffFluxProjectionData diff_flux_proj, CeedElemRestriction *elem_restr, CeedBasis *basis, 372 CeedVector *vector, CeedEvalMode *eval_mode); 373 PetscErrorCode DivDiffFluxProjectionSetup(Honee honee, DivDiffFluxProjectionData diff_flux_proj); 374 PetscErrorCode DivDiffFluxProjectionApply(DivDiffFluxProjectionData diff_flux_proj, Vec Q_loc); 375 PetscErrorCode DivDiffFluxProjectionDataDestroy(DivDiffFluxProjectionData diff_flux_proj); 376 377 PetscErrorCode SetupMontiorTotalKineticEnergy(TS ts, PetscViewerAndFormat *ctx); 378 PetscErrorCode TSMonitor_TotalKineticEnergy(TS ts, PetscInt steps, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 379 380 PetscErrorCode SetupMontiorCfl(TS ts, PetscViewerAndFormat *ctx); 381 PetscErrorCode TSMonitor_Cfl(TS ts, PetscInt step, PetscReal solution_time, Vec Q, PetscViewerAndFormat *ctx); 382 383 PetscErrorCode KSPPostSolve_Honee(KSP ksp, Vec rhs, Vec x, void *ctx); 384