addConnection

Add connection between views in view set

Since R2020a

collapse all in page

Syntax

vSet = addConnection(vSet,viewId1,viewId2)

vSet = addConnection(vSet,viewId1,viewId2,relPose)

vSet = addConnection(vSet,viewId1,viewId2,relPose,infoMat)

vSet = addConnection(___,"Matches",featureMatches)

Description

vSet = addConnection(vSet,viewId1,viewId2) adds a connection between views viewId1 and viewId2 to the view set, vSet.

example

vSet = addConnection(vSet,viewId1,viewId2,relPose) specifies the relative pose of viewId2 with respect to viewId1.

vSet = addConnection(vSet,viewId1,viewId2,relPose,infoMat) specifies the information matrix associated with the connection.

vSet = addConnection(___,"Matches",featureMatches) specifies the indices of matched points between two views in addition to any of the input argument combinations in previous syntaxes.

Examples

collapse all

Add Connection to Image View Set

Open Live Script

Create an empty image view set.

vSet = imageviewset;

Read two images into the workspace.

imageDir = fullfile(toolboxdir('vision'),'visiondata', ...
  'structureFromMotion');
I1 = im2gray(imread(fullfile(imageDir,'image1.jpg')));
I2 = im2gray(imread(fullfile(imageDir,'image2.jpg')));

Detect interest points in each image.

points1 = detectSURFFeatures(I1);
points2 = detectSURFFeatures(I2);

Extract feature descriptors from the interest points.

[features1,validPoints1] = extractFeatures(I1,points1);
[features2,validPoints2] = extractFeatures(I2,points2);

Add the features and points for the two images to the image view set.

vSet = addView(vSet,1,'Features',features1,'Points',validPoints1);
vSet = addView(vSet,2,'Features',features2,'Points',validPoints2);

Match the features between the two images.

indexPairs = matchFeatures(features1,features2);

Store the matched features as a connection in the image view set.

vSet = addConnection(vSet,1,2,'Matches',indexPairs);

Input Arguments

collapse all

`vSet` — Image view set
`imageviewset` object

Image view set, specified as an imageviewset object.

`viewId1` — View identifier 1
positive integer

View identifier 1, specified as an integer. View identifiers are unique to a specific view.

`viewId2` — View identifier 2
positive integer

View identifier 2, specified as an integer. View identifiers are unique to a specific view.

`relPose` — Relative pose
`rigidtform3d` object | `simtform3d` object

Relative pose of viewId2 with respect to viewId1, specified as a rigidtform3d or simtform3d object.

`infoMat` — Information matrix
6-by-6 numeric matrix

Information matrix associated with the connection, specified as a 6-by-6 numeric matrix.

`featureMatches` — Indices of matched points between two views
M-b-2 matrix

Indices of matched points between two views, specified as an M-b-2 matrix.

Output Arguments

collapse all

`vSet` — View set with added connections
`imageviewset` object

View set with added connections between views, returned as an imageviewset object.

Extended Capabilities

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

Version History

Introduced in R2020a

expand all

R2022b: Supports premultiply geometric transformation convention

Starting in R2022b, most Computer Vision Toolbox™ functions create and perform geometric transformations using the premultiply convention. Accordingly, you can now specify relPose as a rigidtform3d or simtform3d object, which use the premultiply convention.

Although you can still specify relPose as a rigid3d or affine3d object, these objects are not recommended because they use the postmultiply convention. The addConnection function automatically converts the pose to the premultiply convention and returns an imageviewset object that represents the pose as a rigidtform3d or simtform3d object.

For more information, see Migrate Geometric Transformations to Premultiply Convention.

addConnection

Syntax

Description

Examples

Add Connection to Image View Set

Input Arguments

`vSet` — Image view set
`imageviewset` object

`viewId1` — View identifier 1
positive integer

`viewId2` — View identifier 2
positive integer

`relPose` — Relative pose
`rigidtform3d` object | `simtform3d` object

`infoMat` — Information matrix
6-by-6 numeric matrix

`featureMatches` — Indices of matched points between two views
M-b-2 matrix

Output Arguments

`vSet` — View set with added connections
`imageviewset` object

Extended Capabilities

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

Version History

R2022b: Supports premultiply geometric transformation convention

See Also

Functions

Objects

addConnection

Syntax

Description

Examples

Add Connection to Image View Set

Input Arguments

vSet — Image view set imageviewset object

viewId1 — View identifier 1 positive integer

viewId2 — View identifier 2 positive integer

relPose — Relative pose rigidtform3d object | simtform3d object

infoMat — Information matrix 6-by-6 numeric matrix

featureMatches — Indices of matched points between two views M-b-2 matrix

Output Arguments

vSet — View set with added connections imageviewset object

Extended Capabilities

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

Version History

R2022b: Supports premultiply geometric transformation convention

See Also

Functions

Objects

`vSet` — Image view set
`imageviewset` object

`viewId1` — View identifier 1
positive integer

`viewId2` — View identifier 2
positive integer

`relPose` — Relative pose
`rigidtform3d` object | `simtform3d` object

`infoMat` — Information matrix
6-by-6 numeric matrix

`featureMatches` — Indices of matched points between two views
M-b-2 matrix

`vSet` — View set with added connections
`imageviewset` object

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