*elementqualitymodifyhole

Modifies holes in a mesh using radial, angular and circumferential adjustment methods.

Syntax

*elementqualitymodifyhole node_index move_option x y z string_array number_of_strings

Type

HyperMesh Tcl Modify Command

Description

This command modifies holes in a mesh using radial, angular and circumferential adjustment methods. If washers are linked with the hole, then the hole and washers move together. If they are not linked, the hole and washers move independently. The surrounding elements are also re-meshed based on the number of layer specified.

This command only functions between an *elementqualitysetup command and an *elementqualityshutdown command. The index is purely a local value appropriate to that session of the tool, and it cannot be computed from the node ID you want to change.

Inputs

node_index
The index of a node on the hole/washer within the internal data structures of the interactive element cleanup and quality index edit/optimize tools.
move_option
Hole node movement.
  • 1 - In radial direction.
  • 2 - In angular direction.
  • 3 - In radial and angular directions.
  • 4 - In circumferential direction.
x
x-coordinate of a target location for the selected node used for hole/washer modification.
y
y-coordinate of a target location for the selected node used for hole/washer modification.
z
z-coordinate of a target location for the selected node used for hole/washer modification.
string_array
The string array ID that contains the additional input parameters. The string array is created using the *createstringarray command. This should always be set to 1. Valid parameters include:
InputRadius: <radius>
The target radius to use for hole/washer modification (Optional).
InputAngle: <angle>
The rotation angle to use for hole/washer modification (Optional).
InputArcLen: <length>
The circumferential arc length to use for hole/washer modification (Optional).
LinkWasher: <value>
0 - Hole and washers are not linked and move independently.
1 - Hole and washers are linked and move together.
NumRemeshLayer: <value>
The number of layers to be re-meshed after hole/washer modification.
RetainWasher: <value>
0 - Do not retain the washer of nearby holes on re-meshing.
1 - Retain the washer of nearby holes on re-meshing.
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.

Example

To modify the hole/washer associated with node index 278, using circumferential adjustments, a target point of (5.3, -8.4, and 0.0), using linked hole/washer option with 2 layers of re-meshing:
*createmark elems 1 displayed
*elementqualitysetup 1
eval *createstringarray 3 "LinkWasher: 1" "NumRemeshLayer: 2"
*elementqualitymodifyhole 278 4 5.3 -8.4 0.0 1 2
*elementqualityshutdown 1

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

11.0.130