connectedViews

Return connected views

Syntax

viewTable = connectedViews(vSet,viewId)

viewTable = connectedViews(vSet,viewId,minNumMatches)

Description

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

Get Connected Views in View Set

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

vSet — Image view set

imageviewset object

Image view set, specified as an imageviewset object.

viewId — View identifier

positive integer

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

minNumMatches — Minimum number of matched feature points

positive integer

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

viewTable — One or more views

two-column table | three-column table

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

Column	Description
ViewID	View identifier, specified as an integer. View identifiers are unique to a specific view.
AbsolutePose	Absolute pose of the view, specified as a rigid3d object.
Points	Point cloud for the view, specified as a pointCloud object.

Extended Capabilities

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

Version History

Introduced in R2020a