xref: /libCEED/examples/fluids/src/cloptions.c (revision de5900ad930acb4ffbfd4fefff9b361323ec9a15)
1 // Copyright (c) 2017-2022, Lawrence Livermore National Security, LLC and other CEED contributors.
2 // All Rights Reserved. See the top-level LICENSE and NOTICE files for details.
3 //
4 // SPDX-License-Identifier: BSD-2-Clause
5 //
6 // This file is part of CEED:  http://github.com/ceed
7 
8 /// @file
9 /// Command line option processing for Navier-Stokes example using PETSc
10 
11 #include <petscdevice.h>
12 
13 #include "../navierstokes.h"
14 
15 // Register problems to be available on the command line
16 PetscErrorCode RegisterProblems_NS(AppCtx app_ctx) {
17   app_ctx->problems = NULL;
18   PetscFunctionBeginUser;
19 
20   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "density_current", NS_DENSITY_CURRENT));
21   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "euler_vortex", NS_EULER_VORTEX));
22   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "shocktube", NS_SHOCKTUBE));
23   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "advection", NS_ADVECTION));
24   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "advection2d", NS_ADVECTION2D));
25   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "blasius", NS_BLASIUS));
26   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "channel", NS_CHANNEL));
27   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "newtonian_wave", NS_NEWTONIAN_WAVE));
28   PetscCall(PetscFunctionListAdd(&app_ctx->problems, "newtonian", NS_NEWTONIAN_IG));
29 
30   PetscFunctionReturn(0);
31 }
32 
33 // Process general command line options
34 PetscErrorCode ProcessCommandLineOptions(MPI_Comm comm, AppCtx app_ctx, SimpleBC bc) {
35   PetscBool ceed_flag    = PETSC_FALSE;
36   PetscBool problem_flag = PETSC_FALSE;
37   PetscBool option_set   = PETSC_FALSE;
38 
39   PetscFunctionBeginUser;
40 
41   PetscOptionsBegin(comm, NULL, "Navier-Stokes in PETSc with libCEED", NULL);
42 
43   PetscCall(PetscOptionsString("-ceed", "CEED resource specifier", NULL, app_ctx->ceed_resource, app_ctx->ceed_resource,
44                                sizeof(app_ctx->ceed_resource), &ceed_flag));
45 
46   app_ctx->test_type = TESTTYPE_NONE;
47   PetscCall(PetscOptionsEnum("-test_type", "Type of test to run", NULL, TestTypes, (PetscEnum)(app_ctx->test_type), (PetscEnum *)&app_ctx->test_type,
48                              NULL));
49 
50   app_ctx->test_tol = 1E-11;
51   PetscCall(PetscOptionsScalar("-compare_final_state_atol", "Test absolute tolerance", NULL, app_ctx->test_tol, &app_ctx->test_tol, NULL));
52 
53   PetscCall(PetscOptionsString("-compare_final_state_filename", "Test filename", NULL, app_ctx->test_file_path, app_ctx->test_file_path,
54                                sizeof(app_ctx->test_file_path), NULL));
55 
56   PetscCall(PetscOptionsFList("-problem", "Problem to solve", NULL, app_ctx->problems, app_ctx->problem_name, app_ctx->problem_name,
57                               sizeof(app_ctx->problem_name), &problem_flag));
58 
59   app_ctx->viz_refine = 0;
60   PetscCall(PetscOptionsInt("-viz_refine", "Regular refinement levels for visualization", NULL, app_ctx->viz_refine, &app_ctx->viz_refine, NULL));
61 
62   app_ctx->checkpoint_interval = 10;
63   app_ctx->checkpoint_vtk      = PETSC_FALSE;
64   PetscCall(PetscOptionsDeprecated("-output_freq", "-checkpoint_interval", "libCEED 0.11.1", "Use -checkpoint_vtk true to include VTK output"));
65   PetscCall(PetscOptionsInt("-output_freq", "Frequency of output, in number of steps", NULL, app_ctx->checkpoint_interval,
66                             &app_ctx->checkpoint_interval, &option_set));
67   if (option_set) app_ctx->checkpoint_vtk = PETSC_TRUE;
68   PetscCall(PetscOptionsInt("-checkpoint_interval", "Frequency of output, in number of steps", NULL, app_ctx->checkpoint_interval,
69                             &app_ctx->checkpoint_interval, NULL));
70   PetscCall(PetscOptionsBool("-checkpoint_vtk", "Include VTK (*.vtu) output at each binary checkpoint", NULL, app_ctx->checkpoint_vtk,
71                              &app_ctx->checkpoint_vtk, NULL));
72 
73   PetscCall(PetscOptionsBool("-output_add_stepnum2bin", "Add step number to the binary outputs", NULL, app_ctx->add_stepnum2bin,
74                              &app_ctx->add_stepnum2bin, NULL));
75 
76   PetscCall(PetscStrncpy(app_ctx->output_dir, ".", 2));
77   PetscCall(PetscOptionsString("-output_dir", "Output directory", NULL, app_ctx->output_dir, app_ctx->output_dir, sizeof(app_ctx->output_dir), NULL));
78 
79   app_ctx->cont_steps = 0;
80   PetscCall(PetscOptionsInt("-continue", "Continue from previous solution", NULL, app_ctx->cont_steps, &app_ctx->cont_steps, NULL));
81 
82   PetscCall(PetscStrcpy(app_ctx->cont_file, "[output_dir]/ns-solution.bin"));
83   PetscCall(PetscOptionsString("-continue_filename", "Filename to get initial condition from", NULL, app_ctx->cont_file, app_ctx->cont_file,
84                                sizeof(app_ctx->cont_file), &option_set));
85   if (!option_set) PetscCall(PetscSNPrintf(app_ctx->cont_file, sizeof app_ctx->cont_file, "%s/ns-solution.bin", app_ctx->output_dir));
86   if (option_set && app_ctx->cont_steps == 0) app_ctx->cont_steps = -1;  // Read time from file
87 
88   PetscCall(PetscStrcpy(app_ctx->cont_time_file, "[output_dir]/ns-time.bin"));
89   PetscCall(PetscOptionsString("-continue_time_filename", "Filename to get initial condition time from", NULL, app_ctx->cont_time_file,
90                                app_ctx->cont_time_file, sizeof(app_ctx->cont_time_file), &option_set));
91   if (!option_set) PetscCall(PetscSNPrintf(app_ctx->cont_time_file, sizeof app_ctx->cont_time_file, "%s/ns-time.bin", app_ctx->output_dir));
92 
93   app_ctx->degree = 1;
94   PetscCall(PetscOptionsInt("-degree", "Polynomial degree of finite elements", NULL, app_ctx->degree, &app_ctx->degree, NULL));
95 
96   app_ctx->q_extra = 0;
97   PetscCall(PetscOptionsInt("-q_extra", "Number of extra quadrature points", NULL, app_ctx->q_extra, &app_ctx->q_extra, NULL));
98 
99   {
100     PetscBool option_set;
101     char      amat_type[256] = "";
102     PetscCall(PetscOptionsFList("-amat_type", "Set the type of Amat distinct from Pmat (-dm_mat_type)", NULL, MatList, amat_type, amat_type,
103                                 sizeof(amat_type), &option_set));
104     if (option_set) PetscCall(PetscStrallocpy(amat_type, (char **)&app_ctx->amat_type));
105   }
106   PetscCall(PetscOptionsBool("-pmat_pbdiagonal", "Assemble only point-block diagonal for Pmat", NULL, app_ctx->pmat_pbdiagonal,
107                              &app_ctx->pmat_pbdiagonal, NULL));
108 
109   // Provide default ceed resource if not specified
110   if (!ceed_flag) {
111     const char *ceed_resource = "/cpu/self";
112     strncpy(app_ctx->ceed_resource, ceed_resource, 10);
113   }
114   // If we request a GPU, make sure PETSc has initialized its device (which is
115   // MPI-aware in case multiple devices are available) before CeedInit so that
116   // PETSc and libCEED agree about which device to use.
117   if (strncmp(app_ctx->ceed_resource, "/gpu", 4) == 0) PetscCall(PetscDeviceInitialize(PETSC_DEVICE_DEFAULT()));
118 
119   // Provide default problem if not specified
120   if (!problem_flag) {
121     const char *problem_name = "density_current";
122     strncpy(app_ctx->problem_name, problem_name, 16);
123   }
124 
125   // Wall Boundary Conditions
126   bc->num_wall = 16;
127   PetscBool flg;
128   PetscCall(PetscOptionsIntArray("-bc_wall", "Face IDs to apply wall BC", NULL, bc->walls, &bc->num_wall, NULL));
129   bc->num_comps = 5;
130   PetscCall(PetscOptionsIntArray("-wall_comps", "An array of constrained component numbers", NULL, bc->wall_comps, &bc->num_comps, &flg));
131   // Slip Boundary Conditions
132   for (PetscInt j = 0; j < 3; j++) {
133     bc->num_slip[j] = 16;
134     PetscBool   flg;
135     const char *flags[3] = {"-bc_slip_x", "-bc_slip_y", "-bc_slip_z"};
136     PetscCall(PetscOptionsIntArray(flags[j], "Face IDs to apply slip BC", NULL, bc->slips[j], &bc->num_slip[j], &flg));
137     if (flg) bc->user_bc = PETSC_TRUE;
138   }
139 
140   // Error if wall and slip BCs are set on the same face
141   if (bc->user_bc)
142     for (PetscInt c = 0; c < 3; c++)
143       for (PetscInt s = 0; s < bc->num_slip[c]; s++)
144         for (PetscInt w = 0; w < bc->num_wall; w++)
145           if (bc->slips[c][s] == bc->walls[w])
146             SETERRQ(PETSC_COMM_SELF, PETSC_ERR_ARG_WRONG, "Boundary condition already set on face %" PetscInt_FMT "!\n", bc->walls[w]);
147 
148   // Inflow BCs
149   bc->num_inflow = 16;
150   PetscCall(PetscOptionsIntArray("-bc_inflow", "Face IDs to apply inflow BC", NULL, bc->inflows, &bc->num_inflow, NULL));
151   // Outflow BCs
152   bc->num_outflow = 16;
153   PetscCall(PetscOptionsIntArray("-bc_outflow", "Face IDs to apply outflow BC", NULL, bc->outflows, &bc->num_outflow, NULL));
154   // Freestream BCs
155   bc->num_freestream = 16;
156   PetscCall(PetscOptionsIntArray("-bc_freestream", "Face IDs to apply freestream BC", NULL, bc->freestreams, &bc->num_freestream, NULL));
157 
158   // Statistics Options
159   app_ctx->turb_spanstats_collect_interval = 1;
160   PetscCall(PetscOptionsInt("-ts_monitor_turbulence_spanstats_collect_interval", "Number of timesteps between statistics collection", NULL,
161                             app_ctx->turb_spanstats_collect_interval, &app_ctx->turb_spanstats_collect_interval, NULL));
162 
163   app_ctx->turb_spanstats_viewer_interval = -1;
164   PetscCall(PetscOptionsInt("-ts_monitor_turbulence_spanstats_viewer_interval", "Number of timesteps between statistics viewer writing", NULL,
165                             app_ctx->turb_spanstats_viewer_interval, &app_ctx->turb_spanstats_viewer_interval, NULL));
166 
167   PetscCall(PetscOptionsViewer("-ts_monitor_turbulence_spanstats_viewer", "Viewer for the statistics", NULL, &app_ctx->turb_spanstats_viewer,
168                                &app_ctx->turb_spanstats_viewer_format, &app_ctx->turb_spanstats_enable));
169 
170   PetscOptionsEnd();
171 
172   PetscFunctionReturn(0);
173 }
174