*absorbentities

Absorbs HyperMesh entities.

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

Absorbs HyperMesh entities. Loads are absorbed using a tabular segregation interface. Valid groups and elements are absorbed into constraints.

Inputs

entity_type: The target entity type. 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 valid groups and elements to constraints:

*absorbentities constraints

To absorb groups to constraints:

*createmark group 1 1-5
*absorbentities constraints 1

To absorb elements to constraints:

*createmark elem 1 "by comp" 10
*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

2022 - Added support for constraints.