Model.hm_getalltiedentities#

Model.hm_getalltiedentities(collection, connectors=False, constrainedextranodes=True, constrainedgroups=True, constrainedrigidbodies=True, contactgroups=True, joints=True, physicalconnectivity=True, projection=True, rbe3=True, rigidlinks=True, slipringretractors=True, welds=True)#

This function identifies groups of connected parts and free parts, including tied and non-tied to the entities, within selected components.

You can select the types of components (like RBE3, welds) to be excluded or included while grouping attached entities. Mass elements are excluded when checking for connectivity. Currently enabled for LS-DYNA only.

Parameters:

  • collection (Collection) – The collection containing the entities. Must contain components.

  • connectors (bool) – Include connectors while checking connectivity. The default value is false.

  • constrainedextranodes (bool) – Include constrained extra nodes while checking connectivity. The default value is true.

  • constrainedgroups (bool) – Include constrained extra groups while checking connectivity. The default value is true.

  • constrainedrigidbodies (bool) – Include constrained rigid bodies while checking connectivity. The default value is true.

  • contactgroups (bool) – Include contact groups while checking connectivity. The default value is true.

  • joints (bool) – Include joints while checking connectivity. The default value is true.

  • physicalconnectivity (bool) – Include node-to-node connections while checking connectivity. The default value is true.

  • projection (bool) – Set to false to not compute the projection while getting the tied entities. The default value is true.

  • rbe3 (bool) – Include RBE3 elements while checking connectivity. The default value is true.

  • rigidlinks (bool) – Include rigidlinks while checking connectivity. The default value is true.

  • slipringretractors (bool) – Include slip ring retractors while checking connectivity. The default value is true.

  • welds (bool) – Include weld elements while checking connectivity. The default value is true.

Returns:

  • hwReturnStatus - Status object

  • HmQueryResultList - Result list object containing HmQueryResult objects with the following output data:

    • type (str) - The type of connectivity. Returns “group” for a group of connected parts, and “free” for free parts.

    • entityList (EntityList) - The list of entities in the group.

Examples#

Identify groups of connected parts and free parts among all components in an LS-DYNA model#
import hm
import hm.entities as ent

model = hm.Model()

comps = hm.Collection(model, ent.Component)

_, resultlist = model.hm_getalltiedentities(collection=comps)

for result in resultlist:
    print(f"Connectivity Type: {result.type}")
    print(f"Entities: {result.entityList}")