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.
- 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:
- 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.
- location_unit_rule
- Specifies whether location unit-based segregation is desired and, if so, the type of
entities considered:
- 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:
- 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.
- edge_angle
- The edge angle value when topology_rule specifies the mesh edge
option.
- preseve_parameters
- 0 - Do not preserve
- 1 - Preserve
- max_cluster_count
- The maximim number of clusters allowed per entity instance.
Examples
Absorb all displayed loads without any
segregation:
*createmark loads 1 displayed
*absorbentities loads 1 0 0 0 0 0 0 0 0
Errors
Incorrect usage results in a
Tcl error. To detect
errors, you can use the
catch
command:
if { [ catch {command_name...} ] } {
# Handle error
}