hm_compareentitiesposition

Generates comparison results for entities positioned at a specific location.

Syntax

hm_compareentitiesposition source_entity_type source_mark_id target_entity_type target_mark_id tolerance n1_source n2_source n3_source n1_target n2_target n3_target ?result_type? ?review_results?

Type

HyperMesh Tcl Query

Description

Generates comparison results for entities positioned at a specific location. This must be preceded by a call to hm_compareinit.

These results can then be queried using hm_compareget* APIs, or written to a file using hm_comparewrite* APIs.

Inputs

source_entity_type
The type of source entity. Valid values are surfs or elems.
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. Valid values are surfs or elems.
target_mark_id
The ID of the mark containing the target entities. Valid values are 1 and 2.
tolerance
The tolerance value to use for the comparison.
n1_source
The node ID for the source entity base (N1).
n2_source
The node ID for the source entity x-direction (N2).
n3_source
The node ID for the source entity xy-plane (N3).
n1_target
The node ID for the target entity base (N1).
n2_target
The node ID for the target entity x-direction (N2).
n3_target
The node ID for the target entity xy-plane (N3).
result_type
  SURFS to SURFS SURFS to ELEMS ELEMS to SURFS ELEMS to ELEMS
0 - Basic

Matched (paired)

Unmatched

Matched (paired)

Unmatched

Matched

Unmatched

1 - Full (default)

Matched (paired)

Overlapped

Intersected

Unmatched

Matched (paired)

Overlapped

Intersected

Unmatched

Matched

Overlapped

Intersected

Unmatched

2 - Detailed

Matched (paired)

Overlapped (paired)

Intersected (paired)

Unmatched

Matched (paired)

Overlapped (paired)

Intersected (paired)

Unmatched

Matched

Overlapped

Intersected

Unmatched

review_results
0 - Do not automatically show the graphical comparison results after execution.
1 - Automatically show the graphical comparison results after execution (default). This is cleared upon a call to hm_compareend.

Example

To write the detailed comparison results file to C:/temp/my_compare.txt for the comparison of surfs 1-20 and 101-120 with source N1/N2/N3 nodes 100/101/102 and target N1/N2/N3 nodes 200/201/202:

*createmark surfs 1 1-20
*createmark surfs 2 101-120
hm_compareinit
hm_compareentitiesposition surfs 1 surfs 2 0.1 100 101 102 200 201 202 2 0
hm_comparewriteresults C:/temp/my_compare.txt
hm_compareend

Errors

None.

Version History

12.0