Translation

class compas.geometry.Translation(matrix=None)[source]

Bases: compas.geometry.transformations.transformation.Transformation

Create a translation transformation.

Parameters

matrix (4x4 matrix-like, optional) – A 4x4 matrix (or similar) representing a translation.

Raises

ValueError – If the default constructor is used, and the provided transformation matrix is not a translation.

Examples

>>> T = Translation.from_vector([1, 2, 3])
>>> T[0, 3] == 1
True
>>> T[1, 3] == 2
True
>>> T[2, 3] == 3
True

>>> from compas.geometry import Vector
>>> T = Translation.from_vector(Vector(1, 2, 3))
>>> T[0, 3] == 1
True
>>> T[1, 3] == 2
True
>>> T[2, 3] == 3
True

>>> T = Translation([[1, 0, 0, 1], [0, 1, 0, 2], [0, 0, 1, 3], [0, 0, 0, 1]])
>>> T[0, 3] == 1
True
>>> T[1, 3] == 2
True
>>> T[2, 3] == 3
True

Methods

__init__([matrix])	Construct a transformation from a 4x4 transformation matrix.
concatenate(other)	Concatenate another transformation to this transformation.
concatenated(other)	Concatenate two transformations into one Transformation.
copy()	Returns a copy of the transformation.
decomposed()	Decompose the Transformation into its Scale, Shear, Rotation, Translation and Projection components.
from_change_of_basis(frame_from, frame_to)	Computes a change of basis transformation between two frames.
from_data(data)	Creates a Transformation from a data dict.
from_euler_angles(euler_angles[, static, …])	Construct a transformation from a rotation represented by Euler angles.
from_frame(frame)	Computes a transformation from world XY to frame.
from_frame_to_frame(frame_from, frame_to)	Computes a transformation between two frames.
from_list(numbers)	Creates a Transformation from a list of 16 numbers.
from_matrix(matrix)	Creates a Transformation from a 4x4 matrix-like object.
from_vector(vector)	Create a translation transformation from a translation vector.
inverse()	Returns the inverse transformation.
invert()	Invert this transformation.
inverted()	Returns the inverse transformation.
to_data()	Convert a Transformation object to a data dict.
transpose()	Transpose the matrix of this transformation.
transposed()	Create a transposed copy of this transformation.