Model.CE_ConnectorAreaCreateFromList

Model.CE_ConnectorAreaCreateFromList(entitylist, width, offset, linkcollection, ent_state, ce_rules, ce_le_rule, tol_flag, tolerance, group, param1, param2)

Create area connector(s) at the specific location(s) by list with certain rules.

Parameters:

• entitylist (EntityList) – The list for input line or node entities that specify location of area connector(s).

• width (double) – The width of area connector(s).

• offset (double) – Create area connnector(s) offset this value from selected location.

• linkcollection (Collection) – The collection containing the entities to add to the area connector as links. Valid entities are surfaces and components

• ent_state (unsigned int) –

  Specifies whether geometry or element gets precedence during realization of connector. Currently, only element is supported.

  0 - Geometry.

  1 - Element.

• ce_rules (unsigned int) –

  Rule to specify if and how a link entity is to be added to a connector.

  0 - None.

  1 - Now.

  2 - A fe realize.

• ce_le_rule (unsigned int) –

  Rule that specifies how an entity is to be remembered by the connector.

  0 - None.

  1 - Use ID.

  2 - Use name.

• tol_flag (unsigned int) –

  Specifies if tolerance value is applicable.

  0 - Use default.

  1 - Use specified value.

• tolerance (double) – Specified to add entities only within the given tolerance from the connector.

• group (int) –

  Specified if to group after creation.

  0 - Do not group.

  1 - Group.

• param1 (int) – Reserved for future development.

• param2 (double) – Reserved for future development.

Example

Create 2 area connector at lines with IDs 1, 2, 3, 6, 7, 8 and add nearest 2 of the four components specified within a tolerance of 1.0. Remember the components by their IDs. do not group connectors after creation

import hm
import hm.entities as ent

model = hm.Model()

model.CE_ConnectorAreaCreateFromList(
  entitylist=[
        ent.Line(model, 1),
        ent.Line(model, 2),
        ent.Line(model, 3),
        ent.Line(model, 6),
        ent.Line(model, 7),
        ent.Line(model, 8),
  ],
  width=10.0,
  offset=0.0,
  linkcollection=hm.Collection(model, ent.Component, [21, 23, 24, 27]),
  ent_state=1,
  ce_le_rule=1,
  ce_rules=1,
  tol_flag=1,
  tolerance=1.0,
  group=0,
  param1=0,
  param2=0.0,
)

Note

Each created area connector is displayed as a plane with cylinders located at the corners and only the closest two components are added to it. The total number of layers defined at each area connector is 2.