BLOOM3 Usage Summary
BLOOM3 is a stand-alone unstructured boundary-layer (BL) generation code. For boundary-layer (BL) generation it uses the Advancing-Normal Boundary-Layer (ANBL) procedure to generate a tetrahedral, pentahedral, and/or hexahedral BL mesh adjacent to BL generating surfaces. For a complete volume mesh, it uses either an open or closed method. For a closed method the primary input is an unstructured tetrahedral element volume mesh and can be coupled with an external procedure for displacing the volume mesh and inserting the BL region mesh. In open mode the primary input is a surface triangulation. BLOOM3 has an internal BL interference checking process and is coupled with both AFLR3 and TetGen for complete volume mesh generation.
bloom3 [input_arg_file_name] [param_options]
PARAMETER NAME DESCRIPTION
________________________ _____________________________________________________
PROGRAM CONTROL & I/O PARAMETERS
-File_Status_Monitor : Turn on file status monitor.
File_Status_Monitor_Flag=1
-Memory_Monitor : Turn on memory monitor.
Memory_Monitor_Flag=1
-Memory_Monitor2 : Turn on memory monitor.
Memory_Monitor_Flag=2
-build : List program version build number.
-h : List summary of input parameters.
Help_Flag=1
-h_all : List summary of all input parameters.
Help_Flag=3
-h_io : List summary of file I/O parameters.
Help_UG_IO_Flag=1
-help : List documentation of input parameters.
Help_Flag=2
-help_all : List documentation of all input parameters.
Help_Flag=4
-help_io : List documentation of file I/O parameters.
Help_UG_IO_Flag=2
-out : Generate an output file.
-log : synonymous names
Output_File_Flag=1
-out_a : Append an output file.
-log_a : synonymous names
Output_File_Flag=-1
-outf : Send output to a file only.
-logf : synonymous names
Output_File_Flag=2
-outf_a : Append output to a file only.
-logf_a : synonymous names
Output_File_Flag=-2
-ver : List program version number.
-version : List program version information.
Help_Flag : List documentation of input parameters.
default=0 min=-1 max=4
Help_UG_IO_Flag : List documentation of file I/O parameters.
default=0 min=0 max=2
Output_File_Flag : Output file flag.
default=0 min=-2 max=2
-v : Use executable in specified directory.
default=
Arg_File_Name : Input argument file name.
-arg : synonymous names
default=
Input_Grid_File_Name : Case name or input grid file name.
-i -igrid -case : synonymous names
default=
Output_Grid_File_Name : Output grid file name or suffix.
-o -ogrid : synonymous names
default=.meshb
TMP_File_Dir : Temporary file directory.
-tmp : synonymous names
default=_null_
FLAG PARAMETERS (OFTEN USED)
-blc : Generate a BL mesh and create prism elements.
mblelc=1
-blc2 : Generate a BL mesh and create prism/split-hex elements.
mblelc=2
-closed : Use a closed method with a process for displacing the outer volume mesh.
BLOOM3_Mode_Flag=1
-min_mem : Minimize memory usage.
mw_merged=1
-open : Use an open method with intersection checking for the top BL mesh layer.
BLOOM3_Mode_Flag=2
OPTION PARAMETERS (OFTEN USED)
BL_IDs : List of IDs for BL Generating Solid surfaces.
-bl_ids : synonymous names
default=
BL_Int_IDs : List of IDs for BL Intersecting surfaces.
-bl_ints -bl_int_ids -ints -int_ids : synonymous names
default=
FF_IDs : List of IDs to for FarField surfaces.
-ffs -ff_ids : synonymous names
default=
Number_of_BLs : Number of BL layers to be generated for given surface IDs.
default=
PS_IDs : ID pairs for periodic surfaces.
-psids : synonymous names
default=
PS_Nodes : Node pairs for periodic surfaces.
-psns : synonymous names
default=
Std_IDs : List of IDs to for Solid surfaces.
-stds -std_ids : synonymous names
default=
Trnsp_BL_IDs : List of IDs for BL Generating Transparent surfaces.
-trnsp_bl_ids : synonymous names
default=
Trnsp_IDs : List of IDs for Transparent surfaces.
-trnsp_ids : synonymous names
default=
Trnsp_Intl_BL_IDs : List of IDs for BL Generating Internal Transparent surfaces.
-trnsp_intl_bl_ids : synonymous names
default=
Trnsp_Intl_IDs : List of IDs for Internal Transparent surfaces.
-trnsp_intl_ids : synonymous names
default=
Trnsp_Src_IDs : List of IDs for Transparent Source surfaces.
-trnsp_src_ids : synonymous names
default=
NUMERIC PARAMETERS (OFTEN USED)
Re_l : Reynolds Number for estimating BL initial normal spacing,
-Re : synonymous names
default=0 min=0 max=1e+19
blyp : Specify turbulent BL y+ for determining the initial spacing normal.
-y+ : synonymous names
default=1 min=0.01 max=1e+06
cdfrbl : BL geometric growth rate.
-blr : synonymous names
default=1 min=1 max=3
cdfrblm : Maximum BL geometric growth rate.
-blrm : synonymous names
default=1.5 min=1.001 max=4
dsdef : BL initial normal spacing.
-blds : synonymous names
default=0 min=0 max=1e+19
ref_len : Reference length for BL initial normal spacing.
default=0 min=0 max=1e+19
FLAG PARAMETERS (SOMETIMES USED)
-aflr3 : Use aflr3 tet-mesh generator.
tet_mesh_routine=1
-bldelmax : Set BL thickness equal to the maximum BL thickness.
deldef=0 mbldelmax=1
-no_vol_id : Do not set volume element ID flag.
-no_vid : synonymous names
Set_Vol_ID_Flag=0
-qchk : Read input grid file and generate element quality measure information.
Program_Flag=0 mqchk=2 Output_Grid_File_Name=_null_
-tetgen : Use tetgen tet-mesh generator.
tet_mesh_routine=2
-vid1 : Set volume element region ID flag.
Set_Vol_ID_Flag=1
-vid2 : Set volume element region and BL layer ID flag.
Set_Vol_ID_Flag=2
OPTION PARAMETERS (SOMETIMES USED)
BC_IDs : List of IDs to set grid BC parameters.
bc_ids : synonymous names
default=
BLOOM3_Mode_Flag : BLOOM3 Mode Flag.
-mode : synonymous names
default=2 min=0 max=2
Grid_BC_Flag : List of grid BC flags to set.
bc_list : synonymous names
default=
iblri : Number of constant spacing BL layers.
-bli : synonymous names
default=5 min=0 max=1000
mblchkv : BL element volume checking flag.
default=1 min=0 max=1
mblelc : BL element combination flag.
default=0 min=-1 max=2
mw_merged : Merged BL and outer mesh internal write flag.
default=0 min=0 max=1
nbl : Maximum BL mesh layers to generate.
default=10000 min=0 max=10000000
nbldiff : Maximum difference in BL levels.
default=0 min=0 max=10000000
tet_mesh_routine : Tet-mesh generation routine index.
tet_mesh : synonymous names
default=1 min=0 max=2
NUMERIC PARAMETERS (SOMETIMES USED)
BL_DEL : BL thickness for given surface IDs.
default=
BL_DS : Initial BL normal spacing for given surface IDs.
default=
cdsnbl : Initial BL spacing layer limit ratio.
default=10 min=1 max=1e+19
deldef : BL thickness.
-bldel : synonymous names
default=-1 min=-1 max=1e+19
OPTION PARAMETERS (SELDOM USED)
Rec_IDs : List of IDs to reset Reconnection flag.
-rec_ids : synonymous names
default=
mblend : BL termination mode flag.
default=1 min=-1 max=1
mnbllim : Number of BL layers limiting flag.
default=0 min=0 max=1
nblsmth : BL normal vector smoothing iterations.
default=20 min=0 max=10000
NUMERIC PARAMETERS (SELDOM USED)
angblqmax : Maximum BL dihedral element angle.
default=165 min=90 max=179.9
angblqmaxd : Maximum discontinuous BL dihedral angle.
default=175 min=90 max=180
angblqmaxd2 : Maximum convex disc. BL dihedral angle.
default=179 min=90 max=180
angqbfq : Maximum quad face angle for hexs.
default=160 min=90 max=180
cbldsm : BL sub-layer spacing multiplier.
default=0.5 min=0 max=1
cblmnr : Maximum normal-direction-aspect-ratio.
default=0.7 min=0 max=100
cblmnrmin : Minimum normal-direction-aspect-ratio.
default=0.25 min=0 max=100
dcdfrbl : BL geometric growth acceleration rate.
-bldr : synonymous names
default=1.05 min=1 max=2
OPTION PARAMETERS (RARELY USED)
Message_Flag : Message flag.
mmsg : synonymous names
default=1 min=-1 max=2
Rec_Flag : List of reconnection flags to reset.
default=
Set_Vol_ID_Flag : Set volume element ID flag.
default=1 min=0 max=2
m_qvrrchk : Quality function Q (based on vol/radius ratio) output flag.
default=0 min=0 max=1
m_set_new_id : Boundary surface BL region ID flag.
default=0 min=0 max=1
m_volrchk : Output volume ratio check flag.
default=1 min=0 max=2
mbldelmax : BL thickness flag.
default=0 min=0 max=1
mbv_mode : Boundary normal vector mode.
default=1 min=1 max=3
mdfblminm : BL isotropic length scale limiting flag.
default=0 min=0 max=1
mdsblf : BL spacing thickness factor option.
default=1 min=0 max=2
mqchk : Element quality measure information output flag.
default=1 min=0 max=2
mw_bl : BL coordinate data write flag.
default=1 min=0 max=1
mw_bl_surf : BL interface surface mesh file flag.
default=0 min=0 max=1
mw_edge_grid : BL intersecting surfaces edge grid file flag.
default=0 min=0 max=1
nblidsmthl : BL surface ID smoothing layers.
default=20 min=2 max=10000000
nblsmthl : BL concave region smoothing layers.
default=10 min=0 max=10000
NUMERIC PARAMETERS (RARELY USED)
ang_qmax : Output dihedral angle check quality limit.
default=160 min=0 max=180
ang_qmax2 : Output dihedral angle check usable limit.
default=179.9 min=0 max=180
angbfmax : Boundary surface face quality threshold.
default=160 min=60 max=180
angblisimx : Maximum angle between BL intersecting faces.
default=170 min=0 max=180
angblqfmax : Maximum BL interface face angle.
default=170 min=90 max=179.9
angblqfmax2 : Maximum BL interface face angle #2.
default=179 min=90 max=179.9
angdbe : Discontinuous boundary edge angle.
default=30 min=0 max=179.9
angqbf : Maximum planar surface angle.
default=179.5 min=120 max=180
angqbfmin : Minimum planar surface angle.
default=0.0001 min=0 max=180
cblcncvmnr : Concave maximum normal-direction-aspect-ratio.
default=0.9 min=0 max=100
cbldsmin : BL coordinate movement factor.
default=0.0001 min=0 max=1
cblend : Global BL termination factor.
default=0.1 min=0 max=1
cblnrchkbf : Checking normal-direction-aspect-ratio.
default=0.7 min=0 max=100
cblsmax : BL thickness multiplier.
default=1 min=0.1 max=1000
cblsmaxs : BL normal smoothing multiplier.
default=0.5 min=0 max=1000
cblsmaxsd : BL normal smoothing discontinuity multiplier.
default=1 min=0 max=1000
cdffblm1 : Maximum BL edge length factor #1.
default=1.5 min=1 max=10
cdffblm2 : Maximum BL edge length factor #2.
default=1 min=1 max=1e+06
dx_tol : Output relative tolerance for element edge-length checking.
default=1e-12 min=0 max=1
qvlr_qmin : Quality function Q (based on vol/length ratio) quality limit.
default=0.1 min=0 max=1
qvlr_qmin2 : Quality function Q (based on vol/length ratio) usable limit.
default=0.01 min=0 max=1
qvrr_qmin : Quality function Q (based on vol/radius ratio) quality limit.
default=0.1 min=0 max=1
qvrr_qmin2 : Output quality function Q (based on vol/radius ratio) check usable limit.
default=0.01 min=0 max=1
vol_tol : Output relative tolerance for element volume checking.
default=1e-12 min=0 max=1
volr_qmin : Output volume ratio check quality limit.
default=0.1 min=0 max=1
volr_qmin2 : Output volume ratio check quality limit.
default=0.01 min=0 max=1
OPTION PARAMETERS (DO NOT CHANGE)
Program_Flag : Program flag.
default=1 min=0 max=1
cpu_timer : Routine level CPU timer flag.
default=0 min=0 max=1
m_get_inbin : Originating boundary node map flag.
default=0 min=0 max=1
mw_iblisibf : BL rebuild surface map write flag.
default=0 min=0 max=1
nbld : Maximum total BL mesh layers allowable.
default=10000 min=0 max=10000000
nbldd : Number of discontinuity levels.
default=5 min=2 max=100
nblpnmin : Minimum number of surrounding BL nodes.
default=3 min=2 max=100
ndfsmth : Max distribution function BL smoothing iterations.
default=100 min=0 max=10000000
nnpbchk : Quad-/Oct-tree bin checking node limit.
default=100 min=10 max=10000
nnpbeval : Quad-/Oct-tree bin evaluation node limit.
default=10 min=10 max=10000
p1_conv_flag : Create a p2 complement mesh for testing.
default=0 min=0 max=2
p2_conv_flag : Create a p1 complement mesh for testing.
default=0 min=0 max=1
NUMERIC PARAMETERS (DO NOT CHANGE)
ang_bv_disc : BL discontinuous surface normal angle.
default=30 min=0 max=180
ang_bv_sharp : BL sharp surface edge angle.
default=179.99 min=179 max=180
ang_bv_smooth : BL smooth surface normal angle.
default=2 min=0 max=180
angbd : Discontinuous surface angle.
default=140 min=90 max=179.9
angbldd : BL discontinuous surface angle.
default=15 min=0 max=90
angbldd2 : BL very discontinuous surface angle.
default=85 min=0 max=90
angblsd : BL small dihedral angle.
default=2 min=0 max=45
angrbfsd : Small dihedral surface angle.
default=2 min=0 max=10
bdfmchk : Quad-/Oct-tree bin checking size factor.
default=1 min=1 max=100000
bdfmeval : Quad-/Oct-tree bin evaluation size factor.
default=1 min=1 max=100000
bv_det_tol : Small LS determinant value.
default=0.001 min=0 max=1
bv_diff_tol : Redundant normal vector tolerance.
default=1e-06 min=0 max=1
bv_ev_sharp : Sharp edge normal vector perturbation.
default=1e-06 min=0 max=1
cblchkbb : Intersection checking box size factor.
default=0 min=0 max=1000
cblcncv : Concave BL region factor.
default=0 min=0 max=1000
cblsmthd : Smoothing BL thickness multiplier.
default=0.5 min=0 max=1
cblsrchbb : Nearby node search bounding box size factor.
default=3 min=1 max=1000
cblsrchbb2 : Nearby surf search bounding box size factor.
default=1.2 min=1 max=1000
cdfn : Nearby node factor.
default=0.7 min=0.5 max=0.9
cdfnbl : Nearby BL node factor.
default=0.25 min=0 max=10
csmin : Tolerance exponent for searching.
default=0.8 min=0.4 max=0.9
csmini : Initial tolerance exponent.
default=0.25 min=0.125 max=0.9
ctol : Overall tolerance exponent.
default=0.94 min=0.8 max=0.94
ctolm : BL grid volume tolerance exponent.
default=0.88 min=0.5 max=0.94
dfsmthlim : Distribution function BL smoothing limit
default=0.1 min=0 max=10
dfsmthtol : Distribution function BL smoothing tolerance
default=0.001 min=0 max=1
dsblfmax : BL spacing thickness factor.
default=100 min=1 max=1e+06
sminj : Face intersection location tolerance.
default=0.3 min=0 max=1e+06