Model.add_multi_washer_elements#

Model.add_multi_washer_elements(node_collection, feature_angle, string_array, periphery_node_collection, background_elem_collection, rigid_spider, local_cordinate_system)#

This function is used to add washer elements to circular holes of shell meshes. Multiple holes can be handled at a time.

Parameters:

  • node_collection (Collection) – The collection containing the node entities on circular holes to add washers.

  • feature_angle (double) – Defines the mesh feature lines around washer elements. The range should be (0, 180). It is usually set to 30.0.

  • string_array (hwStringList) –

    The list of parameter strings. The first string in quotations should contain the following parameters as keywords followed by the value. Keywords and the corresponding values can be separated by blanks and/or by =:

    • layer_number <layers>

    The number of washer element layers, must be greater than 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 = 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 - The 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>

    Defines the width of the layer.

  • periphery_node_collection (Collection) – The output collection of periphery nodes generated on the hole.

  • background_elem_collection (Collection) – The output collection of background elements to be deleted in order to update the connectivity of the newly created elements and their neighbors.

  • rigid_spider (int) –

    Valid values are:

    0 - No rigid elements will be created inside the hole.

    1 - A single spider will be created inside the hole.

    2 - Individual rigid elements will be created for periphery nodes.

  • local_cordinate_system (int) – When local_cordinate_system=1 a local coordinate system will be created in the plane of the hole.

Example#

Add washer elements around the hole contain node with ID 60 , use 2 element layers of uniform size , a density of 8 and a width of 5.0#
import hm
import hm.entities as ent

model = hm.Model()

node_col = hm.Collection(model, ent.Node, [60])

parameter_list = ["layer_number = 2 uniform_layers = 1 hole_density = 8", "1 5.0"]

model.add_multi_washer_elements(
    node_collection=node_col,
    feature_angle=30.0,
    string_array=parameter_list,
    periphery_node_collection=hm.Collection(model, ent.Node, populate=False),
    background_elem_collection=hm.Collection(model, ent.Element, populate=False),
    rigid_spider=1,
    local_cordinate_system=1,
)