Adams Basic Package > Adams View > View Function Builder > Design-Time Functions > Functions: M - P > ORI_ONE_AXIS

ORI_ONE_AXIS

Returns a body-fixed 313 Euler rotation sequence expressed in the global coordinate system when given a line that is parallel to, and co-directed with, a specified axis. The resulting rotation about the directed axis is arbitrary with ORI_ONE_AXIS.
If you want to simultaneously control the orientation of the x, y, and z axes, use the ORI_ALL_AXES function.

Format

ORI_ONE_AXIS (Line Point Locations, Axes Name)

Arguments

 
Line Point Locations
A 3x2 matrix containing two points that describe a line. The points are expressed in the global coordinate system.
Axed Name
A single character string indicating which axis is to be oriented along the line. The only possible values are x, y, or z (character case is insignificant).

Examples

In the following illustration, the ORI_ONE_AXIS function returns a body-fixed 313 Euler sequence:
 
Function
ORI_ONE_AXIS({{10,16,0}, {8,16,0}}, "x")
Result
180, 180, 0
In the following illustration, the ORI_ONE_AXIS function returns a body-fixed 313 Euler sequence:
 
Function
ORI_ONE_AXIS({{10,16,0}, {8,16,0}}, "z")
Result
270, 90, 90
In the following illustration, the ORI_ONE_AXIS function returns a body-fixed 313 Euler sequence:
 
Function
ORI_ONE_AXIS({{10,16,0}, {8,16,0}}, "y")
Result
90, 0, 0
Learn more about location/orientation functions.