estrelpose

Calculate relative rotation and translation between camera poses

Since R2022b

Syntax

relativePose = estrelpose(M,intrinsics,inlierPoints1,inlierPoints2)

relativePose = estrelpose(M,intrinsics1,intrinsics2,inlierPoints1,inlierPoints2)

[relativePose,validPointsFraction] = estrelpose(___)

Description

relativePose = estrelpose(M,intrinsics,inlierPoints1,inlierPoints2) returns the pose of a calibrated camera relative to its previous pose. The two poses are related by the fundamental, essential, or homography matrix M. The function calculates the camera location up to scale.

relativePose = estrelpose(M,intrinsics1,intrinsics2,inlierPoints1,inlierPoints2) returns the pose of the second camera relative to the first one.

[relativePose,validPointsFraction] = estrelpose(___) additionally returns the fraction of the inlier points that project in front of both cameras.

Examples

Estimate Camera Pose Relative to Prior Pose

Load a previously calculated fundamental matrix, camera parameters, and image points for a single camera.

load("relCameraPoseData.mat")
intrinsics = cameraParams.Intrinsics;

Calculate the camera pose relative to its previous pose.

relPose = estrelpose(M,intrinsics,inlierPoints1,inlierPoints2)

relPose = 
  rigidtform3d with properties:

    Dimensionality: 3
       Translation: [0.9952 -0.0887 -0.0412]
                 R: [3x3 double]

                 A: [ 0.9911    0.0203   -0.1314    0.9952
                     -0.0196    0.9998    0.0065   -0.0887
                      0.1315   -0.0039    0.9913   -0.0412
                           0         0         0    1.0000]

Input Arguments

M — Fundamental, essential, or homography matrix

3-by-3 matrix | affinetform2d object | projtform2d object | simtform2d object

Fundamental, essential, or homography matrix, specified as a 3-by-3 matrix, an affinetform2d object, projtform2d object, or a simtform2d object containing a homography matrix. You can obtain the 3-by-3 matrix using one of these functions:

• estimateFundamentalMatrix for the fundamental matrix.

• estimateEssentialMatrix for the essential matrix

• estgeotform2d for the projective, affine, or similarity 2-D object.

Data Types: single | double

intrinsics — Camera intrinsics

cameraIntrinsics object

Camera intrinsics, specified as a cameraIntrinsics object.

intrinsics1 — Camera intrinsics for camera 1

cameraParameters object | cameraIntrinsics object

Camera intrinsics for camera 1, specified as a cameraIntrinsics object.

intrinsics2 — Camera parameters for camera 2

cameraParameters object | cameraIntrinsics object

Camera intrinsics for camera 2, specified as a cameraIntrinsics object.

inlierPoints1 — Coordinates of corresponding points in view 1

M-by-2 matrix | point feature object

Coordinates of corresponding points in view 1, specified as an M-by-2 matrix of M number of [x y] coordinates, or as one of the point feature objects described in Point Feature Types. You can obtain these points using the estimateFundamentalMatrix function or the estimateEssentialMatrix.

inlierPoints2 — Coordinates of corresponding points in view 2

M-by-2 matrix | point feature object

Coordinates of corresponding points in view 2, specified as an M-by-2 matrix of M number of [x y] coordinates, or as one of the point feature objects described in Point Feature Types. You can obtain these points using the estimateFundamentalMatrix function or the estimateEssentialMatrix.

Output Arguments

relativePose — Relative camera pose

rigidtform3d object

Relative camera pose in world coordinates, returned as a rigidtform3d object. The "R" and the "Translation" properties of the object represent the orientation and location of the camera. If you use only one camera, the properties describe the orientation and location of the second camera pose relative to the first camera pose. If you use two cameras, the matrix describes the orientation and location of camera 2 relative to camera 1.

validPointsFraction — Fraction of valid inlier points

scalar

Fraction of valid inlier points that project in front of both cameras, returned as a scalar. If validPointsFraction is too small, typically less than 0.9, it can indicate that the fundamental matrix is incorrect.

Tips

• You can calculate the camera extrinsics according to:

  relativeOrientation = relativePose.R;
  relativeLocation = relativePose.Translation;
  camPose = rigidtform3d(relativeOrientation,relativeLocation);
  extrinsics = pose2extr(camPose)

• The estrelpose function uses the inlierPoints1 and inlierPoints2 arguments to determine which of the multiple possible solutions is physically realizable. If the input M is a projtform2d object, there could be up to two solutions that are equally realizable.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

• Use in a MATLAB Function block is not supported.

Version History

Introduced in R2022b

R2022b: Recommended over relativeCameraPose

Starting in R2022b, most Computer Vision Toolbox™ functions create and perform geometric transformations using the premultiply convention. However, the relativeCameraPose function uses the postmultiply convention. Although there are no plans to remove relativeCameraPose at this time, you can streamline your geometric transformation workflows by switching to the estrelpose function, which supports the premultiply convention. For more information, see Migrate Geometric Transformations to Premultiply Convention.