compose_matrix

compas.geometry.compose_matrix(scale=None, shear=None, angles=None, translation=None, perspective=None)[source]

Calculates a matrix from the components of scale, shear, euler_angles, translation and perspective.

Parameters

scale (list of float) – The 3 scale factors in x-, y-, and z-direction.
shear (list of float) – The 3 shear factors for x-y, x-z, and y-z axes.
angles (list of float) – The rotation specified through the 3 Euler angles about static x, y, z axes.
translation (list of float) – The 3 values of translation.
perspective (list of float) – The 4 perspective entries of the matrix.

Returns

list of list of float – The 4x4 matrix that combines the provided transformation components.

Examples

>>> trans1 = [1, 2, 3]
>>> angle1 = [-2.142, 1.141, -0.142]
>>> scale1 = [0.123, 2, 0.5]
>>> M = compose_matrix(scale1, None, angle1, trans1, None)
>>> scale2, shear2, angle2, trans2, persp2 = decompose_matrix(M)
>>> allclose(scale1, scale2)
True
>>> allclose(angle1, angle2)
True
>>> allclose(trans1, trans2)
True

compose_matrix

COMPAS