Model.meshutils_cutjoints

Model.meshutils_cutjoints(element_collection, center_x, center_y, center_z, extent_x_n, extent_x_p, extent_y_n, extent_y_p, extent_z_n, extent_z_p, rigid_collector_name, spc_collector_name, constrain)

Cuts elements of a joint section orthogonal to the cross-sections for joint stiffness studies.

Parameters:

• element_collection (Collection) – The collection containing the element entities need to be cut.

• center_x (double) – The x-coordinate of joint center.

• center_y (double) – The y-coordinate of joint center.

• center_z (double) – The z-coordinate of joint center.

• extent_x_n (double) – The x-coordinate of the extent of the joint section to be cut in the negative direction axis direction.

• extent_x_p (double) – The x-coordinate of the extent of the joint section to be cut in the positive direction axis direction.

• extent_y_n (double) – The y-coordinate of the extent of the joint section to be cut in the negative direction axis direction.

• extent_y_p (double) – The y-coordinate of the extent of the joint section to be cut in the positive direction axis direction.

• extent_z_n (double) – The z-coordinate of the extent of the joint section to be cut in the negative direction axis direction.

• extent_z_p (double) – The x-coordinate of the extent of the joint section to be cut in the positive direction axis direction.

• rigid_collector_name (hwString) – The name of the collector in which the rigid link elements will be created. Moments can be applied to the center node of the rigid element for performing joint stiffness studies. No entities will be created if the provided name is an empty string.

• spc_collector_name (hwString) –

  The name of the collector in which the spcs will be created for constraining joint cross sections.

  An spc will also be created at the center node of the rigid elements described above, and will go into a collector named spc_collector_name_N (where N is an arbitrary number). You can include/exclude these spc collectors in multiple subcases to perform joint stiffness studies.

  No entities will be created if the provided name is an empty string.

• constrain (int) – If constrain is specified as nonzero, then nodes on the joint section periphery that do not form a proper cross-section are constrained with spcs created in spc_collector_name.

Note

Only linear shell elements will be properly cut. For any other type of element, it will simply be deleted if it is completely or partially inside the cut box.

Example

Cut the elements at section with joint center (5, 0, 30) with no extent of joint section

import hm
import hm.entities as ent

model = hm.Model()

element_collection = hm.Collection(model, ent.Element)

model.meshutils_cutjoints(
    element_collection=element_collection,
    center_x=5,
    center_y=0,
    center_z=30,
    extent_x_n=0,
    extent_x_p=0,
    extent_y_n=0,
    extent_y_p=0,
    extent_z_n=0,
    extent_z_p=0,
    rigid_collector_name="",
    spc_collector_name="",
    constrain=0,
)