*mechrotatebody

Rotates a body of a mechanism about a normal, passing through the origin of the plane by given angle.

Syntax

*mechrotatebody name plane angle method tolerance angle_step

Type

HyperMesh Tcl Modify

Description

Rotates a body of a mechanism about a normal, passing through the origin of the plane by given angle.

The mechanism must have the enabled flag set to true for this to be possible.

Inputs

name
The name of the body of the mechanism.
plane
The plane, created using *createplane, whose normal is the axis of rotation and any point on it would be center of rotation based on the method selected. Valid values are 1 and 2.
angle
The angle to rotate the body about the plane.
method
Method to enforce rotation:
0 – Free rotation, bodies orientation is rotated by angle, can result in inverted rotation.
1 – Enforce axis, bodies orientation is rotated by angle.
2 – Enforce origin, rotation will occur about line passing through origin of plane, inverted rotation possible.
3 – Enforce origin and axis, direction of rotation and origin both are fixed (recommended).
tolerance
The tolerance allowed during the placement.
angle_step
The size of the iterative steps used to solve for the rotation.

Example

To move body "Move_Track" on the current mechanism with a tolerance of 0.001, about the global y-axis by 20 degrees, using method 3:

*createplane 1 0 1 0 -1660.82465 103.84237 418.49172
*mechrotatebody "Move_Track" 1 20 3 0.001 10

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

14.0.120