*equivalence

Equivalences or finds duplicate nodes of selected components or elements within a tolerance.

Syntax

*equivalence entity_type mark_id tolerance mode location numbering

Type

HyperMesh Tcl Modify

Description

Equivalences or finds duplicate nodes of selected components or elements within a tolerance.

Inputs

entity_type
The entity types to consider. Valid values are:
  • elems
  • comps
mark_id
The mark ID containing the input entities. Valid values are 1 and 2.
tolerance
The tolerance used to find neighboring nodes to equivalence.
mode
Operating mode of the command:
  • 0 - Preview found nodes.
  • 1 - Equivalence found nodes.
  • 3 - Place found nodes on user mark.
location
Location of equivalenced nodes:
  • 0 - Equivalence at the location of the node with the lowest ID.
  • 1 - Equivalence at the location of the node with the highest ID.
  • 2 - Equivalence at the midpoint of the two nodes.
numbering
The numbering of the retained node:
  • 0 - Retain the number of the node with the lowest ID.
  • 1 - Retain the number of the node with the highest ID.

Example

To equivalence the nodes of all displayed components, using a tolerance of 0.1 and keeping the location and number of the lowest ID nodes:
*createmark comps 1 displayed
*equivalence comps 1 0.1 0 0 0

Errors

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