*equivalence

Equivalences or finds duplicate nodes of selected components, elements or nodes 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 and nodes.
mark_id
The ID of the mark 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 1 0 0
To equivalence nodes 1-100, using a tolerance of 0.1 and keeping the location and number of the lowest ID nodes:
*createmark nodes 1 1-100
*equivalence nodes 1 0.1 1 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
}

Version History

2019 - Added support for entity_type nodes.