matrix_from_quaternion

compas.geometry.matrix_from_quaternion(quaternion)

Calculates a rotation matrix from quaternion coefficients.

Parameters

quaternion ([float, float, float, float]) – Four numbers that represents the four coefficient values of a quaternion.

Returns

list[list[float]] – The 4x4 transformation matrix representing a rotation.

Raises

ValueError – If quaternion is invalid.

Examples

>>> q1 = [0.945, -0.021, -0.125, 0.303]
>>> R = matrix_from_quaternion(q1)
>>> q2 = quaternion_from_matrix(R)
>>> allclose(q1, q2, tol=1e-03)
True