Orientation

MDL FunctionReturns two vectors that represent the z-axis and x-axis.

Description

The vectors can be computed by all supported MDL methods including:
One Axis
axis_type points to axis
where axis_type can be "X", "Y" or "Z"
axis can be Point, Vector or list [DxDyDz] or (Dx,Dy,Dz)
Two Axes
axis_type points to axis, plane_type lies in plane.
where plane_type can be "XY", "XZ", "YX", "YZ", "ZX", "ZY".
plane can be Point, Vector or list [DxDyDz] or (Dx,Dy,Dz)
Angles
Euler angles with respect to the rm marker in Deg or Rad

Signature

zv, xv = Orientation(
              angles =None, 
              degrees = False,
              rm = None, 
              axis_type = None, 
              axis = None,
            origin = Point(0.0,0.0,0.0), 
               plane_type = None, 
               plane = None, 
               mirror = False)

Input Arguments

angles
Euler angles that define the orientation.
degrees
Specify whether Euler angles are specified in radian or degree.
rm
Reference marker upon which the orientation is defined.
axis_type
Specifies which axis is defined by the argument axis.
axis
Defines the direction of the axis.
origin
Defines the origin and is only used when axis or plane is defined by Point.
plane_type
Specifies the second axis defined by the argument plane.
plane
Defines the direction of the second axis.

Return Value

zv
Vector that defines the z axis.
xv
Vector that defines the x axis.

Usage

# Define Orientation by Euler Angles
zv, xv = Orientation((90,90,0), degrees=True)
# Define Orientation by one axis
zv, xv = Orientation(axis_type=”X”, axis=Vector(0,0,1))
# Define Orientation by two axis
zv, xv = Orientation(
          axis_type = ”X”, 
          axis = Vector(0,0,1),
          plane_type = “XZ”,
          plane = Vector(1,0,0), 
          )