dual_quat_to_screw — Convert a unit dual quaternion into a screw.
The operator dual_quat_to_screw converts the input unit dual quaternion DualQuaternion, which represents a 3D rigid transformation, into the parameters of the corresponding screw.
For a brief introduction to dual quaternions, the used notation, and the relationship between dual quaternions and screws, see the documentation of this chapter (Transformations / Dual Quaternions).
A screw is described by the direction of the screw axis with , the moment of the screw axis with , the screw angle , and the screw translation .
If ScrewFormat is set to 'moment', these parameters are returned in the corresponding parameters AxisDirectionX, AxisDirectionY, AxisDirectionZ, AxisMomentOrPointX, AxisMomentOrPointY, AxisMomentOrPointZ, Rotation, and Translation.
For convenience reasons, it is also possible to query the point on the screw axis that is closest to the origin instead of the moment of the screw axis. For this, ScrewFormat must be set to 'point'. In this case, the coordinates of the point are returned in AxisMomentOrPointX, AxisMomentOrPointY, and AxisMomentOrPointZ.
dual_quat_to_screw assumes that the input DualQuaternion is a unit dual quaternion, and hence represents a 3D rigid transformation. Otherwise the returned screw parameters are not meaningful. Further note that the screw axis for an identity transformation, i.e., no rotation and no translation, is undefined. In this case is arbitrarily set to .
Unit dual quaternion.
Format of the screw parameters.
Default value: 'moment'
List of values: 'moment', 'point'
X component of the direction vector of the screw axis.
Y component of the direction vector of the screw axis.
Z component of the direction vector of the screw axis.
X component of the moment vector or a point on the screw axis.
Y component of the moment vector or a point on the screw axis.
Z component of the moment vector or a point on the screw axis.
Rotation angle in radians.
dual_quat_compose, dual_quat_conjugate, dual_quat_interpolate
pose_to_dual_quat, dual_quat_normalize, serialize_dual_quat, deserialize_dual_quat, dual_quat_trans_line_3d, screw_to_dual_quat