pytransform3d.transformations.dual_quaternion_requires_renormalization

pytransform3d.transformations.dual_quaternion_requires_renormalization(dq, tolerance=1e-06)

Check if dual quaternion requires renormalization.

Dual quaternions that represent transformations in 3D should have unit norm (\(1 + 0 \epsilon\)), that is the real quaternion must have unit norm and the real and the dual quaternion must be orthogonal (their dot product should be 0).

This function checks unit norm and orthogonality of the real and dual part.

Parameters:

dqarray-like, shape (8,)

Dual quaternion to represent transform: (pw, px, py, pz, qw, qx, qy, qz)

tolerancefloat, optional (default: 1e-6)

Tolerance for check.

Returns:

requiredbool

Indicates if renormalization is required.

See also

check_dual_quaternion

Input validation of dual quaternion representation. Has an option to normalize the dual quaternion.

norm_dual_quaternion

Normalization that enforces unit norm and orthogonality of the real and dual quaternion.

assert_unit_dual_quaternion

Checks unit norm and orthogonality of real and dual quaternion.