Model.absorbentities#

Model.absorbentities(entity_type, absorb_collectionset, value_rule=0, tolerance=0.0, location_unit_rule=0, topology_rule=0, face_angle=30.0, edge_angle=180.0, preserve_flag=1, max_cluster_count=4)#

Absorbs HyperMesh entities. Loads are absorbed using a tabular segregation interface. Valid groups and elements are absorbed into constraints. Properties which are supported for absorption are converted to its relative entities. In Abaqus solver interface, nonstructural mass properties are mapped to solvermass entity.

Parameters:

  • entity_type (EntityFullType) – The target entity type. Currently supported entity types are loads (e.g., LoadForce, LoadPressure,etc.), constraints, and properties.

  • absorb_collectionset (CollectionSet) – The collection set containing possibly multiple entities to absorb.

  • value_rule (unsigned int) –

    Specifies whether value-based segregation is desired and, if so, the type of tolerance provided (valid for loads). Valid values are:

    0 - Do not segregate by value

    1 - Segregate by value, tolerance is a ratio.

    2 - Segregate by value, tolerance is a percentage.

    3 - Segregate by value, tolerance is an absolute.

  • tolerance (double) – The tolerance value when value_rule is non-zero. Valid for loads.

  • location_unit_rule (unsigned int) –

    Specifies whether location unit-based segregation is desired and, if so, the type of entities considered (valid for loads). Valid values are:

    0 - Do not segregate by location unit.

    1 - Segregate by location unit, all cases considered.

    2 - Segregate by location unit, consider only 2D shells.

    4 - Segregate by location unit, consider only 2D edges.

    6 - Segregate by location unit, consider 2D shells and 2D edges.

    8 - Segregate by location unit, consider only 3D faces.

    10 - Segregate by location unit, consider 2D shells and 3D faces.

    12 - Segregate by location unit, consider 2D edges and 3D faces.

    14 - Segregate by location unit, consider 2D shells, 2D edges and 3D faces.

  • topology_rule (unsigned int) –

    Specifies whether topology-based segregation is desired and, if so, the type of topologies considered (valid for loads). Valid values are:

    0 - Do not segregate by topology.

    1 - Segregate by topology, all cases considered.

    2 - Segregate by topology, consider only non-adjoining mesh.

    4 - Segregate by topology, consider only component boundary.

    6 - Segregate by topology, consider non-adjoining mesh and component boundary.

    8 - Segregate by topology, consider only mesh edge.

    10 - Segregate by topology, consider non-adjoining mesh and mesh edge.

    12 - Segregate by topology, consider component boundary and mesh edge.

    14 - Segregate by topology, consider non-adjoining mesh, component boundary and mesh edge.

  • face_angle (double) – The face angle value when topology_rule specifies the mesh edge option. Valid for loads.

  • edge_angle (double) – The edge angle value when topology_rule specifies the mesh edge option. Valid for loads.

  • preserve_flag (unsigned int) –

    A flag the defines if parameters will be preserved. Valid values are:

    0 - Do not preserve.

    1 - Preserve.

  • max_cluster_count (unsigned int) – The maximum number of clusters allowed per entity instance. Valid for loads.

Example#

Absorbing all elements and groups into constraints without any segregation#
import hm
import hm.entities as ent

model = hm.Model()

ccolSet=hm.CollectionSet(model)
ccolSet.set(hm.Collection(model,ent.Group))
ccolSet.set(hm.Collection(model,ent.Element))

model.absorbentities(
    entity_type=ent.Constraint,
    absorb_collectionset=ccolSet
)
On this page