*aligntoedges

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
}

Version History

14.0.130