*setmeshparams

Sets 2D meshing edge and face parameters used during surface and element meshing.

Syntax

*setmeshparams entity_type <select_type>=<selection> <option1>=<value1> ?<option2>=<value2>? ... ?<optionN>=<valueN>?

Type

HyperMesh Tcl Modify Command

Description

Sets 2D meshing edge and face parameters used during surface and element meshing.

For surface meshing, the edge definition is by surface edge entity ID or mark, and the face definition is by surface entity ID or mark. For element remeshing, the edge definition is by pair of node IDs of element edges, and the face definition is by element ID. While remeshing, topology is built with the user-defined feature option. A topological edge is assigned a user given edge parameter if it is part of a user given element edge, and similarly for face parameters.

Inputs

entity_type
The type of entity to set parameters for. Valid values are surfaces and lines for surface meshing, and elements and nodes for element remeshing.
<select_type>=<selection>
The entity or entities that are to be set. There are several ways to provide the entities to be set. Only one option can be used at a time:
id=<id>
The ID of the single entity to consider.
id=<id1 id2>
The IDs of the two nodes to consider. These two nodes should be part of an element edge. Valid only when entity_type is nodes.
EdgeMark=<mark_id>
The ID of the mark containing the surface edges to consider. Valid only when entity_type is surfaces or lines.
FaceMark=<mark_id>
The ID of the mark containing the surfaces or elements to consider. Valid only when entity_type is surfaces or elements.
EdgeAlgType=<value>
Flag indicating the edge algorithm type. Valid for entity_type as lines or nodes. Valid values are:
1 - Size and biasing
2 - Chordal deviation. When the command is being called for the first time for an edge, or when any of the chordal deviation parameters have been changed, the elem_density parameter is ignored and the edge element density is set to the value required by the chordal deviation parameters. Subsequent calls of the command with the same chordal deviation parameters reset the edge element density to the specified value with the same along edge density distribution. Calling the command with elem_density=0 results in the resetting of the edge element density to the value required by the chordal deviation parameters.
EdgeBiasing=<value>
The biasing value of the element length to use along the edge. Valid for entity_type as lines or nodes.
EdgeBiasStyle=<value>
The style of biasing to use. Valid for entity_type as lines or nodes. Valid values are:
0 - Linear
1 - Exponential
3 - Bell curve
EdgeChordalDeviation=<value>
The maximum chordal deviation distance for the element for the edge. Valid for entity_type as lines or nodes.
EdgeDensity=<value>
The element density for the edge. Valid for entity_type as lines or nodes.
EdgeDistribution=<value>
The user-defined internal node distribution (e.g. "{0.1 0.3 0.6 0.9}") for the edge. Valid for entity_type as lines or nodes.
EdgeElemSize=<value>
The element size for the edge. Valid for entity_type as lines or nodes.
EdgeMaxAngle=<value>
The maximum turn angle value (in degrees) between adjacent element links for the edge for chordal deviation meshing. Valid for entity_type as lines or nodes.
EdgeMaxSize=<value>
The maximum element size for the edge for EdgeAlgType=2. Valid for entity_type as lines or nodes.
EdgeMinSize=<value>
The minimum element size for the edge for all EdgeAlgType values. Valid for entity_type as lines or nodes.
FaceAlgType=<value>
Flag indicating the face algorithm type. Valid for entity_type as surfaces or elements. Valid values are:
0 - Standard surface meshing
1 - Meshing with flow "align" control
3 - Meshing with flow "align" and "size" control
FaceElemType=<value>
Flag indicating the elements generated for mapped meshing algorithms. Valid for entity_type as surfaces or elements. Valid values are:
0 - Trias
1 - Quads
2 - Mixed
3 - Right trias
4 - Quads only
5 - No meshing
FaceElemType2=<value>
Flag indicating the elements generated for free meshing algorithms. Valid for entity_type as surfaces or elements. Valid values are:
0 - Trias
1 - Quads
2 - Mixed
3 - Right trias
4 - Quads only
5 - No meshing
FaceMeshAlgorithm=<value>
Determines the surface-based mesh generation algorithm to use when creating elements on the face. Valid for entity_type as surfaces or elements. Valid values are:
1 - Auto-decide
2 - Map as rectangle
3 - Map as triangle
4 - Map as pentagon
5 - Map as circle
6 - Free shape
FaceMeshMapPoint1=<value>
FaceMeshMapPoint2=<value>
FaceMeshMapPoint3=<value>
FaceMeshMapPoint4=<value>
FaceMeshMapPoint5=<value>
For map algorithms, the optional mapping corner point IDs. Valid for entity_type as surfaces or elements.
FaceSizeControl=<value>
Flag indicating whether to create uniformly sized elements. Valid for entity_type as surfaces or elements. Valid values are:
0 - Do not create uniformly sized elements
1 - Create uniformly sized elements
FaceSkewControl=<value>
Flag indicating whether to create optimally shaped elements when using mapping algorithms. Valid for entity_type as surfaces or elements. Valid values are:
0 - Do not create optimally shaped elements
1 - Create optimally shaped elements
FaceSmoothMethod=<value>
The smoothing method to use. Valid for entity_type as surfaces or elements. Valid values are:
0 - Auto-decide
1 - Size corrected
2 - Shape corrected
FaceSmoothTolerance=<value>
Applies the smoothing algorithm until the largest adjustment made to a nodal position is less than this value. Valid vales are > 0.0. Valid for entity_type as surfaces or elements.

Examples

To set parameters and perform surface meshing:

*setmeshparams lines id=8 EdgeDensity=8 EdgeAlgType=1
*setmeshparams lines id=6 EdgeDistribution={0.125 0.25 0.375 0.5 0.625 0.75 0.875} EdgeAlgType=3
*setmeshparams surfs id=1 FaceElemType=2 FaceElemType2=5 FaceMeshAlgorithm=5 FaceAlgType=0
*setedgedensitylinkbytypeandaspectratio 0 -1
*createmark surfaces 2 1
*defaultremeshsurf 2 1 2 2 0 1 1 1 1 0 0 0 0

To set parameters and perform element meshing:

*setmeshparams nodes id={559 661} EdgeDistribution={0.111111 0.222222 0.333333 0.444444 0.555556 0.666667 0.777778 0.888889} EdgeAlgType=3
*setmeshparams nodes id={577 648} EdgeDensity=9 EdgeAlgType=1
*setmeshparams elems id=131 FaceElemType=2 FaceElemType2=5 FaceMeshAlgorithm=5 FaceAlgType=0
*setusefeatures 8
*setedgedensitylinkbytypeandaspectratio 1 0
*createmark elements 1 81-130
*defaultremeshelems 1 1 2 2 1 1 1 1 0 0 0 0 0 30

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020.1