*absorbentities

Absorb entities using the tabular segregation interface.

Syntax

*absorbentities entity_type mark_id value_rule tolerance location_unit_rule topology_rule face_angle edge_angle preserve_flag max_cluster_count

Type

HyperMesh Tcl Modify Command

Description

Absorb entities using the tabular segregation interface.

Inputs

entity_type
The type of entity to absorb. Currently only supported for loads and constraints.
mark_id
The ID of the mark containing the entities to absorb. Valid values are 1 and 2.
value_rule
Specifies whether value-based segregation is desired and, if so, the type of tolerance provided (valid for loads):
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
The tolerance value when value_rule is non-zero. Valid for loads.
location_unit_rule
Specifies whether location unit-based segregation is desired and, if so, the type of entities considered (valid for loads):
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
Specifies whether topology-based segregation is desired and, if so, the type of topologies considered (valid for loads):
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
The face angle value when topology_rule specifies the mesh edge option. Valid for loads.
edge_angle
The edge angle value when topology_rule specifies the mesh edge option. Valid for loads.
preseve_parameters
0 - Do not preserve
1 - Preserve
max_cluster_count
The maximum number of clusters allowed per entity instance. Valid for loads.

Examples

To absorb all displayed loads without any segregation:
*createmark loads 1 displayed
*absorbentities loads 1 0 0 0 0 0 0 0 0
To absorb all constraints:
*createmark constraints 1 all
        *absorbentities constraints 1

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

2020 2022 - Added support for constraints.