addConnection

Add connection between views in view set

Since R2020a

Syntax

vSet = addConnection(vSet,viewId1,viewId2)

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

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

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.

Examples

collapse all

Add Connection to Point Cloud View Set

Open Live Script

Create an empty point cloud view set.

vSet = pcviewset;

Load point cloud data.

data = load('livingRoom.mat');
ptCloud1 = data.livingRoomData{1};
ptCloud2 = data.livingRoomData{2};

Add ptCloud1 to the point cloud view set. Specify a rigidtform3d object as the origin.

absPose1 = rigidtform3d;
vSet = addView(vSet,1,absPose1,'PointCloud',ptCloud1);

Add ptCloud2 to the point cloud view set. Specify a rigidtform3d object as the origin.

vSet = addView(vSet,2,absPose1,'PointCloud',ptCloud2);

Estimate the rigid transformation between the two point clouds.

ptCloud2Downsampled = pcdownsample(ptCloud2,'gridAverage',0.1);
gridStep = 0.5;
relPose = pcregisterndt(ptCloud2Downsampled,ptCloud1,gridStep);

Add a connection between the views.

vSet = addConnection(vSet,1,2,relPose);

Compute the accumulated absolute pose.

absPose2 = rigidtform3d(absPose1.A * relPose.A);

Update the absolute pose of second view.

vSet = updateView(vSet,2,absPose2);

Input Arguments

collapse all

`vSet` — Point cloud view set
`pcviewset` object

Point cloud view set, specified as a pcviewset 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

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

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

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

Output Arguments

collapse all

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

View set with added connections between views, returned as a pcviewset 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 the relPose argument as a rigidtform3d object, which uses the premultiply convention.

Although you can still specify relPose as a rigid3d object, this object is not recommended because it uses the postmultiply convention. The addConnection function automatically converts the relative pose to the premultiply convention and returns a pcviewset object that represents the pose as a rigidtform3d object.

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

addConnection

Syntax

Description

Examples

Add Connection to Point Cloud View Set

Input Arguments

`vSet` — Point cloud view set
`pcviewset` object

`viewId1` — View identifier 1
positive integer

`viewId2` — View identifier 2
positive integer

`relPose` — Relative pose
`rigidtform3d` object

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

Output Arguments

`vSet` — View set with added connections
`pcviewset` 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

Objects

addConnection

Syntax

Description

Examples

Add Connection to Point Cloud View Set

Input Arguments

vSet — Point cloud view set pcviewset object

viewId1 — View identifier 1 positive integer

viewId2 — View identifier 2 positive integer

relPose — Relative pose rigidtform3d object

infoMat — Information matrix 6-by-6 numeric matrix

Output Arguments

vSet — View set with added connections pcviewset 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

Objects

`vSet` — Point cloud view set
`pcviewset` object

`viewId1` — View identifier 1
positive integer

`viewId2` — View identifier 2
positive integer

`relPose` — Relative pose
`rigidtform3d` object

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

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

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