Model.elementqualitymodifyhole#

Model.elementqualitymodifyhole(node_index, move_option, x, y, z, string_array)#

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 function only functions between an Model.elementqualitysetup() function and an Model.elementqualityshutdown() function. 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.

Parameters:

  • node_index (Entity) – The node entity on the hole/washer within the internal data structures of the interactive element cleanup and quality index edit/optimize tools.

  • move_option (int) –

    Hole node movement.

    1 - In radial direction.

    2 - In angular direction.

    3 - In radial and angular directions.

    4 - In circumferential direction.

  • x (double) – x-coordinate of a target location for the selected node used for hole/washer modification.

  • y (double) – y-coordinate of a target location for the selected node used for hole/washer modification.

  • z (double) – z-coordinate of a target location for the selected node used for hole/washer modification.

  • string_array (hwStringList) –

    The string array ID that contains the additional input parameters. 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.

Example#

Modify the hole / washer associated with node with ID 278 , use circumferential adjustments , a target point of ( 5.3 , -8.4 , and 0.0 ) , use linked hole / washer option with 2 layers of re - meshing#
import hm
import hm.entities as ent

model = hm.Model()

elems = model.CreateCollectionByDisplayed(ent.Element)
model.elementqualitysetup(elementcollection=elems)

node_index = ent.Node(model, 278)
model.elementqualitymodifyhole(node_index=node_index, move_option=4, x=5.3, y=-8.4, z=0, string_array=["LinkWasher: 1", "NumRemeshLayer: 2"])

model.elementqualityshutdown(dontsaveflag=1)