*trim_elems_by_multi_circular_hole

Trims shell elements with a circular hole and adds optional washer layers.

Syntax

*trim_elems_by_multi_circular_hole node_mark_id feature_angle string_array number_of_strings periphery_node_mark_id background_elem_mark_id rigid_spider

Type

HyperMesh Tcl Modify Command

Description

This command is used to trim elements with circular holes. Washer elements can optionally be added to the hole. Multiple holes can be handled at the same time.

Inputs

node_mark_id
The mark ID containing the nodes to use as the center of the holes. Valid values are 1 and 2.
feature_angle
This parameter is used to define mesh feature lines around holes and washer elements. The range should be (0, 180). It is usually set to 30.
string_array
The ID of the string array that contains the washer element information. The string array is created using the *createstringarray command. This should always be set to 1.
The first string in quotations should contain the following parameters as keywords followed by the parameters values. Keywords and the corresponding values can be separated by blanks and/or by "=":
layer_number <layers>
The number of washer element layers, > 0.
uniform_layers <flag>
The value is 1 or 0. 1 means that all layer widths are uniform.
hole_density <value>
The washer element density on the hole.
All other strings define layer width parameter groups. If uniform_layers is set to 1, only one layer width parameter group is needed. Otherwise, the number of groups should be the same as the layer number. Each group contains 2 quoted values:
width_flag <flag>
1 - Means that width_value defines the width of the layer, otherwise, it is defined as the ratio of the layer width over the hole radius.
width_value <value>
number_of_strings
Integer indicating the size (number of strings) in the string array created using *createstringarray.
periphery_node_mark_id
The output mark of periphery nodes generated on the hole. Valid values are 0, 1 and 2. If the value is set to 0, no periphery nodes are placed on the mark.
background_elem_mark_id
The output mark of background elements to be deleted in order to update the connectivity of the newly created elements and their neighbors. Valid values are 0, 1 and 2. If the value is set to 0, background elements are deleted and element connectivity is updated. Otherwise, the background elements are kept and placed on the mark.
rigid_spider
Valid values are 0, 1 and 2. If the value is set to 0, no rigid elements will be created inside the hole. If the value is set to 1, a single spider will be created inside the hole. If the value is set to 2, individual rigid elements will be created for periphery nodes.

Example

To create a hole around node 60 with a radius of 5, and 2 layers of uniform washer elements using a density of 8 and a width of 5.0:
*createmark nodes 1 60
*createstringarray 2 " hole_radius = 5.0 layer_number = 2 uniform_layers = 1 hole_density = 8"  "1 5.0"
*trim_elems_by_multi_circular_hole 1 30 1 2 0 0 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

13.0