hm_compareentitiessymmetry

Syntax

hm_compareentitiessymmetry source_entity_type source_mark_id target_entity_type target_mark_id tolerance normal_x normal_y normal_z base_x base_y base_z ?result_type? ?review_results?

Type

HyperMesh Tcl Query

Description

Generates comparison results for entities positioned symmetrically about a plane. 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.

normal_x

X-coordinate of symmetry plane normal direction.

normal_y

Y-coordinate of symmetry plane normal direction.

normal_z

Z-coordinate of symmetry plane normal direction.

base_x

X-coordinate of symmetry plane base location.

base_y

Y-coordinate of symmetry plane base location.

base_z

Z-coordinate of symmetry plane base location.

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 symmetrical comparison of surfs 1-20 and 101-120 about the xz-plane with base 0,50,0:

*createmark surfs 1 1-20
*createmark surfs 2 101-120
hm_compareinit
hm_compareentitiessymmetry surfs 1 surfs 2 0.1 0 1 0 0 50 0 2 0
hm_comparewriteresults C:/temp/my_compare.txt
hm_compareend

Errors

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

12.0