rigid3d

3-D rigid geometric transformation

expand all in page

Description

A rigid3d object encapsulates a 3-D rigid transformation.

Creation

Syntax

tform = rigid3d
tform = rigid3d(t)
tform = rigid3d(rot,trans)

Description

example

tform = rigid3d creates a default rigid3d object that corresponds to an identity transformation.

tform = rigid3d(t) creates a rigid3d object based on a specified forward rigid transformation matrix, t. The t input sets the T property.

tform = rigid3d(rot,trans) creates a rigid3d object based on the rotation, rot, and translation, trans, components of the transformation. rot sets the Rotation property. trans sets the Translation property.

Properties

expand all

Forward rigid transformation, specified as a 4-by-4 floating point matrix. This matrix must be a homogeneous transformation matrix that satisfies the post-multiply convention given by:

[xyz1]=[uvw1]*T

T has the form

[r11r12r130;...r21r22r230;...r31r32r330;...0001];

This property is read-only.

Dimensionality of the geometric transformation, specified as a positive integer.

Rotation component of the transformation, specified as a 3-by-3 floating-point matrix. This rotation matrix satisfies the post-multiply convention given by

[xyz]=[uvw]*R

Translation component of the transformation, specified as a three-element row vector of floating-point values. This translation vector satisfies the convention given by

[xyz]=[uvw]+t

Object Functions

invertInvert geometric transformation
outputLimitsFind output spatial limits given input spatial limits
transformPointsForwardApply forward geometric transformation
transformPointsInverseApply inverse geometric transformation

Examples

collapse all

Open Live Script

Specify an angle in degrees. Set the rotation and translation components of the transformation. 

theta = 30; % degrees
rot = [ cosd(theta) sind(theta) 0; ...
       -sind(theta) cosd(theta) 0; ...
                 0           0  1];
trans = [2 3 4];
tform = rigid3d(rot,trans)
tform = 
  rigid3d with properties:

       Rotation: [3x3 double]
    Translation: [2 3 4]

See Also

Objects

Introduced in R2020a

Computer Vision Toolbox Documentation
Support