hm_getshelloverlapinfo

Returns information regarding proximity overlap between a selection of components or elements.

Syntax

hm_getshelloverlapinfo source_entity_type source_mark_id target_entity_type target_mark_id maximumproximitydistance

Type

HyperMesh Tcl Query Command

Description

Returns information regarding proximity overlap between a selection of components or elements. The command returns the proximity overlap area, the overlap volume, the maximum and minimum proximity distance, the coordinates of the overlapping bounding box corners in the global system, the origin of the bounding box, and its x, y, z vectors from the origin in the following format:

<proximity_area> <proximity_volume> <max_proximity_distance> <min_proximity_distance> (Bounding Box info){{MinPointX MinPointY MinPointZ} {MaxPointX MaxPointY MaxPointZ}} (PCA Box info){{OriginX OriginY OriginZ} {XVectorX XVectorY XVectorZ} {YVectorX YVectorY YVectorZ} {ZVectorX ZVectorY ZVectorZ}}

Inputs

source_entity_type: The type of source entity. Currently supported for components and elements.
source_mark_id: The ID of the mark containing the source entities. Valid values are 1 and 2.
target_entity_type: The type of target entity. Currently supported for components and elements.
target_mark_id: The ID of the mark containing the target entities. Valid values are 1 and 2.
maxproximitydistance: Maximum proximity distance below which the overlap is calculated.

Examples

To get overlap information between component 7100314 and component 7100361 for a proximity distance of 5.0:

*createmark comps 1 7100314
*createmark comps 2 7100361
hm_getshelloverlapinfo comps 1 comps 2 5.0

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

2021.2