trvec2tform

Convert translation vector to homogeneous transformation

Syntax

tform = trvec2tform(trvec)

Description

tform = trvec2tform(trvec) converts the Cartesian representation of the translation vector trvec to the corresponding homogeneous transformation tform. When using the transformation matrix, premultiply it by the coordinates to be transformed (as opposed to postmultiplying).

example

Examples

collapse all

Convert Translation Vector to Homogeneous Transformation

Open Live Script

trvec = [0.5 6 100];
tform = trvec2tform(trvec)

tform = 4×4

    1.0000         0         0    0.5000
         0    1.0000         0    6.0000
         0         0    1.0000  100.0000
         0         0         0    1.0000

Input Arguments

collapse all

`trvec` — Cartesian representation of translation vector
n-by-2 matrix | n-by-3 matrix

Cartesian representation of a translation vector, specified as an n-by-2 matrix if tform is a 3-by-3-by-n array and an n-by-3 matrix if tform is a 4-by-4-by-n array. n is the number of translation vectors. Each vector is of the form [x y] or [x y z].

Example: [0.5 6 100]

Output Arguments

collapse all

`tform` — Homogeneous transformation
3-by-3-by-n array | 4-by-4-by-n array

Homogeneous transformation, returned as a 3-by-3-by-n array or 4-by-4-by-n array. n is the number of homogeneous transformations. When using the rotation matrix, premultiply it with the coordinates to be rotated (as opposed to postmultiplying).

Example: [0 0 1 0; 0 1 0 0; -1 0 0 0; 0 0 0 1]

2-D homogeneous transformation matrices are of the form:

$T = [\begin{matrix} r_{11} & r_{12} & t_{1} \\ r_{21} & r_{22} & t_{2} \\ 0 & 0 & 1 \end{matrix}]$

3-D homogeneous transformation matrices are of the form:

$T = [\begin{matrix} r_{11} & r_{12} & r_{13} & t_{1} \\ r_{21} & r_{22} & r_{23} & t_{2} \\ r_{31} & r_{32} & r_{33} & t_{3} \\ 0 & 0 & 0 & 1 \end{matrix}]$

More About

collapse all

Homogeneous Transformation Matrices

Homogeneous transformation matrices consist of both an orthogonal rotation and a translation.

2-D Transformations

2-D transformations have a rotation θ about the z-axis:

$R_{z} (θ) = [\begin{matrix} \cos θ & - \sin θ \\ \sin θ & \cos θ \end{matrix}]$

, and a translation along the x and y axis:

$t = [\begin{matrix} x \\ y \end{matrix}]$

, resulting in the 2-D transformation matrix of the form:

$T = [\begin{matrix} R & t \\ 0_{1 \times 2} & 1 \end{matrix}] = [\begin{matrix} I_{2} & t \\ 0_{1 \times 2} & 1 \end{matrix}] \cdot [\begin{matrix} R & 0 \\ 0_{1 \times 2} & 1 \end{matrix}]$

3-D Transformations

3-D transformations contain information about three rotations about the x-, y-, and z-axes:

$R_{x} (ϕ) = [\begin{matrix} 1 & 0 & 0 \\ 0 & \cos ϕ & \sin ϕ \\ 0 & - \sin ϕ & \cos ϕ \end{matrix}], R_{y} (ψ) = [\begin{matrix} \cos ψ & 0 & \sin ψ \\ 0 & 1 & 0 \\ - \sin ψ & 0 & \cos ψ \end{matrix}], R_{z} (θ) = [\begin{matrix} \cos θ & - \sin θ & 0 \\ \sin θ & \cos θ & 0 \\ 0 & 0 & 1 \end{matrix}]$

and after multiplying become the rotation about the xyz-axes:

$\begin{array}{l} R_{x y z} = R_{x} (ϕ) R_{y} (ψ) R_{z} (θ) = \\ [\begin{matrix} \cos ϕ \cos ψ \cos θ - \sin ϕ \sin θ & - \cos ϕ \cos ψ \sin θ - \sin ϕ \cos θ & \cos ϕ \sin ψ \\ \sin ϕ \cos ψ \cos θ + \cos ϕ \sin θ & - \sin ϕ \cos ψ \sin θ + \cos ϕ \cos θ & \sin ϕ \sin ψ \\ - \sin ψ \cos θ & \sin ψ \sin θ & \cos ψ \end{matrix}] \end{array}$

and a translation along the x-, y-, and z-axis:

$t = [\begin{matrix} x \\ y \\ z \end{matrix}]$

, resulting in the 3-D transformation matrix of the form:

$T = [\begin{matrix} R & t \\ 0_{1 x 3} & 1 \end{matrix}] = [\begin{matrix} I_{3} & t \\ 0_{1 x 3} & 1 \end{matrix}] \cdot [\begin{matrix} R & 0 \\ 0_{1 x 3} & 1 \end{matrix}]$

Extended Capabilities

expand all

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Version History

Introduced in R2015a

expand all

R2023a: `trvec2tform` Supports 2-D Translation Vectors

The trvec argument now accepts 2-D translation vectors as a n-by-2 matrix and trvec2tform outputs 2-D homogeneous transformation matrices as a 3-by-3-by-n array.

trvec2tform

Syntax

Description

Examples

Convert Translation Vector to Homogeneous Transformation

Input Arguments

trvec — Cartesian representation of translation vector n-by-2 matrix | n-by-3 matrix

Output Arguments

tform — Homogeneous transformation 3-by-3-by-n array | 4-by-4-by-n array

More About

Homogeneous Transformation Matrices

Extended Capabilities

C/C++ Code Generation Generate C and C++ code using MATLAB® Coder™.

Version History

R2023a: trvec2tform Supports 2-D Translation Vectors

See Also

`trvec` — Cartesian representation of translation vector
n-by-2 matrix | n-by-3 matrix

`tform` — Homogeneous transformation
3-by-3-by-n array | 4-by-4-by-n array

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

R2023a: `trvec2tform` Supports 2-D Translation Vectors