Aligns nodes of mesh edges along geometric edges.
Syntax
*aligntoedges
line_mark_id node_mark_id string_array number_of_strings
Type
HyperMesh Tcl Modify
Description
This command attempts to move nodes near edges to align them with the geometry of the edge.
It further takes arguments that control the quality of the resulting mesh so that quality
does not become too bad. When it cannot move nodes to an entire edge, it then attempts to
move nodes to end vertices of that edge, performing smoothing where necessary on elements
around those nodes. The command requires that quality criteria have been set already.
Inputs
- line_mark_id
- The ID of the mark containing the lines to which to align FE edges to. Valid values are 1 and 2.
- node_mark_id
- The ID of the mark containing the node to align to lines. Valid values are 1 and 2.
- After successful movement, this mark will be repopulated to contain nodes moved
during the alignment.
- string_array
- The ID of the string array that contains the additional input parameters. The string
array is created using the *createstringarray command. This should
always be set to 1.
- These are optional parameters that control the quality of the mesh around the edges.
They are provided as name value params in the format "param_name:param_value".
- The following parameters are supported:
- FailureCountTolerance
- The percentage local failure count tolerance at each edge to which nodes are
being moved to. If the failure count of elements around the nodes being moved
increases beyond this percent of the neighboring element count, the node
movement will be rolled back. The default value is 0.1.
- FailureIndexTolerance
- The percentage local failure quality index tolerance at each edge to which
nodes are being moved to. If the failure quality index of elements around the
nodes being moved increases beyond this percent of the previous quality index of
elements around these nodes, the node movement will be rolled back. The default
value is 0.05.
- GlobalFailureCountTolerance
- The percentage global failure count tolerance to use for the mesh quality
control after node movement to each edge. If the movement of nodes to an edge
causes the global failure count of the mesh to increase beyond this percent of
the total element count, the node movement will be rolled back. The default
value is 0.1.
- GlobalFailureIndexTolerance
- The percentage global failure quality index tolerance to use for the mesh
quality control after node movement to each edge. If after the movement of nodes
to an edge, the global failure quality index of the mesh increases beyond this
percent of the previous global quality index of elements in the model, the node
movement will be rolled back. The default value is 0.05.
- number_of_strings
- Integer indicating the size (number of strings) of the string array created using
*createstringarray.
Examples
To attempt to align all nodes to all lines, using a failure count tolerance of 0.2 and
failure index tolerance of 0.2:
*createmark lines 1 all
*createmark nodes 1 all
*createstringarray 2 "FailureCountTolerance:0.2" "FailureIndexTolerance:0.2"
*aligntoedges 1 1 1 2
Errors
Incorrect usage results in a
Tcl error. To
detect errors, you can use the
catch
command:
if { [ catch {command_name...} ] } {
# Handle error
}