boofcv.alg.geo.pose

Class P3PFinsterwalder

java.lang.Object

boofcv.alg.geo.pose.P3PFinsterwalder

All Implemented Interfaces:

P3PLineDistance

public class P3PFinsterwalder
extends java.lang.Object
implements P3PLineDistance

Solves for the 3 unknown distances between camera center and 3 observed points by finding a root of a cubic polynomial and the roots of two quadratic polynomials. Proposed by Finsterwalder in 1903, this implementation is based off the discussion in [1]. There are up to four solutions.

See P3PLineDistance for a more detailed problem description.

[1] Haralick, Robert M. and Lee, Chung-Nan and Ottenberg, Karsten and Nolle, Michael, "Review and analysis of solutions of the three point perspective pose estimation problem" Int. J. Comput. Vision, 1994 vol 13, no. 13, pages 331-356

Constructor Summary

Constructors

Constructor and Description
P3PFinsterwalder(PolynomialRoots rootFinder) Configure

Method Summary

Modifier and Type	Method and Description
FastQueue<PointDistance3>	getSolutions() Returns a set of solutions.
boolean	process(Point2D_F64 obs1, Point2D_F64 obs2, Point2D_F64 obs3, double length23, double length13, double length12) Solve for the distance between the camera's origin and each of the 3 points in 3D space.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

P3PFinsterwalder

public P3PFinsterwalder(PolynomialRoots rootFinder)

Configure

Parameters:

rootFinder - Root finder for a 3rd order polynomial with real roots

Method Detail

process

public boolean process(Point2D_F64 obs1,
                       Point2D_F64 obs2,
                       Point2D_F64 obs3,
                       double length23,
                       double length13,
                       double length12)

Description copied from interface: P3PLineDistance

Solve for the distance between the camera's origin and each of the 3 points in 3D space.

Specified by:

process in interface P3PLineDistance

Parameters:

obs1 - Observation of P1 in normalized image coordinates

obs2 - Observation of P2 in normalized image coordinates

obs3 - Observation of P3 in normalized image coordinates

length23 - Distance between points P2 and P3

length13 - Distance between points P1 and P3

length12 - Distance between points P1 and P2

Returns:

true if successful or false if it failed to generate any solutions

getSolutions

public FastQueue<PointDistance3> getSolutions()

Description copied from interface: P3PLineDistance

Returns a set of solutions. Each solution contains the distance to the respective point.

Specified by:

getSolutions in interface P3PLineDistance

Returns:

List of solutions.