Main Content

connectedViews

Return connected views

Description

example

viewTable = connectedViews(vSet,viewId) returns a table of views from vSet that are connected to the view specified by viewId.

viewTable = connectedViews(vSet,viewId,minNumMatches) also specifies the minimum number of matched feature points in a connection for the view to be counted as a connected view.

Examples

collapse all

Create an empty imageviewset object.

vSet = imageviewset;

Add views to the image view set.

vSet = addView(vSet, 1);
vSet = addView(vSet, 2);
vSet = addView(vSet, 3);
vSet = addView(vSet, 4);

Connect views in the image view set.

vSet = addConnection(vSet,1,2);
vSet = addConnection(vSet,2,3);
vSet = addConnection(vSet,2,4);

Get the connected views for the view with ID 2.

viewTable = connectedViews(vSet,2)
viewTable=3×4 table
    ViewId    AbsolutePose      Features         Points   
    ______    ____________    ____________    ____________

      1       1x1 rigid3d     {0x0 double}    {0x0 double}
      3       1x1 rigid3d     {0x0 double}    {0x0 double}
      4       1x1 rigid3d     {0x0 double}    {0x0 double}

Input Arguments

collapse all

Image view set, specified as an imageviewset object.

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

Minimum number of matched feature points in a connection for the view to be counted as a connected view, specified as a positive integer.

Output Arguments

collapse all

One or more views, returned as a three-column table. The table must contain the columns as described in this table.

ColumnDescription
ViewID

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

AbsolutePoseAbsolute pose of the view, specified as a rigid3d object.
PointsPoint cloud for the view, specified as a pointCloud object.

See Also

Objects

Introduced in R2020a