hm_compareentitiesrotate
Generates comparison results for entities rotated about a vector.
Syntax
hm_compareentitiesrotate source_entity_type source_mark_id target_entity_type target_mark_id tolerance vec_x vec_y vec_z base_x base_y base_z angle steps ?result_type? ?review_results?
Type
HyperMesh Tcl Query
Description
Generates comparison results for entities rotated about an axis. This may find multiple matches, depending on the requested options. 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.
- vec_x
- X-coordinate of a location along rotation vector.
- vec_y
- Y-coordinate of a location along rotation vector.
- vec_z
- Z-coordinate of a location along rotation vector.
- base_x
- X-coordinate of rotation vector base.
- base_y
- Y-coordinate of rotation vector base.
- base_z
- Z-coordinate of rotation vector base.
- angle
- The rotation angle to use for searching for matches.
- steps
- The number of steps to consider. This dictates how many increments of angle are searched for matches. For example, if angle is 45 and steps is 3, the angles 45, 90 and 135 will be searched. Must be >= 1.
- 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 rotational comparison using an angle of 45 and 6 steps, of surfs 1-20 and 101-120 about the y-axis at 0,0,0:
*createmark surfs 1 1-20
*createmark surfs 2 101-120
hm_compareinit
hm_compareentitiesrotate surfs 1 surfs 2 0.1 0 1 0 0 0 0 45 6 2 0
hm_comparewriteresults C:/temp/my_compare.txt
hm_compareend
Errors
if { [ catch {command_name...} ] } {
# Handle error
}
Version History
12.0