Model.CE_ConnectorCombine#

Model.CE_ConnectorCombine(collection, tolerance, ignore_links=0, overlaps=100)#

Combines connectors. Locates connectors that are considered subsets of other connectors within a given tolerance, makes supersets from the connectors having at least one common link entity, and deletes the original subsets.

To make a combination possible, connectors must have at least one shared link entity.

Note

Currently supported for connectors located at geometric points only.

Parameters:

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

  • tolerance (double) – The maximum distance between two connectors that are considered to be duplicates.

  • ignore_links (int) – Reserved for future development. Must be set to 0.

  • overlaps (int) – Reserved for future development. Must be set to 100.

Example#

Combine displayed connectors within 0.05 tolerance#
import hm
import hm.entities as ent

model = hm.Model()
connectors = hm.CollectionByDisplayed(model, ent.Connector)
model.CE_ConnectorCombine(collection=connectors, tolerance=0.05)