HYBRID Parameters hypothesis
Table of Contents
HYBRID Parameters hypothesis works only with MeshGems-Hybrid algorithm. This algorithm is a commercial software.
To get a licence, visit http://www.distene.com and http://www.meshgems.com/
General parameters
- Hybrid parameters - See distene documentation or MeshGems-Hybrid help command:
$> mg-hybrid.exe --help
==========================================
MG-Hybrid -- MeshGems 2.9-6 (August, 2019)
==========================================
Distene SAS
Campus Teratec
2, rue de la Piquetterie
91680 Bruyeres le Chatel
FRANCE
Phone: +33(0)970-650-219 Fax: +33(0)169-269-033
EMail: <support@distene.com>
Running MG-Hybrid (Copyright 2014-2019 by Distene SAS)
date of run: 07-Oct-2019 AT 17:40:47
running on : Linux 3.16.0-4-amd64 x86_64
using modules:
MeshGems-Core 2.9-6
MeshGems is a Registered Trademark of Distene SAS
MG-HYBRID USAGE
mg-hybrid.exe [-h] [-v <verbose>] [-i <filein>] [-o <fileout>] \
[--global_physical_size <size>] [--max_number_of_threads <maxthreads>] \
[--boundary_layer_size_mode <mode>] \
[--boundary_layer_height_relative_to_local_surface_size <yes|no>] \
[--number_of_boundary_layers <number>] [--boundary_layer_global_initial_height <height>] \
[--boundary_layer_surface_tags <list>] \
[--boundary_layer_initial_height_on_surface_tags <list>] \
[--boundary_layer_geometric_progression <real>] \
[--boundary_layer_max_element_angle <size>] [--boundary_layer_imprinting <boolean>] \
[--boundary_layer_imprinting_tags <list>] [--boundary_layer_snapping <boolean>] \
[--boundary_layer_snapping_tags <list>] [--normal_direction <dir>] [--gradation <real>] \
[--element_generation <type>] [--collision_mode <mode>] [--add_multinormals <yes|no>] \
[--multinormal_angle_threshold <angle>] [--smooth_normals <yes|no>] \
[--optimisation <type>]
-h --help
prints this help.
-v --verbose <verbose>
Sets the verbosity level parameter.
The <verbose> parameter must be in the range 0 to 10:
0 : no detail
10 : very detailed
Default: 3
-i --in <filein>
Sets the input file.
(MANDATORY)
-o --out <fileout>
Sets the output file.
If unset, _hybrid is appended to the input file basename.
Using an existing file is forbidden.
Using the same file as --in is forbidden.
--global_physical_size <size>
Sets the global physical size.
Default: no default.
--max_number_of_threads <maxthreads>
Sets the maximum number of threads to be used in parallel.
Default: 4
--boundary_layer_size_mode <mode>
Sets the behavior for the boundary layer sizes.
If <mode> is:
global: the boundary_layer_global_initial_height is used to compute the layer heights
local: the boundary_layer_surface_tags and
boundary_layer_initial_height_on_surface_tags are used to compute the layer heights
Default: global
--boundary_layer_height_relative_to_local_surface_size <yes|no>
If set to yes, the given sizes are relative to the surface size
Default: no
--number_of_boundary_layers <number>
Sets the number of boundary layers.
Default: 0
--boundary_layer_global_initial_height <height>
Sets the height of the first layer.
--boundary_layer_surface_tags <list>
Comma separated list of surface references to be used to grow boundary layers.
--boundary_layer_initial_height_on_surface_tags <list>
Comma separated list of initial heights to be used to grow boundary layers.
--boundary_layer_geometric_progression <real>
Sets the geometric progression for all the boundary layer growths (position of layer
number i is h * g^(i-1)).
Default: 1.0
--boundary_layer_max_element_angle <size>
Sets the maximum internal angles of elements (in degree). This setting applies to the
boundary layer elements only.
Default: 165.
--boundary_layer_imprinting <boolean>
Activates the imprinting of the boundary layers. The parts of the surface where the
layers have to be imprinted are defined through the option
--boundary_layer_imprinting_tags
Default: no imprinting
--boundary_layer_imprinting_tags <list>
Comma separated list of surface references that have to be imprinted by boundary layers.
--boundary_layer_snapping <boolean>
Activates the snapping of the generated boundary layers on the surface. The parts of the
surface where the layers have to be snapped into are defined through the option
--boundary_layer_snapping_tags
Default: no snapping
--boundary_layer_snapping_tags <list>
Comma separated list of surface references that are imprinted by boundary layers.
--normal_direction <dir>
Specifies whether mg-hybrid should use the surface normals or the inverse of the surface
normals.
if <dir> is:
1 : means the layers grow in the same direction as the normals to the surface
-1 : means the layers grow in the opposite direction to the normals of the surface
Default: 1
--gradation <real>
Sets the desired maximum ratio between 2 adjacent edges. It applies only to the edges
which belong to the tetrahedra.
Default: 2.0
--element_generation <type>
Sets the element type for the mesh generation.
If <type> is:
tetra_dominant : prismatic or hexahedral elements in the boundary layers, tetrahedra in
the remaining volume
hexa_dominant : prismatic or hexahedral elements in the boundary layers, mixture of
hexahedra and tetrahedra in the remaining volume
cartesian_core : cartesian hexa core with tetrahedra and pyramids in the remaining
volume
extrusion_only : only prismatic or hexahedral elements near the boundary are generated.
The remaining volume is not filled.
Default: tetra_dominant
--collision_mode <mode>
Sets the behavior in case of collision between layers.
If <mode> is:
decrease : keeps the number of desired layer but decreases the height of the layers to
avoid any collision
stop : stops locally the generation of layers to avoid collisions; the number of
generated layers may differ from the specified desired number
Default: stop
--add_multinormals <yes|no>
Add extra normals at opening ridges and corners.
Default: no
--multinormal_angle_threshold <angle>
Set the maximum angle between the multiple normals at opening ridges.
Default: 30
--smooth_normals <yes|no>
Smooth normals at closed ridges and corners.
Default: no
--optimisation <type>
sets the optimisation type.
If <type> is:
no : no optimisation is applied
yes : optimisation is performed upon mesh generation
only : only optimisation is performed to an existing volume mesh.
Default: yes.
================================================================================
MG-Hybrid -- MeshGems 2.9-6 (August, 2019)
END OF SESSION - MG-Hybrid (Copyright 2014-2019 by Distene SAS)
compiled Sep 2 2019 23:42:41 on Linux_64
MeshGems is a Registered Trademark of Distene SAS
================================================================================
( Distene SAS
Phone: +33(0)970-650-219 Fax: +33(0)169-269-033
EMail: <support@distene.com> )
Advanced parameters
Advanced meshing options
- A table allows to input in the command line any text for hybrid argument from "mg-hybrid.exe help", and future advanced options...
Add option - adds a line to the table where you can type an option and its value as text. A check box in the first column activates/deactivates the option of the current row. A deactivated option will be erased upon pressing Ok. - Add multi normals - Add extra normals at opening ridges and corners.
- Collision mode - Sets the behavior in case of collision between layers.
- decrease - keeps the number of desired layer but decreases the height of the layers to avoid any collision
- stop - stops locally the generation of layers to avoid collisions; the number of generated layers may differ from the specified desired number
- Gradation - Sets the desired maximum ratio between 2 adjacent edges. It applies only to the edges which belong to the tetrahedra.
- Maximum number of threads - Sets the maximum number of threads to be used in parallel.
- Multi normal angle threshold - Set the maximum angle (in degrees) between the multiple normals at opening ridges.
- Smooth normals - Smooth normals at closed ridges and corners.
Logs and debug
- Working directory - allows defining the folder for input and output files of hybrid software, which are the files starting with "HYBRID_" prefix.
- Verbose level - to choose verbosity level in the range from 0 to 10.
- 0, no standard output,
- 2, prints the data, quality statistics of the skin and final meshes and indicates when the final mesh is being saved. In addition the software gives indication regarding the CPU time.
- 10, same as 2 plus the main steps in the computation, quality statistics histogram of the skin mesh, quality statistics histogram together with the characteristics of the final mesh.
- Print log in a file - if this option is checked on the log is printed in a file placed in the working directory, otherwise it is printed on the standard output.
- Remove log on success - if this option is checked on the log file is kept only if an error occurs during the computation. This option is only available if Print log in a file is enabled (there must be a log file to delete it) and Keep all working files is disabled (in this case the log file is always kept).
- Keep all working files - allows checking input and output files of hybrid software, while usually these files are removed after the launch of the mesher. The log file (if any) is also kept if this option is checked.
Layers meshes
HYBRID algorithm mesh layers on groups of faces. If Mesh layers on all wrap is checked, all wrap is meshed as layers (as boundary_layers_surface_ids 5), else only submeshes selected an added are meshed as layers (as boundary_layers_surface_ids 6). Pay attention: theses groups should be defined into the shell mesh from a previous group defined in the geometry.
Faces with layers
In case of a mesh based on geometry, if Mesh layers on all wrap on Layers meshes tab is unchecked, you can specify geometrical faces on which boundary layers should be constructed. After clicking Selection button (arrow) you can select faces either in the Viewer or in the Object Browser. Add button adds IDs of the selected faces to the Face IDs list. Remove button removes selected IDs from the list.
See Also a sample TUI Script of the creation of a MG-Hybrid hypothesis.