This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Determine whether image contains epipole


isIn = isEpipoleInImage(F,imageSize)
isIn = isEpipoleInImage(F',imageSize)
[isIn,epipole] = isEpipoleInImage(___)


isIn = isEpipoleInImage(F,imageSize) determines whether the first stereo image associated with the fundamental matrix F contains an epipole. imageSize is the size of the first image, and is in the format returned by the function size.

isIn = isEpipoleInImage(F',imageSize) determines whether the second stereo image associated with the fundamental matrix F' contains an epipole.

[isIn,epipole] = isEpipoleInImage(___) also returns the epipole.


collapse all

% Load stereo point pairs.
    load stereoPointPairs
    f = estimateFundamentalMatrix(matchedPoints1, matchedPoints2, 'NumTrials', 2000);
    imageSize = [200 300];
% Determine whether the image contains epipole and epipole location.     
    [isIn,epipole] = isEpipoleInImage(f,imageSize)
isIn = logical

epipole = 1×2

  256.5465  100.0140

Input Arguments

collapse all

Fundamental matrix, specified as a 3-by-3 matrix computed from stereo images. F must be double or single. If P1 represents a point in the first image I1 that corresponds to P2, a point in the second image I2, then:

[P2,1] * F * [P1,1]’ = 0

In computer vision, the fundamental matrix is a 3-by-3 matrix which relates corresponding points in stereo images. When two cameras view a 3-D scene from two distinct positions, there are a number of geometric relations between the 3-D points and their projections onto the 2-D images that lead to constraints between the image points. Two images of the same scene are related by epipolar geometry.

Image size, specified in the format returned by the size function.

Output Arguments

collapse all

Valid epipole logical, specified as true when the image contains an epipole, and false when the image does not contain an epipole.

When the image planes are at a great enough angle to each other, you can expect the epipole to be located in the image.

When the image planes are at a more subtle angle to each other, you can expect the epipole to be located outside of the image, (but still in the image plane).

Location of epipole, returned as a 1-by-2 vector.

Extended Capabilities

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

Introduced in R2011a