<meshing>
The <meshing> category specifies the main parameters for the volume meshing and the refinement zones.
<meshing> - <general>
- <coarsest_mesh_size>
- Specifies the coarsest size (edge length) of the voxels in [m][m] that ultraFluidX will use to discretize the domain. Higher resolution than the coarsest mesh size in regions of interest is specified via the <refinement> category.
- <mesh_preview>
- Specifies if a preview of the volume mesh should be exported prior to the actual simulation. If set to true, ultraFluidX will write an EnSight Gold file (uFX_meshPreview.case and corresponding *.geo and *.data files) into the uFX_meshData folder.
- <mesh_export>
- Specifies if the mesh should be written to disk after the meshing is completed. If set to true, ultraFluidX will write a mesh source file uFX_mesh.bin to the uFX_meshData folder, that can then be used as input for a future simulation. Refer to the <mesh_source_file> option.
- <mesh_source_file>
- (Optional) Specifies the path to a mesh source file. If specified, ultraFluidX will skip the meshing step and read in the mesh topology from the specified mesh source file instead. Generally, only mesh source files that were written by the same version of ultraFluidX (by setting <mesh_export> to true) can be used.
<meshing> - <refinement>
- <box>
- This category contains all refinement zones with cuboid shape, it can
have an arbitrary number of children named
<box_instance> with the following
parameters:
- <name>
- Name of the instance (optional).
- <refinement_level>
- Refinement level of the instance with regards to the coarsest level.
- <bounding_box>
- Bounding box of the instance, must be specified via the child parameters <x_min>, <x_max>, <y_min>, <y_max>, <z_min> and <z_max> in [m][m].
- <offset>
- This category contains all refinement zones that are an offset of the
whole surface mesh or a specific part. It can have an arbitrary number
of children named <offset_instance> with the
following parameters:
- <name>
- Name of the instance (optional).
- <refinement_level>
- Refinement level of the instance with regards to the coarsest level.
- <normal_distance>
- Distance of the offset to the surface, that is, the effective “thickness” of the zone. Specified in [m][m], but a minimum number of 4 voxels will always be applied.
- <parts>
- If the offset is not be applied to the whole surface mesh, an arbitrary number of individual parts can be specified via the child parameter <name> within the <parts> category. The specified names must exactly match the respective part names in the STL file.
- <custom>
- This category contains all refinement zones that are specified via a volume with arbitrary shape contained in the STL file. Any volume that you want to use for custom refinement needs to be identified as a separate “solid” within the STL file, and the name of this solid needs to be passed to ultraFluidX in the <parts> - <name> section.
<meshing> - <overset>
- <rotating>
- <rotating_instance>
- In these grid regions, a local frame of reference is defined and the
surface geometry and voxels are rotated each timestep according to the
specified rotational speed.Note: The rotating volume must be symmetric with respect to the rotational axis.CAUTION:All geometry parts inside the moving mesh region will rotate with the mesh; thus, care is needed when setting up a rotating volume in the vicinity of stationary geometry parts.