style mesh/tet

Purpose

style mesh/tet is used to generate a region from a 3D mesh.

Syntax

region id my_mesh style mesh/tet keyword value

Keyword	Description
file	obligatory, name of ASCII VTK file containing the VTK tet-mesh data
scale	factor to scale the mesh in x-, y-, and z-direction, only available for `file` default: 1; range: (0,∞); units: [-]
move	three values for the offset in x, y and z direction (no vector, `offx` `offy` `offz`) default: 0 0 0; range: (-∞,∞) per component; units: [length]
rotate	angle of mesh rotation around x-, y-, and z-axis in grad (no vector, `phix` `phiy` `phiz`) default: 0 0 0; range: (-∞,∞) per component; units: [grad]
general optional keywords	General keywords of the region command

Warning

The general optional keywords translate and rotate are not applicable for this region style.

Examples

region my_tet mesh/tet file msesh.vtk scale 0.01 move 0. 0. 0.02 units box

Description

This command defines a geometric region of space. Various other commands use regions, and a variety of other region styles exist as well. See region command for details.

For style mesh/tet a tetrahedral mesh can be read from an ASCII VTK file. You can apply offset, scaling and rotation to the imported mesh via dedicated keywords. If applying more then one of these operations, the offset is applied first and then the geometry is scaled. Then the geometry is rotated around the x-axis first, then around the y-axis, then around the z-axis.

Further keywords are described in the doc of the region command. The style mesh/tet/fast is similar to mesh/tet, but the mesh insertion routines are optimized for better performance.

Warning

Currently only ASCII VTK containing tetrahedra are supported. For periodic boundaries, the mesh is not mapped. Instead, a warning is generated if a vertex lies outside the simulation box.

Return to the region documentation.