Model.CE_MarkSplitLink

Model.CE_MarkSplitLink(collection, search_type, search_rule, search_string_array, keep_realized=0)

Splits group links into individual links.

Parameters:

• collection (Collection) – The collection containing the connector entities.

• search_type (EntityFullType) – The specific link type to search in the connector. This must be specified. The supported entities are Component, Property, Surface, Tag, Element, Node and Part.

• search_rule (unsigned int) –

  The rule by which the link entity was added to the connector:

  0 - Undefined

  1 - None

  2 - Use ID

  3 - Use Name

  4 - Proximity

  5 - Use UID

• search_string_array (hwStringList) – A string array containing the list of of link IDs/names/UIDs in the group link. The strings are generally IDs/names/UIDs based on the search_rule.

• keep_realized (unsigned int) –

  Option to keep the current connector state after the update operation:

  0 - Unrealize if needed (default)

  1 - Keep current state

Example

Split the group link of 3 components consisting of component with IDs: 1, 2 and 4 in connector with ID 5

import hm
import hm.entities as ent

model = hm.Model()

connectors = hm.Collection(model, ent.Connector, [5])

model.CE_MarkSplitLink(
    collection=connectors,
    search_type=ent.Component,
    search_rule=1,
    search_string_array=["3", "2", "4"],
    keep_realized=0,
)