*cleanmember

Performs cleaning operations on selected members.

Syntax

*cleanmember allow_member_destruction=<value> break_angle=<value> erase_duplicated_members=<value> merge_members=<value> min_length=<value> offset_legs=<value> tolerance=<value> ?mark=<mark_id>?

Type

HyperMesh Tcl Modify Command

Description

Performs the following cleaning operations on selected members:

  • Equivalence cleaning - if two or more memberjoints are inside a tolerance radius, they are merged into only 1 memberjoint. If a member is smaller than a minimum length, start and end joints are also merged (see allow_member_destruction option).
  • Duplicate cleaning - if two or more members are sharing the same memberjoints at start or end point, additional members are removed.
  • Merge cleaning - if two or more continuous members have a connection angle less than a break angle limit, they are merged into one member.

Inputs

allow_member_destruction=<value>
The flag defining if members should be destroyed on equivalence operations. Valid values are 1 and 0. If 1, members that are connected to two memberjoints within a tolerance are destroyed.
break_angle=<value>
The break angle limit (in degrees) to define if two continuous members should be merged into a single member.
erase_duplicated_members=<value>
The flag defining if duplicate cleaning should be performed. Valid values are 0 and 1.
mark=<value>
The ID of the mark containing the members to clean. Valid values are 1 and 2. If mark isn’t provided, cleaning operations are performed on all members.
merge_members=<value>
The flag defining if merge cleaning should be performed. Valid values are 0 and 1.
min_length=<value>
The minimum allowed member length. The start and end memberjoints may be merged into one, or an offset memberjoint may be created.
offset_legs=<value>
The flag defining if two memberjoints connected by a member should be merged, or if an offset memberjoint should be created instead. Valid values are 0 and 1.
tolerance=<value>
The radius tolerance to define if two or more memberjoints should be merged.

Examples

To clean all displayed members:

*createmark elements 1 displayed
*cleanmember mark=1 allow_member_destruction=1 erase_duplicated_members=1
merge_members=1 offset_legs=0 break_angle=15 min_length=0.1 tolerance=0.01

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

2022