Model.CE_ConnectorAreaCreate

Model.CE_ConnectorAreaCreate(entitycollection, linkcollection, ent_state, ce_rules, ce_le_rule, tol_flag, tolerance, group, param1, param2)

Creates area connector(s) at the specific location(s) by collection with certain rules.

Parameters:

• entitycollection (Collection) – The collection containing the entities to specify the location of area connector(s). Valid entities are elements and surfaces

• linkcollection (Collection) – The collection containing the entities to be added to the area connector as a link. 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 with in the given tolerance from the specified connector.

• group (int) –

  Specified if do 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 elements with IDs 1, 2, 3, 6, 7, 8 and add nearest 2 of the four components specified within a tolerance of 1.0, remembers the components by their IDs, and does not group connectors after creation

import hm
import hm.entities as ent

model = hm.Model()

model.CE_ConnectorAreaCreate(
  entitycollection=hm.Collection(model, ent.Element, [1, 2, 3, 6, 7, 8]),
  linkcollection=hm.Collection(model, ent.Component, [21, 23, 24, 27]),
  ent_state=1,
  ce_rules=1,
  ce_le_rule=1,
  tol_flag=1,
  tolerance=1.0,
  group=0,
  param1=0,
  param2=0.0,
)

Note

Each created area connector displays 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.