rotm2tform

Convert rotation matrix to homogeneous transformation

Syntax

tform = rotm2tform(rotm)

Description

tform = rotm2tform(rotm) converts the rotation matrix rotm into a homogeneous transformation matrix tform. The input rotation matrix must be in the premultiply form for rotations. When using the transformation matrix, premultiply it by the coordinates to be transformed (as opposed to postmultiplying).

Examples

collapse all

Convert Rotation Matrix to Homogeneous Transformation

Open Live Script

rotm = [1 0 0 ; 0 -1 0; 0 0 -1];
tform = rotm2tform(rotm)

tform = 4×4

     1     0     0     0
     0    -1     0     0
     0     0    -1     0
     0     0     0     1

Input Arguments

collapse all

`rotm` — Rotation matrix
2-by-2-by-n array | 3-by-3-by-n array

Rotation matrix, specified as a 2-by-2-by-n or a 3-by-3-by-n array containing n rotation matrices. Each rotation matrix is either 2-by-2 or 3-by-3 and is orthonormal. The input rotation matrix must be in the premultiplied form for rotations.

Note

Rotation matrices that are not orthonormal can be normalized with the normalize function.

2-D rotation matrices are of this form:

$R = [\begin{matrix} r_{11} & r_{12} \\ r_{21} & r_{22} \end{matrix}]$

3-D rotation matrices are of this form:

$R = [\begin{matrix} r_{11} & r_{12} & r_{13} \\ r_{11} & r_{22} & r_{23} \\ r_{31} & r_{32} & r_{33} \end{matrix}]$

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

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 transformation matrix, premultiply it by the coordinates to be transformed (as opposed to postmultiplying).

2-D homogeneous transformation matrices are of this 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 this 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}]$

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

More About

collapse all

2-D Homogeneous Transformation Matrix

2-D homogeneous transformation matrices consist of both an SO(2) rotation and an xy-translation.

To read more about SO(2) rotations, see the 2-D Orthonormal Rotation Matrix section of the so2 object.

The translation is along the x-, and y-axes as a two-element column vector:

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

The SO(2) rotation matrix R is applied to the translation vector t to create the homogeneous translation matrix T. The rotation matrix is present in the upper-left of the transformation matrix as 2-by-2 submatrix, and the translation vector is present as a two-element vector in the last column.

$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 Homogeneous Transformation Matrix

3-D homogeneous transformation matrices consist of both an SO(3) rotation and an xyz-translation.

To read more about SO(3) rotations, see the 3-D Orthonormal Rotation Matrix section of the so3 object.

The translation is along the x-, y-, and z-axes as a three-element column vector:

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

The SO(3) rotation matrix R is applied to the translation vector t to create the homogeneous translation matrix T. The rotation matrix is present in the upper-left of the transformation matrix as 3-by-3 submatrix, and the translation vector is present as a three-element vector in the last column.

$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

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

Version History

Introduced in R2015a

expand all

R2023a: `rotm2tform` Supports 2-D Rotation Matrices

The rotm argument now accepts 2-D rotation matrices as a 2-by-2-by-n array and rotm2tform outputs 2-D transformation matrices as a 3-by-3-by-n array.