Model.CE_ConnectorCreateAndFERealizeForTrimMass

Model.CE_ConnectorCreateAndFERealizeForTrimMass(entitycollection, linkentitycollection, ce_rules, ce_le_rule, tolerance, num_ents, config, mass, distribution_type, param1)

Creates apply mass connectors at the specified location with certain rules, and realize them using a specified config type, mass value and distribution type.

Parameters:

• entitycollection (Collection) – The collection containing the entities as the location to apply mass connectors. Valid entities are nodes and points.

• linkentitycollection (Collection) – The collection containing the entities to link. Valid entities are nodes, elements, components and tags.

• ce_rules (unsigned int) –

  Rule to specify how a link entity is to be added to a connector:

  0 - None

  1 - User selected

  2 - Use name

• ce_le_rule (unsigned int) –

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

  0 - None

  1 - User ID

  2 - Use name

• tolerance (double) – Add entities as links only with in the given tolerance from the specified location.

• num_ents (int) –

  The number of links.

  -1 - All entities within tolerance will be added as links.

• config (unsigned int) –

  Apply mass type:

  1100 - Point mass

  1101 - Rigid mass

  1102 - Rigidlink mass

  1103 - rbe3 mass

• mass (double) – Value of the applied mass.

• distribution_type (unsigned int) –

  Apply mass distribution type:

  0 - Divide mass by nodes.

  1 - Apply mass to all nodes.

  2 - Divide mass by area.

  3 - Unit area.

• param1 (unsigned int) – Reserved for future develpment. Must be set to 0.

Example

Create 2 apply mass connectors at nodes with IDs 1 and 2, using nodes as links, adding nodes as links to the connectors using “proximity” tolerance = 10.0, and setting the remember rule to “none”. Realize connectors using “point mass” (1100), “mass value” = 100.0, distributing the mass to the link nodes using the “divide mass by nodes” method (1)

import hm
import hm.entities as ent

model = hm.Model()

nodes_collection = hm.Collection(model, ent.Node, [1, 2])
link_nodes = hm.Collection(model, ent.Node, populate=False)
model.CE_ConnectorCreateAndFERealizeForTrimMass(
    entitycollection=nodes_collection,
    linkentitycollection=link_nodes,
    ce_rules=2,
    ce_le_rule=0,
    tolerance=10.0,
    num_ents=-1,
    config=1100,
    mass=100.0,
    distribution_type=1,
    param1=0,
)