pw:: VolumeMesher

$mesher get/setMeshType mesh

This attribute controls the mesh type that will be produced.

Type

This attribute is a string with options < Unstructured | Voxel >.

Default

The default for this attribute is Unstructured

$mesher get/setFarfieldShapeType shape

This attribute controls the shape type that will be used on the farfield of the volume mesh.

Type

This attribute is a string with options < Box | Cylinder | Sphere | None >.  If None is specified, then the volume will be created solely from the domains supplied when the mode began with the requisite that the domains must form a watertight surface.

Default

The default for this attribute is Box

$mesher get/setSymmetryMode mode

This attribute controls how the shape handles symmetry conditions of the enclosed mesh.  If set to automatic, then symmetry will be automatically detected and applied to the resulting block.  If set to manual, then symmetry will be applied according to the specified symmetry plane attributes.

This attribute is not applicable with the farfield shape type of None is specified.

Type

This attribute is a string with options < Automatic | Manual >.

Default

The default for this attribute is Automatic

$mesher get/setSymmetryPlane1 plane

This attribute controls the placement of the first symmetry plane.

This attribute is only applicable when the symmetry mode is set to manual and the farfield shape type is not set to None.

Type

This attribute is a string with options < None | +X | -X | +Y | -Y | +Z | -Z >.

Default

The default for this attribute is None

$mesher get/setSymmetryPlane2 plane

This attribute controls the placement of the second symmetry plane.

This attribute is only applicable when the symmetry mode is set to manual and the farfield shape type is not set to None.

Type

This attribute is a string with options < None | X+ | X- | Y+ | Y- | Z+ | Z- >.

Default

The default for this attribute is None

$mesher get/setSizeFieldDecay < Automatic | value >

This attribute controls the size field decay factor used when a size field is generated for this entity.  The size field will use this decay for entities added to the size field that don’t have a explicitly assigned decay.

This attribute is not applicable if the farfield shape type of None is specified.

Type

This attribute is either the string “Automatic” or a float with the range [0.0, 1.0].

Default

The default for this attribute is the value is Automatic.

$mesher get/setSizeFieldBackgroundSpacing < Automatic | value >

This attribute is the size background spacing when a size field is generated for this entity.

This attribute is not applicable if the farfield shape type of None is specified.

Type

This attribute is either the string “Automatic” or a float with the range [0, infinity).

Default

The default for this attribute is the value is Automatic.

$mesher get/setShapeAlignment shape

This attribute controls which primary axes the shape is aligned with.

That this attribute is only applicable for cylinder shapes.

Type

This attribute is a string with options < Automatic | X | Y | Z >.

Default

The default for this attribute is X.

$mesher get/setFarfieldLength < Automatic | lengths >

This attribute controls the length dimension of the farfield.

That this attribute is only applicable to box and cylinder farfield shapes.

Type

This attribute is either the string “Automatic” or a list of two float values each within the range [0.0, infinity).  The two float values describe the positive and negative length of the shape respectively.

Default

The default for this attribute Automatic.

$mesher get/setFarfieldWidth < Automatic | widths >

This attribute controls the width dimension of the farfield.

That this attribute is only applicable to box farfield shapes.

Type

This attribute is either the string “Automatic” or a list of two float values each within the range [0.0, infinity).  The two float values describe the positive and negative width of the shape respectively.

Default

The default for this attribute Automatic.

$mesher get/setFarfieldHeight < Automatic | heights >

This attribute controls the height dimension of the farfield.

That this attribute is only applicable to box farfield shapes.

Type

This attribute is either the string “Automatic” or a list of two float values each within the range [0.0, infinity).  The two float values describe the positive and negative height of the shape respectively.

Default

The default for this attribute Automatic.

$mesher get/setFarfieldCapRadii < Automatic | radii >

This attribute controls the radii of the farfield caps.

That this attribute is only applicable to cylinder farfield shapes.

Type

This attribute is either the string “Automatic” or a list of two float values each within the range [0.0, infinity).  The first float value describes the radius of the top cylinder cap, and the second float value describes the radius of the base cylinder cap.

Default

The default for this attribute Automatic.

$mesher get/setFarfieldRadius < Automatic | radius >

This attribute controls the radius of the farfield.

That this attribute is only applicable to sphere farfield shapes.

Type

This attribute is either the string “Automatic” or a float value within the range [0.0, infinity) that describes the radius of the sphere.

Default

The default for this attribute Automatic.

$mesher get/setBoundaryLayerType type

This attribute controls the boundary layer type to be applied to resulting volume meshes.

Type

This attribute is a string with options < Off | GeometricGrowth >.

Default

The default for this attribute is Off

$mesher get/setWallNormalSpacing spacing

This attribute controls the wall normal spacing to be applied to the nearfield boundary mesh.

This attribute only applies when the boundary layer type is set to Geometric Growth and only to those domains which belong to the “Boundary Layer” boundary condition filter.

Type

This attribute is a float with the range [0, infinity).

Default

The default for this attribute is 0.01

$mesher get/setGrowthRate growth

This attribute is the growth rate of T-Rex layers of an unstructured block when it is created.

This attribute only applies when the boundary layer type is set to Geometric Growth.

Type

This default is a float with the range [1.0, infinity).

Default

The default for this attribute is 1.2

$mesher get/setCollisionBuffer < Automatic | value >

This attribute is the minimum buffer to be maintained between encroaching extruded tetrahedrals of an unstructured block when it is created.

This attribute only applies when the boundary layer type is set to Geometric Growth.

Type

This attribute is either the string “Automatic” or a float with the range [0, infinity).

Default

The default for this attribute is the value is Automatic.

$mesher get/setFinalCellAspectRatio < Automatic | value >

This attribute specifies the scale factor to be applied to the local isotropic height at which T-Rex stops layer growth via deformation, decimation or refinement.

When set to 1.0, anisotropic cell growth continues at each vertex until one of the tets below the vertex reaches its isotropic height.  When a value other that 1.0 is selected, the isotropic height criteria is multiplied by the value, meaning that it is possible to stop vertex advancement prior (value < 1) or beyond (value> 1) true isotropy.

This attribute only applies when the boundary layer type is set to Geometric Growth.

Type

This attribute is either the string “Automatic” or a float with the range (0.0, infinity).

Default

The default for this attribute is the value is Automatic.

$mesher get/setMaxIncludedAngle < Automatic | value >

This attribute specifies the maximum included angle quality threshold for T-Rex cells.  If the criterion cannot be met the cell will be discarded and the front is stopped locally.

This attribute only applies when the boundary layer type is set to Geometric Growth.

Type

This attribute is either the string “Automatic” or a float with the range [60.0, 180.0], 180.0 disables the quality check.

Default

The default for this attribute is the value is Automatic.

$mesher get/setCentroidSkewness < Automatic | value >

This attribute specifies the maximum centroid skew quality threshold for T-Rex cells.  If the criterion cannot be met the cell will be discarded and the front is stopped locally.

This attribute only applies when the boundary layer type is set to Geometric Growth.

Type

This attribute is either the string “Automatic” or a float with the range [0.0, 1.0], where 1.0 disables the quality check.

Default

The default for this attribute is the value is Automatic.

$mesher get/setVoxelMinimumSize < Automatic | value >

This attribute is the minimum voxel size of the voxel mesh.

This attribute only applies when the mesh type is set to voxel.

Type

This attribute is either the string “Automatic” or a float with the range [0, infinity).

Default

The default for this attribute is the value is Automatic.

$mesher get/setVoxelMaximumSize < Automatic | value >

This attribute is the maximum voxel size of the voxel mesh.

This attribute only applies when the mesh type is set to voxel.

Type

This attribute is either the string “Automatic” or a float with the range [0, infinity).

Default

The default for this attribute is the value is Automatic.

$mesher get/setVoxelTransitionLayers < Automatic | value >

This attribute is the number of layers between voxel size transitions of the voxel mesh of this block.

This attribute only applies when the mesh type is set to voxel.

Type

This attribute is either the string “Automatic” or an integer with the range [1, 100].

Default

The default for this attribute is the value is Automatic.

$mesher createGridEntities

This command creates the volume grid entities according to the attributes applied to the pw::VolumeMesher mode such as mesh type, farfield shape, symmetry specifications, size field decay, etc.  The newly created farfield domains, symmetry domains, or database planes are named based on their orientation with the principal axes.

Returns

This action returns a list of pw::GridEntity objects.

Example

This example shows how to create volume grid entities using a set of unstructured domains with several specified attributes.

Code

set doms [pw::Grid getAll -type pw::DomainUnstructured]
set vm [pw::Application begin VolumeMesher $doms]
$vm setMeshType Unstructured
$vm setFarfieldShapeType Box
$vm setSizeFieldDecay 0.8
$vm setSizeFieldBackgroundSpacing 10
set newDoms [$vm createGridEntities]
puts "Grid entities created:"
foreach ent $newDoms {
  puts [$ent getName]
}

$mesher addBoundaryConditionFilter name

This command creates a new boundary condition filter.  Filters apply to all domains associated with the volume created in the mode.  If a domain’s name matches a filter’s pattern, then that domain will be assigned to the boundary condition that the filter represents.

Parameters

Returns

This action returns the name of the added filter.

$mesher deleteBoundaryConditionFilter name

This command deletes a boundary condition filter.

Parameters

Returns

This action returns nothing.

$mesher getBoundaryConditionFilterNames

This command gets all boundary condition filter names.

Returns

A list of strings of the boundary condition filter names.

$mesher setBoundaryConditionFilterName oldName newName

This command updates a boundary condition filter’s name.

Parameters

Returns

This action returns nothing.

$mesher setBoundaryConditionFilterType name type

This command sets the boundary condition filter’s T-Rex type.

parameter

Returns

This action returns nothing.

$mesher getBoundaryConditionFilterType name

This command gets the boundary condition filter’s T-Rex type.

parameter

Returns

This action returns a string with values < Off | Wall | Angle | Match | AdjacentGrid | AspectRatio | MaximumAspectRatio >.

$mesher setBoundaryConditionFilterAdaptation name adapt

This command sets the boundary condition filter’s adaption type.

parameter

Returns

This action returns nothing.

$mesher getBoundaryConditionFilterAdaptation name

This command gets the boundary condition filter’s adaption type.

parameter

Returns

This action returns a string with values < Off | On >

$mesher setBoundaryConditionFilterValue name value

This command sets the boundary condition filter’s T-Rex condition value.  If the boundary condition filter’s T-Rex condition type is Wall, the value is the spacing.  If the condition type is Angle, the value is the angle.  If the condtion type is AspectRatio or MaximumAspectRatio, the value is the aspect ratio.

parameter

Returns

This action returns nothing.

$mesher getBoundaryConditionFilterValue name

This command gets the boundary condition filter’s T-Rex condition value.  If the boundary condition filter’s T-Rex condition type is Wall, the value is the spacing.  If the condition type is Angle, the value is the angle.  If the condtion type is AspectRatio or MaximumAspectRatio, the value is the aspect ratio.

parameter

Returns

This action returns a float.

$mesher setBoundaryConditionFilterPatterns name patterns

This command sets the boundary condition filter’s patterns.  The filter’s pattern is used to select grid entities for boundary condition assignment.

parameter

Returns

This action returns nothing.

$mesher getBoundaryConditionFilterPatterns name

This command gets the boundary condition filter’s patterns.  The filter’s pattern is used to select grid entities for boundary condition assignment.

parameter

Returns

This action returns the list of string patterns that are used to match against domains in the volume created by the mode.

$mesher getBoundaryConditionFilterGroups ?-shapeSides sidesVar? name

This action returns a list of domains associated with a boundary condition filter.

Parameters

Returns

This action returns the list of pw::Domain that match the specified filter.

$mesher setBoundaryConditionFilterPriority nameList

This action sets the priority of one or more existing boundary condition filters.

Parameters

Returns

This action returns nothing.