*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 ?equivalence_to_meshnodes?

Type

HyperMesh Tcl Modify Command

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.
equivalence_to_meshnodes
Optional. The equivalencing to mesh nodes:
  • 0 - Retain the behavior with the location and numbering argument (default).
  • 1 - Ignore location and numbering argument. If one temporary node and a mesh node are to be equivalenced, always equivalence to mesh nodes and delete the temporary nodes, which are equivalenced.

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.

2021.2 - Added new optional argument equivalence_to_meshnodes.