*elementqualitycollapseedge

Collapses an edge between two elements.

Syntax

*elementqualitycollapseedge elem_id=<value> edge_index=<value> ?optimize=<value>?

Type

HyperMesh Tcl Modify Command

Description

This command collapses an edge between two elements.

This command only functions between an *elementqualitysetup command and an *elementqualityshutdown command.

Current element quality criteria for optimization must be set before using this command. The command may be applied at any time without resetting the current quality criteria.

Inputs

elem_id=<value>: The ID of the element.
edge_index=<value>: The index of the edge to collapse.
optimize=<value>: Option to optimize the node after the collapse operation is performed (default 0).

Example

To collapse an element of ID 20 and edge index of 2 with optimization.

*elementqualitysetup_new 2
*elementqualitycollapseedge elem_id=20 edge_index=2 optimize=1
*elementqualityshutdown 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

13.0

2023 – Updated the syntax to support name-value argument pairs and added new option optimize.