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