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

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