AFLR4 Option Details
aflr4 [input_arg_file_name] [aflr4_param_options] ------------------------------------------------------------------------------ AFLR4 : ADVANCING-FRONT/LOCAL-RECONNECTION UNSTRUCTURED SURFACE MESH GENERATOR ------------------------------------------------------------------------------ AFLR4 is a fully automatic unstructured 3D surface mesh generation code. It uses the Advancing-Front/Local-Reconnection (AFLR) procedure to generate a 3D surface mesh on multiple surfaces defined by either a CAD or discrete geometry definition. Distribution of the surface point spacing (length scale) is determined from an automated surface curvature driven process with proximity checking and localized spacing reduction. AFLR4 includes a full integration of functions for EGADS with Open CASCADE CAD. _______________________________________________________________________________ Input Parameters _______________________________________________________________________________ Input parameters, other than input "flag parameters", may be specified in any one of the following forms. param_name=param_value param_name param_value -param_name param_value Also, note that some input parameter names have synonyms and either one may be used. There are four basic types of parameters. Flag Parameters : Parameters that set multiple options and/or numeric parameters. They all are of the form -param_name and require use of a - prefix. A specified value may or may not be required. Option or ID Parameters : Parameters that set or control specific options, operation counts, or specify ID values. If a list of parameters are required, then the list must include parameters that are separated by commas. If there is only one parameter in a list then it must be terminated with a comma. A specified integer value or list of values is always required. Numeric Parameters : Parameters that set values for or adjust specific algorithms. If a list of parameters are required, then the list must include parameters that are separated by commas. If there is only one parameter in a list then it must be terminated with a comma. A specified floating-point value or list of values is always required. String Parameters : Parameters that set specific names for files and directories. String Parameters are typically Program Parameters. A specified character string value is always required. Parameters are sorted by type and typical frequency of usage in the following descriptions. Note that the majority of the following parameters are NOT typically used. This is particularly true of "Numeric Parameters". The following list also includes "Program Parameters" that are specific to execution of the main program. Program Parameters may be any of the previously described parameter types. They typically control I/O functions, are not ordered by rank, and are listed first in the following. PROGRAM CONTROL & I/O PARAMETERS ________________________________________________________________________________ -File_Status_Monitor --------------------- Turn on file status monitor. If the file status monitor is on, then an output message is generated each time a file is opened or modified. This is a program parameter. Equivalent to File_Status_Monitor_Flag=1 No parameter value should be specified. -Memory_Monitor ---------------- Turn on memory monitor. If the memory monitor is on and in summary output mode, then a summary message is generated at completion with the maximum memory allocated during execution and the final memory at completion (which should be 0). This is a program parameter. Equivalent to Memory_Monitor_Flag=1 No parameter value should be specified. -Memory_Monitor2 ----------------- Turn on memory monitor. If the memory monitor is on and in full output mode, then an output message is generated each time memory is allocated, re-allocated, or freed. This is a program parameter. Equivalent to Memory_Monitor_Flag=2 No parameter value should be specified. -build ------- List program version build number. This is a program parameter. No parameter value should be specified. -h --- List summary of input parameters. This is a program parameter. Equivalent to Help_Flag=1 No parameter value should be specified. -h_all ------- List summary of all input parameters. Including those that should not be changed. This is a program parameter. Equivalent to Help_Flag=3 No parameter value should be specified. -h_io ------ List summary of file I/O parameters. This is a program parameter. Equivalent to Help_UG_IO_Flag=1 No parameter value should be specified. -help ------ List documentation of input parameters. This is a program parameter. Equivalent to Help_Flag=2 No parameter value should be specified. -help_all ---------- List documentation of all input parameters. Including those that should not be changed. This is a program parameter. Equivalent to Help_Flag=4 No parameter value should be specified. -help_io --------- List documentation of file I/O parameters. This is a program parameter. Equivalent to Help_UG_IO_Flag=2 No parameter value should be specified. -out -log --------- Generate an output file. Send all output to a file named case_name.program_name.log. Standard output will go to both the file and standard output. Standard error output will go to both the file and standard error. This is a program parameter. Equivalent to Output_File_Flag=1 No parameter value should be specified. -out_a -log_a ------------- Append an output file. Send all output to a file named case_name.program_name.log. Standard output will go to both the file and standard output. Standard error output will go to both the file and standard error. If the file does not exist, then it will be created. This is a program parameter. Equivalent to Output_File_Flag=-1 No parameter value should be specified. -outf -logf ----------- Send output to a file only. Send all output to a file named case_name.program_name.log. Standard output will go to the file only. Standard error output will go to both the file and standard error. This is a program parameter. Equivalent to Output_File_Flag=2 No parameter value should be specified. -outf_a -logf_a --------------- Append output to a file only. Send all output to a file named case_name.program_name.log. Standard output will go to the file only. Standard error output will go to both the file and standard error. If the file does not exist, then it will be created. This is a program parameter. Equivalent to Output_File_Flag=-2 No parameter value should be specified. -ver ----- List program version number. This is a program parameter. No parameter value should be specified. -version --------- List program version information. This is a program parameter. No parameter value should be specified. Help_Flag ---------- List documentation of input parameters. If Help_Flag=-1, then list a short overview of input documentation. If Help_Flag=0, then do not list input documentation. If Help_Flag=1, then list summary of input parameters. If Help_Flag=2, then list documentation of input parameters. If Help_Flag=3, then list summary of all input parameters including those that should not be changed. If Help_Flag=4, then list documentation of all input parameters including those that should not be changed. This is a program parameter. default=0 min=-1 max=4 Help_UG_IO_Flag ---------------- List documentation of file I/O parameters. If Help_UG_IO_Flag=0, then do not list file I/O documentation. If Help_UG_IO_Flag=1, then list summary of file I/O parameters. If Help_UG_IO_Flag=2, then list documentation of file I/O parameters. This is a program parameter. default=0 min=0 max=2 Output_File_Flag ----------------- Output file flag. If Output_File_Flag=0, then send all output to only standard output or standard error. If Output_File_Flag=1, then send informational output to both standard output (or standard error) and a file named case_name.program_name.out. If Output_File_Flag=2, then send informational output to a file named case_name.program_name.out only. If Output_File_Flag=-1, then send and append informational output to both standard output (or standard error) and a file named case_name.program_name.out. If Output_File_Flag=-2, then send and append informational output to a file named case_name.program_name.out only. Error messages will always go to both the file (if any) and standard error. This is a program parameter. default=0 min=-2 max=2 -v --- Use executable in specified directory. If a full directory path is specified, then it is assumed that it contains an executable of the same name as currently running or that it contains a bin directory with the executable. The order of search is /new_ver_dir/base_executable_name /new_ver_dir/base_executable_name.exe /new_ver_dir/bin/base_executable_name /new_ver_dir/bin/base_executable_name.exe Where new_ver_dir is the name specified after the -v argument and base_executable is the name of the currently running executable without a .exe extension. If a partial directory path is specified, then it is assumed that the directory is under the same tree as the directory for the currently running executable or the users home directory. If the executable is in the root directory, then only the home directory is checked. The order of search is /base_current_exe_dir/new_ver_dir/base_executable_name /base_current_exe_dir/new_ver_dir/base_executable_name.exe /base_current_exe_dir/new_ver_dir/bin/base_executable_name /base_current_exe_dir/new_ver_dir/bin/base_executable_name.exe HOME/new_ver_dir/base_executable_name HOME/new_ver_dir/base_executable_name.exe HOME/new_ver_dir/bin/base_executable_name HOME/new_ver_dir/bin/base_executable_name.exe Where new_ver_dir is the name specified after the -v argument, base_executable is the name of the currently running executable without a .exe extension, and base_current_exe_dir is the current base directory. The base directory is derived from the currently running executable path if it is base_current_exe_dir/executable_name or if it is base_current_exe_dir/bin/executable_name. In all cases the first path found to exist is used. On WINDOWS the directories searched are all assumed to reside on the same drive as the currently running executable. If it is not, then the new_ver_dir must be fully specified including the drive letter, making this option somewhat useless. This is a program parameter. default= Arg_File_Name -arg ------------------ Input argument file name. Specifies the full file name for the input argument file. This file is simply a list of command line arguments (one per line). A # anywhere in a line denotes that the line is a comment and will not be interpreted. An argument file named case_name.program_name.arg is generated each time the program runs successfully. Specifying the file allows for re-running a case with the same arguments. Additional input arguments can be added to the command line. If the file name is specified, then it must exist and a copy of it will be saved with a .bak suffix added if the program runs successfully. Note that from a command line this option can be specified as simply the name of the input parameter file if it is the only argument and if it has the standard .arg suffix. Otherwise it can only be specified, like other parameters, using the option flag followed by the name. This is a program parameter. default= Input_File_Name -i -cad -igrid -case ------------------------------------ Input CAD file case name or file name or input CAD file name. Specifies either the case name or full file name for the input CAD file. Alternatively, specifies either the case name or full file name for the input grid file. See the UG_IO description on file naming for more information. Note that if only a case name is specified, then an input CAD file is searched for first. If no suitable CAD file type is found, then an input grid file is searched for. This is a program parameter. default= Output_Grid_File_Name -o -ogrid ------------------------------- Output grid file name or suffix. Specifies either the full file name or file name suffix for the output grid file. See the UG_IO description on file naming for more information. If Output_Grid_File=_null_, then do not write an output grid file. This is a program parameter. default=.meshb TMP_File_Dir -tmp ----------------- Temporary file directory. If TMP_File_Dir is set, then all temporary files are created in directory TMP_File_Dir. This directory is removed at completion of the job. If program execution is abruptly terminated, then this directory and its contents may be left behind and not removed. This is a program parameter. default=_null_ FLAG PARAMETERS (OFTEN USED) ________________________________________________________________________________ -er_all -------- Use global edge mesh spacing refinement. Edge mesh spacing can be reduced on all surfaces based on the discontinuity level between adjacent surfaces with different IDs on both sides of the edge. For each edge the level of discontinuity is defined by the minimum and maximum discontinuity angles angerw1 and angerw2. The actual discontinuity angle determines the edge spacing refinement factor that varies between 0 (angle<=angerw1) and 1 (angle>=angerw2). This factor along with the edge refinement weight (erw_all or erw_list), original spacing, and refinement limit (er_lim) determine the final refined edge mesh spacing. Note that no modification is done to edges that belong to surfaces with a grid BC of farfield (ff_ids) or BL intersecting (bl_int_ids). Equivalent to mer_all=1 No parameter value should be specified. -np ---- Run in parallel processing mode using np processes. Run in parallel processing mode with the specified number of processes. Note that the default with this option is to use fork and shared memory. Equivalent to parallel_mode=1 nproc= Parameter value must be specified for the last equivalent parameter value. -quad ------ Generate a mixed quad/tria-face grid. With this option advancing-point point placement is used to generate right-angle tria-faces and, then tria-face pairs are combined to form quad-faces. Equivalent to mquad=1 mpp=3 No parameter value should be specified. OPTION PARAMETERS (OFTEN USED) ________________________________________________________________________________ BL_IDs -bl_ids -------------- List of IDs for BL Generating Solid surfaces. If the vector BL_IDs is set then the grid BC flag is set to a value specifying a BL Generating Solid surface for all faces with a surface ID in the list. For example, if the vector BL_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to BL Generating Solid surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. BL_Int_IDs -bl_ints -bl_int_ids -ints -int_ids ---------------------------------------------- List of IDs for BL Intersecting surfaces. If the vector BL_Int_IDs is set then the grid BC flag is set to a value specifying a BL Intersecting surface for all faces with a surface ID in the list. The surface mesh for BL Intersecting surfaces is regenerated to match the BL region. For example, if the vector BL_Int_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to BL Intersecting surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. FF_IDs -ffs -ff_ids ------------------- List of IDs to for FarField surfaces. If the vector FF_IDs is set then the grid BC flag is set to a value specifying a FarField surface for all faces with a surface ID in the list. For example, if the vector FF_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to FarField surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Std_IDs -stds -std_ids ---------------------- List of IDs to for Solid surfaces. If the vector STD_IDs is set then the grid BC flag is set to a value specifying a Solid surface for all faces with a surface ID in the list. For example, if the vector STD_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Solid surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_BL_IDs -trnsp_bl_ids -------------------------- List of IDs for BL Generating Transparent surfaces. If the vector Trnsp_BL_IDs is set then the grid BC flag is set to a value specifying a BL Generating Transparent surface for all faces with a surface ID in the list. For example, if the vector Trnsp_BL_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Transparent BL Generating surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_BL_Int_IDs -trnsp_bl_int_ids ---------------------------------- List of IDs for BL Intersecting Transparent surfaces. If the vector Trnsp_BL_Int_IDs is set then the grid BC flag is set to a value specifying a BL Intersecting Transparent surface for all faces with a surface ID in the list. For example, if the vector Trnsp_BL_Int_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Transparent BL Intersecting surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_IDs -trnsp_ids -------------------- List of IDs for Transparent surfaces. If the vector Trnsp_IDs is set then the grid BC flag is set to a value specifying a Transparent surface for all faces with a surface ID in the list. For example, if the vector Trnsp_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Transparent surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_Intl_BL_IDs -trnsp_intl_bl_ids ------------------------------------ List of IDs for BL Generating Internal Transparent surfaces. If the vector Trnsp_Intl_BL_IDs is set then the grid BC flag is set to a value specifying a BL Generating Internal Transparent surface for all faces with a surface ID in the list. For example, if the vector Trnsp_Intl_BL_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to BL Generating Internal Transparent surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_Intl_IDs -trnsp_intl_ids ------------------------------ List of IDs for Internal Transparent surfaces. If the vector Trnsp_Intl_IDs is set then the grid BC flag is set to a value specifying a Internal Transparent surface for all faces with a surface ID in the list. For example, if the vector Trnsp_Intl_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Internal Transparent surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Trnsp_Src_IDs -trnsp_src_ids ---------------------------- List of IDs for Transparent Source surfaces. If the vector Trnsp_Src_IDs is set then the grid BC flag is set to a value specifying a Transparent Source surface for all faces with a surface ID in the list. For example, if the vector Trnsp_Src_IDs is set to 2,5,6 then there are 3 entries in the vector and all faces with surface IDs 2, 5 or 6 will be set to Transparent Source surfaces. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. auto_set_ff_bc --------------- Automatic farfield grid BC flag. If auto_set_ff_bc=0, then no surface definitions will be automatically set to a farfield grid BC. If auto_set_ff_bc=1, then automatic farfield grid BC mode is active and AFLR4 will determine which body is the is the outermost and set the grid BC flag to farfield for all surface definitions of that body. If the input is a CAD geometry, or there is only one body, or a farfield grid BC is already set using BC options then automatic farfield grid BC mode is turned off (auto_set_ff_bc=0) and nothing is done. default=0 min=0 max=1 mer_all -------- Global edge mesh spacing refinement weight flag. Edge mesh spacing can be reduced on all surfaces based on the discontinuity level between adjacent surfaces with different IDs on both sides of the edge. For each edge the level of discontinuity is defined by the minimum and maximum discontinuity angles angerw1 and angerw2. The actual discontinuity angle determines the edge spacing refinement factor that varies between 0 (angle<=angerw1) and 1 (angle>=angerw2). This factor along with the edge refinement weight (erw_all or erw_list), original spacing, and refinement limit (er_lim) determine the final refined edge mesh spacing. Note that no modification is done to edges that belong to surfaces with a grid BC of farfield (ff_ids) or BL intersecting (bl_int_ids). default=0 min=0 max=1 nproc ------ Number of processes to use. If nproc > 1 and the parallel mode flag is on parallel_mode=1 or 2 then the process is a parallel process. Note that with MPI (parallel_mode=2) the startup command mpirun uses the -np option to set the number of processes, np, and internally this program sets nproc=np. default=1 min=1 max=1000000 parallel_mode -------------- Parallel processing mode flag. If parallel_mode = 0 then the processing mode is serial and the number of processors nproc=1. If parallel_mode = 1 then the processing mode is parallel using fork and shared memory. default=0 min=0 max=1 NUMERIC PARAMETERS (OFTEN USED) ________________________________________________________________________________ curv_angle ----------- Curvature spacing angle in degrees. For curvature refinement the spacing is derived from the curvature spacing angle and the curvature. Curvature = 1 / Curvature_Radius Spacing = [2*sin(curv_angle/2)] / Curvature For example, if the surface is circular and the curvature angle is 10 degrees, this will provide mesh points spaced every 10 degrees. If the Curvature is 0, then the surface is flat and the spacing is set to the maximum spacing (max_spacing = max_scale*ref_len). Note that the curvature based spacing may be overridden by constraints imposed by surface boundary edge lengths or adjacent surfaces. The curvature spacing angle curv_angle replaces the previous curvature factor curv_factor parameter. curv_factor = 2*sin(curv_angle/2) The default value for curv_angle produces a value for the previous curv_factor that is approximately the same as its default value. default=5.7 min=1e-06 max=90 ref_len -------- Reference length for components/bodies. Reference length for components/bodies in grid units. Reference length should be set to a physically relevant characteristic length for the configuration such as wing chord length or pipe diameter. If ref_len = 0, then it will be set to the minimum bounding box length for the components/bodies of interest. The reference length (ref_len) is used to set mesh spacing on surfaces, except farfield or symmetry plane surfaces, if any. default=0 min=0 max=1e+19 FLAG PARAMETERS (SOMETIMES USED) ________________________________________________________________________________ -add_ff -------- Add a box-shaped farfield definition to configuration. With farfield add-on active a box-shaped farfield geometry definition is added to the configuration. Equivalent to add_ff_geom=1 No parameter value should be specified. -add_ff2 --------- Add a rectangular-box-shaped farfield definition to configuration. With farfield add-on active a rectangular-box-shaped farfield geometry definition is added to the configuration. Equivalent to add_ff_geom=2 No parameter value should be specified. -ext ----- Use external sizing routine. Use external sizing routine with or without a background grid. If a site dependent specific routine is coded, compiled and linked with the executable, then this option is useful. If a background grid file and a background length-scale function file are found, then they are read for use in the external sizing evaluation routine. The background length-scale function file may contain either an isotropic sizing or a metric for directional sizing. Use whichever is allowed with for the external routine. By default, the built-in external sizing evaluation routine does not use a background grid. It is useful only for testing. Equivalent to meval=1 No parameter value should be specified. -met2 ------ Use metric space with advancing-front point placement. Use a metric space to determine all geometric quantities and use advancing-front point placement (equiangular type elements). Equivalent to mmet=1 mpp=2 No parameter value should be specified. -met3 ------ Use metric space with advancing-point point placement. Use a metric space to determine all geometric quantities and use advancing-point point placement (right angle type elements). Equivalent to mmet=1 mpp=3 No parameter value should be specified. OPTION PARAMETERS (SOMETIMES USED) ________________________________________________________________________________ BC_IDs bc_ids ------------- List of IDs to set grid BC parameters. If the BC_IDs and the Grid_BC_Flag parameter vectors are set then the grid BC flag is set for all faces with corresponding surface IDs. Only those IDs listed will have their corresponding values set. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. Grid_BC_Flag bc_list -------------------- List of grid BC flags to set. If the BC_IDs and the Grid_BC_Flag parameter vectors are set then the grid BC flag is set for all faces with corresponding surface IDs. Values for the Grid_BC_Flag and their meaning are listed below. 0 = FarField surface 1 = Solid surface -1 = BL Generating Solid surface 2 = BL Intersecting surface 3 = Source Transparent surface converted to source nodes 4 = BL Intersecting Transparent surface 5 = Transparent surface -5 = BL Generating Transparent surface 6 = Internal Transparent surface -6 = BL Generating Internal Transparent surface 7 = Fixed Surface with BL region that intersects BL region Note that 1) FarField and Solid surfaces behave the same during volume mesh generation, 2) all Transparent surfaces will have a volume mesh on both sides, and 3) Internal Transparent surfaces are converted to internal faces and their boundary face connectivity is not included in the final mesh. Commas are required between the grid BC flags in the list. If only one grid BC flag is specified then it must be terminated with a comma. add_ff_geom ------------ Farfield add-on flag. With farfield add-on active a box-shaped farfield geometry definition is added to the configuration. The farfield box is created with all sides set to length L determined from the configuration bounding-box multiplied by the farfield size factor. Where Lx = ff_size * (Xmax-Xmin) Ly = ff_size * (Ymax-Ymin) Lz = ff_size * (Zmax-Zmin) L = MAX (Lx, Ly, Lz) If add_ff_geom=2, then Lx, Ly, Lz are used to create a retangular box. Note that the option to automatically set farfield BCs (auto_set_ff_bc=1) is turned on when this option is on (add_ff_geom=1 or 2). default=0 min=0 max=2 cad_param_reset ---------------- CAD parameter reset flag. If cad_param_reset = 0, then attributes that are specified within the CAD geometry definition data structure will only be used. If cad_param_reset = 1, then attributes that are specified within the CAD geometry definition data structure will be ignored. default=0 min=0 max=1 cmp_ids -------- List of surface IDs to set as components. Proximity of components/bodies is used as a means to reduce the spacing locally, if needed, due to proximity (see auto_mode). Given cmp_ids id_1,id_2,...,id_n, then set component identifiers on surface definitions for id_1 id_2 ... id_n. Commas are required between the surface IDs in the list. If only one ID is specified, then it must be terminated with a comma. A component is one or more CAD surfaces that represent a component of the full configuration that should be treated individually. For example, a wing-body-strut-nacelle configuration could be considered as four components with wing surfaces set to component 1, body surfaces set to component 2, nacelle surfaces set to 3, and store surfaces set to 4 (proximity checking would be done between each). If each component is a topologically closed surface/body, then there is no need to set components. If component IDs are not specified, then component identifiers are set for each topologically closed surface/body of the overall configuration. cmp_list --------- List of component identifiers for each component/body specified. Proximity of components/bodies is used as a means to reduce the spacing locally, if needed, due to proximity (see auto_mode). Given cmp_ids id_1,id_2,...,id_n specified by cmp_ids along with cmp_list i_1,i_2,...,i_n specified by cmp_list identifiers, then set the component identifiers on the component identifiers specified. Commas are required between the component identifiers in the list. The number of entries in cmp_list and their order must match that of cmp_ids exactly. Component identifiers must be sequential varying from 1 to the number of components. Also, if components are specified, then there should at least two components with unique identifiers. If component IDs are not specified, then component identifiers are set for each topologically closed surface/body of the overall configuration. erw_ids -------- List of surface IDs to set edge mesh spacing refinement weight. Edge mesh spacing can be reduced on each surface specified based on discontinuity level between adjacent surfaces on both sides of the edge. Given erw_ids id_1,id_2,...,id_n, then set edge mesh spacing refinement weight on surfaces with IDs id_1 id_2 ... id_n. Commas are required between the surface IDs in the list. If only one ID is specified, then it must be terminated with a comma. See also -er_all, mer_all, erw_list, erw_all, er_lim, angerw1, and angerw2. Note that no modification is done to edges that belong to surfaces with a grid BC of farfield (ff_ids) or BL intersecting (bl_int_ids). esf_ids -------- List of edge IDs to set edge mesh spacing scale factor. Edge mesh spacing can be scaled on each edge specified. Given esf_ids id_1,id_2,...,id_n then set edge mesh spacing scale factor on edges with IDs id_1 id_2 ... id_n. Commas are required between the edge IDs in the list. If only one ID is specified then it must be terminated with a comma. malign ------- Metric alignment flag. If malign = 0, then do not use metric alignment. If malign = 1, then use metric alignment to create candidate nodes with advancing-point (mpp=3) and advancing-front (mpp=2) point placement. If malign = 2, then use metric alignment to create candidate nodes and for each candidate select either advancing-point or advancing-front point placement. This option is only applicable if the base point placement is advancing-front (mpp=2). Otherwise it is the same as malign=1. Only applicable if external sizing evaluation is used (meval!=0) or if the advancing-point point placement option is selected (mpp=3). Only applicable if the metric space option is on (mmet=1 or 2). default=1 min=0 max=2 merge_ids ---------- List of discrete geometry definition surface IDs to to merge. With discrete geometry definitions, adjacent surfaces can be merged into a single surface to eliminate restrictions imposed by internal boundary edges. Both a list of all surface IDs that are to be merged (merge_ids) and a list of the number of IDs per merge set (merge_sets) must be specified. For example, if merge_ids=2,7,14,3,27,1,9,11,12 and merge_sets=3,2,4 then merge the first 3 IDs in merge_ids (IDs=2,7,14) into merge set 1, merge the next 2 IDs in merge_ids (IDs=3,27), into merge set 2, and merge the next 4 IDs in merge_ids (IDs=1,9,11,12) into merge set 3. At least two surface IDs must be specified for each merge set. Surface IDs must match those used in the input surface definition. Each merge set is treated as a new surface definition that replaces the individual surfaces. The surface IDs for the merged surfaces are set sequentially starting after the largest input surface ID. Commas are required between all list entries. Note that merged surfaces are only applicable for discrete geometry definitions. merge_sets ----------- List of the number of IDs for each merge set. With discrete geometry definitions, adjacent surfaces can be merged into a single surface to eliminate restrictions imposed by internal boundary edges. Both a list of all surface IDs that are to be merged (merge_ids) and a list of the number of IDs per merge set (merge_sets) must be specified. For example, if merge_ids=2,7,14,3,27,1,9,11,12 and merge_sets=3,2,4 then merge the first 3 IDs in merge_ids (IDs=2,7,14) into merge set 1, merge the next 2 IDs in merge_ids (IDs=3,27), into merge set 2, and merge the next 4 IDs in merge_ids (IDs=1,9,11,12) into merge set 3. At least two surface IDs must be specified for each merge set. Surface IDs must match those used in the input surface definition. Each merge set is treated as a new surface definition that replaces the individual surfaces. The surface IDs for the merged surfaces are set sequentially starting after the largest input surface ID. Commas are required between all list entries. Note that merged surfaces are only applicable for discrete geometry definitions. min_ncell ---------- Minimum number of cells between two components/bodies. Proximity of components/bodies to each other is estimated and surface spacing is locally reduced if needed (see auto_mode). Local surface spacing is selectively reduced when components/bodies are close and their existing local surface spacing would generate less than the minimum number of cells specified by min_ncell. or if there is only one component/body defined. default=3 min=1 max=2000000000 sf_ids ------- List of surface IDs to set surface mesh spacing scale factor. Surface mesh spacing can be scaled on each surface specified. Given sf_ids id_1,id_2,...,id_n, then set surface mesh spacing scale factor on surfaces with IDs id_1 id_2 ... id_n. Commas are required between the surface IDs in the list. If only one ID is specified, then it must be terminated with a comma. NUMERIC PARAMETERS (SOMETIMES USED) ________________________________________________________________________________ BL_thickness -bl_del -------------------- Boundary layer thickness for proximity checking. Proximity of components/bodies to each other is estimated and surface spacing is locally reduced if needed. Note that if the Reynolds Number, Re_L, is set then the BL_thickness value is set to an estimate for turbulent flow. If the set or calculated value of BL_thickness>0, then the boundary layer thickness is included in the calculation for the required surface spacing during proximity checking. default=0 min=0 max=1e+12 Re_l -Re -------- Reynolds Number for estimating BL thickness, The Reynolds Number based on reference length, Re_l, (if set) along with reference length, ref_len, are used to estimate the BL thickness, BL_thickness, for turbulent flow. If Re_l>0, then this estimated value is used to set BL_thickness. default=0 min=0 max=1e+19 erw_all -------- Global edge mesh spacing refinement weight. Edge mesh spacing can be reduced on all surfaces (if mer_all=1) based on discontinuity level between adjacent surfaces on both sides of the edge. A refinement weight with a value of one applies the maximum modification and a value of zero applies no change in edge spacing. See also -er_all, mer_all, erw_ids. erw_list, er_lim, angerw1, and angerw2. Note that no modification is done to edges that belong to surfaces with a grid BC of farfield (ff_ids) or BL intersecting (bl_int_ids). Also, note that the global weight, erw_all, is not applicable if mer_all=0. default=0.8 min=0 max=1 erw_list --------- List of edge mesh spacing refinement weights. Edge mesh spacing can be reduced on each surface specified based on discontinuity level between adjacent surfaces on both sides of the edge. Given erw_ids id_1,id_2,...,id_n, then set edge mesh spacing refinement weight on surfaces with IDs id_1 id_2 ... id_n. Commas are required between the edge mesh spacing refinement weights in the list. The number of entries in erw_list and their order must match that of erw_ids exactly. If only one edge mesh spacing refinement weight is specified, then it must be terminated with a comma. The default value of the edge mesh spacing refinement weight for all surfaces not specified is 0.0. The maximum allowable value is 1.0. A value of one applies the maximum modification and a value of zero applies no change in edge spacing. See also -er_all, mer_all, erw_ids. erw_all, er_lim, angerw1, and angerw2. Note that no modification is done to edges that belong to surfaces with a grid BC of farfield (ff_ids) or BL intersecting (bl_int_ids). esf_list --------- List of edge mesh spacing scale factors. Edge mesh spacing can be scaled on each edge specified by esf_ids. Given esf_ids id_1,id_2,...,id_n specified by esf_ids then set the edge mesh spacing scale factor on the edges IDs specified. Commas are required between the edge mesh spacing scale factors in the list. The number of entries in esf_list and their order must match that of esf_ids exactly. If only one edge mesh spacing scale factor is specified then it must be terminated with a comma. The default value of the edge mesh spacing scale factor for all edges not specified is 1.0. The minimum value of the edge mesh spacing scale factor is limited by the value of sf_min and the maximum is limited by 1.0. Note that the edge IDs are the global edge index for the given CAD model definition. ff_cdfr -------- Farfield growth rate for field point spacing. The farfield spacing is set to a uniform value dependent upon the maximum size of the domain, maximum size of inner bodies, max and min body spacing, and farfield growth rate. ff_spacing = (ff_cdfr-1)*L/ff_cdfr where L is the approximate distance between inner bodies and farfield. default=1.3 min=1 max=10 ff_size -------- Farfield size factor. With farfield add-on active a box-shaped farfield geometry definition is added to the configuration. The farfield box is created with all sides set to length L determined from the configuration bounding-box multiplied by the farfield size factor. Where Lx = ff_size * (Xmax-Xmin) Ly = ff_size * (Ymax-Ymin) Lz = ff_size * (Zmax-Zmin) L = MAX (Lx, Ly, Lz) If add_ff_geom=2, then Lx, Ly, Lz are used to create a rectangular box. default=10 max_scale rel_max_sp -------------------- Relative maximum spacing. The relative maximum spacing (max_scale) is used along with the reference length (ref_len) to set the maximum spacing used for flat surfaces, except farfield or symmetry plane surfaces, if any. max_spacing = max_scale * ref_len default=0.1 min=1e-12 max=1 sf_global sf_all ---------------- Global surface mesh spacing scale factor. Surface mesh spacing can be scaled by a global scale factor given by sf_global. It can also be scaled independently on individual surfaces by setting the list of surface IDs and list of surface mesh spacing scale factors with parameters sf_ids and sf_list. With the global scale factor, the calculated spacing at all points is multiplied by the value of sf_global (if it is not equal to 1). Note that the surface mesh spacing scale factors sf_list are multiplied by the global spacing scale factor sf_global. default=1 min=0.001 max=1000 sf_list -------- List of surface mesh spacing scale factors. Surface mesh spacing can be scaled on each surface specified by sf_ids. Given sf_ids id_1,id_2,...,id_n specified by sf_ids, then set the surface mesh spacing scale factor on the surface IDs specified. Commas are required between the surface mesh spacing scale factors in the list. The number of entries in sf_list and their order must match that of sf_ids exactly. If only one surface mesh spacing scale factor is specified, then it must be terminated with a comma. The default value of the surface mesh spacing scale factor for all surfaces not specified is 1.0. The minimum value of the surface mesh spacing scale factor is limited by the value of sf_min. Note that the surface mesh spacing scale factors sf_list are multiplied by the global spacing scale factor sf_global. FLAG PARAMETERS (SELDOM USED) ________________________________________________________________________________ -no_prox --------- Disable proximity checking. Proximity checking is automatically disabled if there is only one component/body defined. Equivalent to auto_mode=1 No parameter value should be specified. OPTION PARAMETERS (SELDOM USED) ________________________________________________________________________________ Rec_IDs -rec_ids ---------------- List of IDs to reset Reconnection flag. If the Rec_IDs parameter vector is set then the reconnection flag is set to on, allowing reconnection in all directions, for all faces with a surface ID in the vector and it is set to off, allowing no reconnection, for all faces with a surface ID not in the vector. For example, if Rec_IDs is set to the vector 3,5,6 then there are 3 vector entries and all faces with surface IDs 3, 5, or 6 will be turned on and all others will be turned off. Note that this parameter is a simplified form of using the BC_IDs and Rec_Flag parameters. Commas are required between the surface IDs in the list. If only one ID is specified then it must be terminated with a comma. auto_mode ---------- Auto-spacing mode flag. If auto_mode = 0, then do not set surface mesh spacing automatically. Note that bounding curve curvature is always used to determine bounding curve spacing. If auto_mode = 1, then set surface mesh spacing automatically based on curvature. If auto_mode = 2, then set surface mesh spacing automatically based on curvature and modification of spacing with proximity checking. Proximity of components/bodies to each other is estimated and surface spacing is locally reduced if needed. Proximity checking is automatically disabled if there is only one component/body defined. default=2 min=0 max=2 create_tess ------------ Output CAD tess data creation flag, If create_tess = 0, then do not create output CAD tess data. If create_tess = 1, then create output CAD tess data. This data can be used in some systems that do additional processing of the CAD definition model. Only applicable with an EGADS CAD geometry definition. default=1 min=0 max=1 geom_mmsg ---------- Geometry definition output flag, If geom_mmsg = 0, then write limited geometry definition data. If geom_mmsg = 1, then write all geometry definition data. default=1 min=0 max=1 mier4 ------ Isolated edge refinement flag. If mier4 = -1, then do not refine isolated interior edges and set the local minimum number of segments on an individual curve (min_nseg=1). If mier4 = 0, then do not refine isolated interior edges. If mier4 = 1, then refine isolated interior edges if the surface has local curvature (as defined using cier). If mier4 = 2, then refine all isolated interior edges. An isolated interior edge is connected only to boundary nodes. Isolated edges are refined by placing a new node in the middle of the edge. default=1 min=0 max=2 mier_ids --------- List of surface IDs to set isolated edge refinement flag. Surfaces can each have a different isolated edge refinement flag. Any surfaces not set using this option will revert to the value of the isolated edge refinement flag mier4. See mier4 for more information. If the mier_list is also set, then the values in mier_list are used for the refinement flag on the surface specified by mier_ids. Given mier_ids id_1,id_2,...,id_n, then set refinement flag for surfaces with IDs id_1 id_2 ... id_n. Commas are required between the surface IDs in the list. If only one ID is specified, then it must be terminated with a comma. mier_list ---------- List of isolated edge refinement flags. Surfaces can each have a different isolated edge refinement flag. Any surfaces not set using this option will revert to the value of the isolated edge refinement flag mier4. See mier4 for more information. If both mier_ids and mier_list are set, then the values in mier_list are used for the refinement flag on the surface specified by mier_ids. Commas are required between the flags in the list. If only one flag is specified, then it must be terminated with a comma. mw_cad_def ----------- CAD definition file write flag, If mw_cad_def = 0, then do not output CAD definition data file. If mw_cad_def = 1, then write CAD definition data file. Only applicable with an EGADS CAD geometry definition. default=1 min=0 max=1 quad_ids --------- List of surface IDs for quad-face combination. Surfaces can be meshed with tria-faces only (default) or with quad-faces (quad-dominant with some tria-faces). This option can be set either globally for all surfaces using the quad-face combination flag, -quad or mquad=1, or locally on the surfaces specified in the list of IDs for quad-face combination. Given quad_ids id_1,id_2,...,id_n, then turn on quad-face mesh generation for surfaces with IDs id_1 id_2 ... id_n. Commas are required between the surface IDs in the list. If only one ID is specified, then it must be terminated with a comma. Applicable only if the global quad-face combination flag is not set. surf_gen_mmsg -------------- Surface mesh generation output flag, If surf_gen_mmsg = 0, then write limited surface mesh generation data. If surf_gen_mmsg = 1, then write all surface mesh generation data. default=1 min=0 max=1 NUMERIC PARAMETERS (SELDOM USED) ________________________________________________________________________________ er_lim ------- Edge mesh spacing refinement limit. The edge mesh spacing refinement limit (er_lim) sets the maximum level of refinement on edges using edge mesh refinement. The minimum edge spacing is set to the original edge mesh spacing multiplied by the edge mesh spacing refinement limit (er_lim). See also -er_all, mer_all, erw_ids. erw_list, erw_all, angerw1, and angerw2. default=0.001 min=1e-12 max=1 FLAG PARAMETERS (RARELY USED) ________________________________________________________________________________ -grow ------ Use specified growth in element size. Use specified growth in element size in a direction normal to the boundaries. Equivalent to mdf=2 cdfs=1.0 cdfr= Parameter value must be specified for the last equivalent parameter value. -grow1 ------- Use moderate growth in element size. Use moderate growth in element size in a direction normal to the boundaries. Equivalent to mdf=2 cdfs=1.0 cdfr=1.2 No parameter value should be specified. -grow2 ------- Use high growth in element size. Use high growth in element size in a direction normal to the boundaries. Equivalent to mdf=2 cdfs=0.5 cdfr=1.5 No parameter value should be specified. -grow3 ------- Use very high growth in element size. Use very high growth in element size in a direction normal to the boundaries. Equivalent to mdf=2 cdfs=0.0 cdfr=2.0 No parameter value should be specified. -open ------ Input configuration is open. Allow the input surface definition configurations to be open with one or more surface definitions. By default input surface definition configurations are assumed to be closed with all surface forming one or more bodies. Note that if the configuration is not closed, then proximity checking is turned off auto_mode<=1. Equivalent to mclosed=0 No parameter value should be specified. -skin ------ Input configuration has a structural skin topology. Allow the input surface definition configuration to be treated as one composed of a thin skin. This option will ignore the Grid BC values and treat each surface as a transparent surface that can be topologically open. By default the input configuration is assumed to be closed with all solid surfaces forming one or more bodies that may have internal transparent surface. Note that this option will produce a surface mesh that is not compatible with the AFLR3 volume mesh generator. Equivalent to skin_mode=1 No parameter value should be specified. OPTION PARAMETERS (RARELY USED) ________________________________________________________________________________ Message_Flag mmsg ----------------- Message flag. If Message_Flag = -1, then generate minimal one-line output messages. If Message_Flag = 0, then generate no output messages. If Message_Flag = 1, then generate normal output messages. If Message_Flag = 2, then generate all debug output messages. default=-1 min=-1 max=2 Rec_Flag --------- List of reconnection flags to reset. If the BC_IDs and Rec_Flag parameter vectors are set then the reconnection flag is reset to the values in the Rec_Flag vector for all faces with corresponding surface IDs. Reconnection of surface faces is used to assist boundary recovery and eliminate boundary sliver elements. Values for the Rec_Flag and their meaning for tria faces are listed below. However only the values 0 (reconnection allowed) or 7 (reconnection not allowed) are practical in general usage. The intermediate values are typically set internally based on curvature, quality and neighbor ID. For quad faces the Rec_Flag is ignored and the outer edges of the quad faces are always preserved. The neighbor faces referenced below are for a tria face connectivity ordered node 1, 2, 3. 0 = reconnection allowed with any neighbor 1 = reconnection not allowed with neighbor opposite node 1 2 = reconnection not allowed with neighbor opposite node 2 3 = reconnection not allowed with neighbor opposite node 1 or 2 4 = reconnection not allowed with neighbor opposite node 3 5 = reconnection not allowed with neighbor opposite node 3 or 1 6 = reconnection not allowed with neighbor opposite node 3 or 2 7 = reconnection not allowed with any neighbor Note that regardless of the Rec_Flag value no reconnection is allowed between faces of differing surface IDs or between faces that would result in discontinuity or poor quality as defined by angrbfdd, angrbfdd2, and angrbfmxp. Typically the reconnection flag is set to 0 or 7. The Rec_Flag should be set to 0 unless a value of 7 is required to match another domain. Commas are required between the reconnection flags in the list. If only one reconnection flag is specified then it must be terminated with a comma. The default is 0 if not set within the input surface grid. high_order_eval ---------------- Discrete geometry high-order evaluation flag. If high_order_eval = 0, then evaluate discrete geometry using a linear approximation. If high_order_eval = 1, then evaluate discrete geometry using a high-order approximation. default=1 min=0 max=1 keep_bodies ------------ List of input body IDs to keep. The bodies included in the input configuration can be edited. Given keep_bodies id_1,id_2,...,id_n, then keep bodies with IDs id_1 id_2 ... id_n and remove all others. Note that a list of bodies can also be removed by specifying them with the rm_bodies option. Only use keep_bodies or rm_bodies or neither. Note that if the input configuration is edited and the reference length (ref_len) is not set, then reference length is based on the bounding box for the active bodies kept and not the full input configuration. Also, if the input configuration is edited, then the closed configuration flag is turned off mclosed=0. Commas are required between the body IDs in the list. If only one ID is specified, then it must be terminated with a comma. m_arearchk ----------- Output area ratio check flag. If m_arearchk = 0, then do not check area ratio between faces. If m_arearchk = 1, then check area ratio between faces. default=0 min=0 max=1 mclosed -------- Input configuration open/closed flag. If mclosed = 0, then allow the input surface definition configurations to be open with one or more surface definitions. Note that if the configuration is not closed, then proximity checking is turned off auto_mode<=1. If mclosed = 1, then the input surface definition configuration is assumed to be closed with all surfaces forming one or more closed bodies. Interior surface definitions that are not part of a closed body are allowable if they have a transparent type grid BC. default=1 min=0 max=1 mdf ---- Distribution function flag. If mdf = 1, then interpolate the node distribution function for new nodes from the containing element. If mdf = 2, then use geometric growth from the boundaries to determine the distribution function for new nodes. default=1 min=1 max=2 melem ------ Maximum number of elements. All dimensions key off this parameter. If melem = 0, then the code estimates the required dimensions. If melem > 0, then the code estimates are ignored, and all dimensions are initially set based on the value of melem. In either case the code will reallocate memory as needed during grid generation. default=0 min=0 max=2000000000 min_nseg --------- Minimum number of segments on an individual curve. On an individual curve or edge (one that is not a loop) if the number of segments generated is less that min_nseg, then the min_spacing value will be overruled and the spacing reduced to obtain the correct number of segments. default=2 min=1 max=2000000000 mpp ---- Point placement flag. If mpp = 2, then use advancing-front point placement. The produces optimal quality tria-faces. If mpp = 3, then use advancing-point point placement. The produces isotropic right-angle tria-faces. This option is intended for use with the quad element combination option (mquad=1). default=2 min=2 max=3 mqchkb ------- Boundary surface quality measure information output flag. If mqchkb = 0, then do not generate boundary surface quality measure information. If mqchkb = 1, then generate boundary surface quality measure information. default=1 min=0 max=1 mquad ------ Quad face combination flag. If mquad = 0, then do not combine tria faces to form quad faces. If mquad = 1, then combine tria faces to form quad faces. This option automatically sets the advancing-point placement option (mpp=3). default=0 min=0 max=1 n_shmem_buffer --------------- Shared memory buffer size. The buffer size is set to n_shmem_buffer for shared memory when the processing mode is parallel using fork and shared memory (parallel_mode=1). default=100000 min=100 max=100000000 rm_bodies ---------- List of input surface IDs to remove. The bodies included in the input configuration can be edited. Given rm_bodies id_1,id_2,...,id_n, then remove bodies with IDs id_1 id_2 ... id_n and keep all others. Note that a list of bodies can also be kept by specifying them with the keep_bodies option. Only use keep_bodies or rm_bodies or neither. Note that if the input configuration is edited and the reference length (ref_len) is not set, then reference length is based on the bounding box for the active bodies kept and not the full input configuration. Also, if the input configuration is edited, then the closed configuration flag is turned off mclosed=0. Commas are required between the body IDs in the list. If only one ID is specified, then it must be terminated with a comma. skin_mode ---------- Structural skin topology mode flag. If skin_mode=1 then allow the input surface definition configuration to be treated as one composed of a thin skin. This option will ignore the Grid BC values and treat each surface as a transparent surface that can be topologically open. By default the input configuration is assumed to be closed with all solid surfaces forming one or more bodies that may have internal transparent surface. Note that this option will produce a surface mesh that is not compatible with the AFLR3 volume mesh generator. default=0 min=0 max=1 NUMERIC PARAMETERS (RARELY USED) ________________________________________________________________________________ ang_qbmax ---------- Output face angle check maximum angle limit. Typical maximum angle for a good quality boundary surface. default=120 min=60 max=180 ang_qbmax2 ----------- Output face angle check usable maximum angle limit. Typical maximum angle for a usable boundary surface mesh. default=170 min=60 max=180 ang_qbmin ---------- Output face angle check minimum angle limit. Typical minimum angle for a good quality boundary surface. default=10 min=0 max=60 angdbe ------- Discontinuous boundary edge angle. Angle between two adjacent boundary edge vectors used to identify edge discontinuities. default=30 min=0 max=179.9 angerw1 -------- Minimum discontinuous edge angle. If the angle between the normals for two adjacent faces of two different surface definitions (different IDs) is greater than angerw1, then the edge between them is considered a minimum discontinuity. See also -er_all, mer_all, erw_ids. erw_list, erw_all, er_lim, and angerw2. default=10 min=0 max=179.9 angerw2 -------- Maximum discontinuous edge angle. If the angle between the normals for two adjacent faces of two different surface definitions (different IDs) is greater than angerw2, then the edge between them is considered a maximum discontinuity. See also -er_all, mer_all, erw_ids. erw_list, erw_all, er_lim, and angerw1. default=30 min=0 max=179.9 angquad1 --------- Maximum aligned quad face angle. Quads are first formed by combining aligned face pairs starting at a boundary edge. Tria face combination is locally terminated if the maximum quad face angle exceeds angquad1. Only applicable if the quad face combination flag is on (mquad>=1). default=120 min=100 max=179.9 angquad2 --------- Maximum non-aligned quad face angle. Quads are also formed by combining non-aligned face pairs after all possible aligned quads are formed. Tria faces are not combined if the maximum quad face angle exceeds angquad2. Only applicable if the quad face combination flag is on (mquad>=1). default=140 min=100 max=179.9 angquad3 --------- Final maximum quad face angle. One additional pass beyond the nquadc quad formation passes is performed with the maximum non-aligned quad face angle, angquad2, set to the final maximum, angquad3. Only applicable if the quad face combination flag is on (mquad>=1). default=140 min=100 max=179.9 arear_qbmin ------------ Output area ratio check quality limit. Typical minimum volume ratio for good quaility elements. default=0.1 min=0 max=1 arear_qbmin2 ------------- Output area ratio check quality limit. Typical minimum volume ratio for a usable surface mesh. default=0.01 min=0 max=1 cdfr ----- Maximum geometric growth rate. Used as the advancing-front growth limit. The element size for new nodes is limited to be less than the physical size of the local front advanced from multiplied by cdfr. Also used as the geometric growth rate for the node distribution function with the growth option (mdf=2). A cdfr value just above 1.0 will produce a grid with optimal element quality. A value of cdfr well above a value of 1.0 will decrease the number of grid nodes generated and potentially decrease the element quality. default=1.1 min=1 max=3 gtol ----- Relative glue tolerance. This tolerance is relative to the local edge lengths of the faces or edges attached to the nodes/vertices being considered for gluing. default=0.0001 min=0 max=1e+19 length_ratio ------------- Curvature length ratio threshold. The curvature length ratio threshold is used to determine spacing variation for curvature along a curve. The curvature length ratio is defined as: LR = [ L(A,C) + L(C,B) ] / L(A,B) Where LR is the curvature length ratio and A, B, and C are points on the curve with point C approximately at the mid-point between A and B. And, where L(A,B) is the straight line length between A and B, L(A,C) is the straight line length between A and C, and L(C,B) is the straight line length between C and B. Note that LR is always one or more. If LR > length_ratio, then the curve is recursively refined. The resulting spacing between points is used to regenerate the edge grid along the curve. default=1.0001 min=1 max=1.1 prox_min_scale rel_prox_min_sp ------------------------------ Relative proximity minimum spacing. The relative proximity minimum spacing (prox_min_scale) is used along with the reference length (ref_len) to limit the minimum spacing produced by proximity checking between component/body surfaces (see auto_mode). prox_min_spacing = prox_min_scale * ref_len default=0.0025 min=1e-12 max=1 qarear_qmin ------------ Output quality function Q check quality limit. Typical minimum quality function q for good quaility elements. default=0.1 min=0 max=1 qarear_qmin2 ------------- Output quality function Q check usable limit. Typical minimum quality function q for a usable volume mesh. default=0.01 min=0 max=1 OPTION PARAMETERS (DO NOT CHANGE) ________________________________________________________________________________ cpu_timer ---------- Routine level CPU timer flag. If cpu_timer = 0, then do not use routine level CPU timer. If cpu_timer = 1, then use routine level CPU timer. default=0 min=0 max=1 min_nseg_loop -------------- Minimum number of segments on a complete curve loop. On a complete curve loop if the number of segments generated is less that min_nseg_loop, then the min_spacing value will be overruled and the spacing reduced to obtain the correct number of segments. default=3 min=3 max=2000000000 mrecim ------- Initial local-reconnection flag. If mrecim = 1, then use a Delaunay criterion. If mrecim = 2, then use a MIN-MAX-Angle criterion. default=2 min=1 max=2 mrecm ------ Local-Reconnection flag. If mrecm = 1, then use a Delaunay criterion. If mrecm = 2, then use a MIN-MAX-Angle criterion. default=2 min=1 max=2 muvmap ------- UV-mapping method flag. If muvmap=1, then solve the mapping equations in topological space without scaling. If muvmap=2, then solve the mapping equations in topological space with xyz scaling. default=1 min=1 max=2 mw_bedge --------- Surface grid file output flag, If mw_bedge = 0, then do not output individual surface boundary-edge grid files. If mw_bedge = 1, then output individual surface boundary-edge grid files. default=0 min=0 max=1 mw_surf -------- Surface grid file output flag, If mw_surf = 0, then do not output individual surface grid files. If mw_surf = 1, then output individual surface grid files. default=0 min=0 max=1 mw_surf_be ----------- Surface grid file with edge ID output flag, If mw_surf_be = 0, then do not output individual surface grid files with edge IDs. If mw_surf_be = 1, then output individual surface grid files with edge IDs. If mw_surf_be = 2, then output glue-only surface grid file with edge IDs. Only applicable with an EGADS CAD geometry definition. default=0 min=0 max=2 mw_zone -------- Zone surface grid file output flag, If mw_zone = 0, then do not output individual zone surface grid files. If mw_zone = 1, then output individual zone surface grid files. default=0 min=0 max=1 nbr ---- Maximum boundary edge subdivisions. Maximum number of boundary edge subdivisions during boundary edge recovery phase of initial triangulation process. default=100 min=4 max=500 nelemdm -------- Minimum number of elements to allocate. Minimum value for number of elements to allocate space for. default=100 min=100 max=10000000 nelpnn ------- Number of elements per node. The maximum number of nodes allocated is set to the maximum of either the number of elements allocated divided by nelpnn or the number of initial nodes multiplied by nnpnni. default=2 min=2 max=7 nelpnni -------- Number of initial elements per node. The maximum number of initial elements allocated is set to the number of nodes in the boundary grid multiplied by nelpnni. This is used only if there is not an initial triangulation and it is used only to generate the initial triangulation. default=3 min=2 max=100 ngen ----- Maximum number of grid passes. default=10000 min=0 max=10000000 ninlpp ------- Maximum initial point placement passes. During grid generation large elements that have all edges larger than the distribution function (local point spacing) are subdivided using centroid point placement. This is repeated for ninlpp passes or less if there are no elements to subdivide. Standard point placement (as specified by mpp) is then used. A value of ninlpp=0 will turn off initial point placement and standard point placement will be used from the start. default=0 min=0 max=10000000 ninsmax -------- Maximum element subdivisions. Maximum number of element subdivisions during direct boundary node insertion. default=100 min=1 max=10000000 nmnrealloc ----------- Minimum array elements to reallocate. Minimum number of new array elements to add if the initial estimate for maximum number of elements is too low. default=1000 min=100 max=10000000 nnpbchk -------- Quad-/Oct-tree bin checking node limit. Node limit target used to generate the quad-/oct-tree for checking data sets of nodes. The node limit target for final bins is set to nnpbchk boundary nodes. default=100 min=10 max=10000 nnpbeval --------- Quad-/Oct-tree bin evaluation node limit. Node limit target used to generate the quad-/oct-tree for evaluation of data sets with functions specified at nodes. The node limit target for final bins is set to nnpbeval source nodes. default=10 min=10 max=10000 nnpnni ------- Number of nodes per initial node. The maximum number of nodes allocated is set to the maximum of either the number of elements allocated divided by by nelpnn or the number of initial nodes multiplied by nnpnni. default=2 min=1 max=10 nquadc ------- Number of quad combination passes. The maximum quad face angles are varied between initial and final values over nquadc passes. During each pass quality improvement is performed. Only applicable if quad face combination flag is on (mquad>=1). default=4 min=1 max=10 nqual ------ Number of quality improvement passes. If nqual = 0, then all quality improvement is skipped. default=1 min=0 max=10 nsmth ------ Number of smoothing iterations. default=3 min=0 max=10 NUMERIC PARAMETERS (DO NOT CHANGE) ________________________________________________________________________________ angdd ------ Discontinuous dihedral surface angle. Dihedral angle between two adjacent faces used to limit boundary surface reconnection. The boundary surface reconnection is limited if the result is a dihedral angle between the two faces that is less than angdd. default=150 min=120 max=179.9 angiermax4 ----------- Maximum AFLR4 isolated edge angle. Isolated edges are not refined if the refinement will produce a face with an angle greater than angiermax4. Only applicable if the isolated edge refinement flag is on (mier4>=1) within AFLR4 optimal surface generation. default=160 min=0 max=179.9 angiermin4 ----------- Minimum isolated edge angle. Isolated edges are not refined if the refinement will produce a face with an angle less than angiermin4. Only applicable if the isolated edge refinement flag is on (mier4>=1) within AFLR4 optimal surface generation. default=10 min=0 max=179.9 angndev -------- Planar uv-mapping normal deviation. A given surface is considered planar if the maximum angle between the normal for one of the faces and all others is less than angndev (in degrees). Applicable only if the planar mapping flag is on (mplanaruv=1). default=1 min=0 max=20 angqermx --------- Maximum isolated edge reconnection angle. Faces with points added to eliminate isolated edges are not reconnected if the reconnection will produce a face with an angle greater than angqermx. Only applicable if the isolated edge refinement flag is on (mier4>=1) within AFLR4 optimal surface generation. default=165 min=0 max=180 angqprojuv ----------- Projected plane uv-mapping max-angle. If a projected plane uv-mapping is specified, then the maximum allowable tria-angle is angqprojuv for all trias on the projected plane. If the maximum angle is exceeded, then a uv-mapping is generated. Note that in addition to the maximum angle all tria-areas on the projected plane are checked to see that they remain positive. Also, if the xyz- surface has trias with angles greater than angqprojuv, then the projected plane is allowed to have maximum tria-angles above angqprojuv. If angqprojuv=0, then the maximum angle is not checked. default=175 min=0 max=180 angquad1i ---------- Initial maximum aligned quad angle. The initial maximum aligned quad angle is varied between angquad1i and angquad1 over nquadc passes. Only applicable if quad face combination flag is on (mquad>=1). default=130 min=100 max=179.9 angquad2i ---------- Initial maximum non-aligned quad angle. The initial maximum non-aligned quad angle is varied between angquad2i and angquad2 over nquadc passes. Only applicable if the quad face combination flag is on (mquad>=1). default=170 min=100 max=179.9 angrbfmxd4 ----------- Maximum angle for curvature improvement. Maximum planar face angle for curvature improvement reconnection. Planar face angle used to limit boundary surface curvature reconnection. The boundary surface triangulation will not be reconnected to improve curvature if the reconnected maximum angle is greater than angrbfmxd. default=110 min=60 max=179.9 bdfmchk -------- Quad-/Oct-tree bin checking size factor. Factor used to generate the quad-/oct-tree for checking data sets of nodes. The size of the smallest quad-/oct-tree bin is set to the local length scale multiplied by bdfmchk. default=1 min=1 max=100000 bdfmeval --------- Quad-/Oct-tree bin evaluation size factor. Factor used to generate the quad-/oct-tree for evaluation of data sets with functions specified at nodes. The size of the smallest quad-/oct-tree bin is set to the local length scale multiplied by bdfmeval. default=1 min=1 max=100000 cbidx ------ Initial bounding box size factor. The initial bounding box used for insertion of all boundary nodes is sized to be equal to the size of the actual domain plus two times cbidx multiplied by the size of the actual domain. default=1 min=1 max=100000 cdf ---- Distribution function multiplier. The distribution function is used to specify desired element size. The distribution function originally determined from the average of the surrounding boundary edge lengths is multiplied by cdf. Increasing cdf will increase the total number of grid nodes generated. Decreasing cdf will decrease the total number of grid nodes generated. Deviation of cdf far from a value of 1.0 will degrade the element quality next to the boundaries. A cdf value above 1.0 will create elements adjacent to boundaries that are elongated normal to the boundary. In the rest of the field the elements should be relatively isotropic. default=1 min=0.5 max=3 cdff ----- Satisfied edge length multiplier. An edge is considered satisfied if its length divided by cdff is less than the average of the node distribution function at the edge end-nodes. default=1.5 min=1.1 max=3 cdff2 ------ Satisfied edge length multiplier #2. An edge is considered satisfied if its length divided by cdff is less than the average of the node distribution function at the edge end-nodes. The value of the satisfied edge length multiplier, cdff, is replaced with the value of multiplier #2, cdff2, if external sizing evaluation is used (meval!=0) or if the advancing-point point placement option is selected (mpp=3). default=2 min=1.1 max=3 cdfn ----- Nearby node factor. Nodes are considered too close if the distance between them is less than their average node distribution functions multiplied by cdfn. default=0.7 min=0.5 max=0.9 cdfn2 ------ Nearby node factor #2. Nodes are considered too close if the distance between them is less than their average node distribution functions multiplied by cdfn. The value of the nearby node factor, cdfn, is replaced with the value of factor #2, cdfn2, if if the advancing-point point placement option is selected (mpp=3). default=0.7 min=0.5 max=0.9 cier ----- Isolated edge refinement factor. Isolated edge refinement is locally turned off if the surface has minimal or no curvature. If mier4=1, then the relative curvature is determined from cier multiplied by the deviation between a point in the middle of the edge and the approximate surface. default=0.0001 min=0 max=1 cinlpp ------- Initial point placement factor. During grid generation large elements that have all edges larger than the distribution function (local point spacing) are subdivided using centroid point placement. Elements that have a ratio of local spacing over minimum edge length less than cinlpp are subdivided. A value of cinlpp=0 will turn off initial point placement and standard point placement will be used from the start. default=0.01 min=0 max=0.5 cnnpnni -------- Number of initial nodes multiplier. The number of nodes allocated for the initial triangulation is set to the number of initial nodes multiplied by cnnpnni. Additional nodes beyond those in the initial boundary grid may be required to complete boundary recovery and obtain an initial triangulation. default=1.5 min=1 max=3 crealloc --------- Reallocation multiplier. The maximum number of elements and nodes is increased, and all arrays are reallocated if more elements or nodes are required to complete the grid. The allocations for each array are increased by crealloc multiplied by their current value. The new array size is limited by the maximum number of new array elements set in parameter nmnrealloc. default=1.25 min=1.05 max=2 csmin ------ Tolerance exponent for searching. default=0.5 min=0.4 max=0.9 csmin4 ------- AFLR4 search tolerance exponent. Area coordinate tolerance exponent for searching using DGEOM and during initial triangulation within AFLR4. default=0.8 min=0.5 max=0.9 csmini ------- Initial tolerance exponent. Tolerance exponent for searching during initial triangulation. default=0.25 min=0.125 max=0.9 csmth ------ Smoothing coefficient. default=0.5 min=0 max=1 ctol ----- Overall tolerance exponent. default=0.94 min=0.8 max=0.94 cwds ----- Weighting factor for new points. Weighting factor used in checking projection of new points on the approximate surface. default=0.5 min=0 max=1 dwrec ------ Surface curvature improvement factor. Surface face curvature improvement reconnection factor. Surface faces are not reconnected to improve curvature matching if the improvement in the curvature is not more than dwrec. The factor varies between zero and one. If dwrec=0, then curvature improvement reconnection is turned off. default=0.1 min=0 max=1 ideal_min_scale rel_ideal_min_sp -------------------------------- Relative ideal minimum spacing. The relative ideal minimum spacing (ideal_min_scale) is used along with the reference length (ref_len) to categorize individual surfaces, except farfield or symmetry plane surfaces, if any. ideal_min_spacing = ideal_min_scale * ref_len default=0.005 min=1e-12 max=1 relem0 ------- Re-numbering limit. Elements are not re-numbered if the ratio of elements to be moved to total elements is less than relem0. default=0.1 min=0 max=1 sf_min ------- Minimum mesh spacing scale factor. The mesh spacing on each surface or globally on all surfaces can be scaled by a specified factor (see sf_global, sf_ids and sf_list). This factor is also used to limit the edge scale factor that can be applied to each edge with a CAD geometry definition. The minimum allowable value of the factor is sf_min. default=0.001 min=1e-06 max=1 smin2 ------ AFLR4 relative search tolerance at boundaries. Used within AFLR4 and DGEOM when searching the surface definition background grid. default=0.1 min=0 max=10 uv_curv_lim ------------ uv limit value for curvature evaluation. Lower and upper limit to uv values for evaluation of curvature. This is to compensate for an issue in the underlying derivatives from Open Cascade that EGADS uses to calculate curvature. For some surfaces there is a singularity in the derivative that causes erroneous curvature values at the uv boundaries of the surface definition. The input parameter uv_curv_lim provides a limit on how close to the actual boundary curvature can be evaluated (uv_curv_lim < uv < 1-uv_curv_lim). Note that this limit does nothing with discrete surface definitions. default=0.01 min=0 max=0.3 uvmod_ratio_lim ---------------- MIN/MAX arc-length ratio lower limit. If a surface is defined with a CAD geometry, then the u,v mapping may be modified with a transformation for scaling and/or singularities. Quadratic scaling is used if the maximum arc-length ratio (min over max) in u or v is less than uvmod_ratio_lim. Linear scaling is always used if uvmod_ratio_lim=0. default=0.1 min=0 max=1 uvmod_rtol ----------- Relative singular point tolerance. If a surface is defined with a CAD geometry, then the u,v mapping may be modified with a transformation for scaling and/or singularities. Singular points are detected if the relative total edge length between them is less than uvmod_rtol or if the absolute total edge length between them is less than uvmod_stol. If uvmod_rtol > 0, then the relative tolerance uvmod_rtol is used. if uvmod_rtol = 0, then the absolute tolerance uvmod_stol is used. default=1e-06 min=0 max=1 uvmod_stol ----------- Absolute singular point tolerance. If a surface is defined with a CAD geometry, then the u,v mapping may be modified with a transformation for scaling and/or singularities. Singular points are detected if the relative total edge length between them is less than uvmod_rtol or if the absolute total edge length between them is less than uvmod_stol. If uvmod_rtol > 0, then the relative tolerance uvmod_rtol is used. if uvmod_rtol = 0, then the absolute tolerance uvmod_stol is used. default=0 min=0 max=1e+19 vsmthb ------- Smoothing reduction factor. Smoothing coefficient reduction factor for all nodes adjacent to a boundary. default=0.5 min=0 max=1