Main Content

findConnection

Find connections associated with view identifiers

Since R2021b

collapse all in page

Syntax

conn = findConnection(vSet,viewIds1,viewIds2)

Description

conn = findConnection(vSet,viewIds1,viewIds2) finds the connections between the specified view identifiers viewIds1 and viewIds2 and returns the connection attributes conn.

example

Examples

collapse all

Open Live Script

Create an empty imageviewset object.

vSet = imageviewset;

Add three views to the view set.

viewId1 = 10;
viewId2 = 5;
viewId3 = 2;
vSet = addView(vSet,viewId1);
vSet = addView(vSet,viewId2);
vSet = addView(vSet,viewId3);

Add a connection between viewId1 and viewId2.

relPose1 = rigidtform3d(eye(3),[0 0 1]);
vSet = addConnection(vSet,viewId1,viewId2,relPose1);

Add a connection between viewId2 and viewId3.

relPose2 = rigidtform3d(eye(3),[0 0 2]);
vSet = addConnection(vSet,viewId2,viewId3,relPose2);

Find the connection between viewId1 and viewId2.

conn = findConnection(vSet,viewId1,viewId2)
conn=1×5 table
    ViewId1    ViewId2       RelativePose       InformationMatrix      Matches   
    _______    _______    __________________    _________________    ____________

      10          5       {1x1 rigidtform3d}      {6x6 double}       {0x2 uint32}

Check the relative pose between viewId1 and viewId2.

conn.RelativePose{:}
ans = 
  rigidtform3d with properties:

    Dimensionality: 3
       Translation: [0 0 1]
                 R: [3x3 double]

                 A: [1     0     0     0
                     0     1     0     0
                     0     0     1     1
                     0     0     0     1]

Input Arguments

collapse all

Image view set, specified as an imageviewset object.

Initial view identifiers, specified as an M-element vector of integers. Each view identifier is unique to a specific view.

Connected view identifiers, specified as an M-element vector of integers. Each view identifier is unique to a specific view.

Output Arguments

collapse all

Connection attributes, returned as a five-column table. The table contains the columns ViewId1, ViewId2, RelativePose, InformationMatrix, and Matches.

Extended Capabilities

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

Version History

Introduced in R2021b

See Also

Objects