Into

Modules

Documentation

classPiiCalibrationPointFinder

#include <PiiCalibrationPointFinder.h>

A class that can be used to find calibration points in a set of unreliable detections.

Description

The problem can be stated as follows: Given a set of points in known world coordinates and a possibly larger set of detected points in image coordinates, find the set of detected points that best matches the known arrangement of calibration points and calibrate the camera to them.

To speed up the search, the following assumptions are made:

  • calibration points are arranged on a planar surface (all z coordinates are either zero or one).

  • world points are given in counter-clockwise order with respect to the center of the calibration points in a right-handed coordinate system.

Constructors and destructor

(
  • double minDistance = 0.0
  • double maxDistance = INFINITY
)

Create a new point finder.

Public member functions

( )

Find the set of measurements that best matches the geometric arrangement of worldPoints.

double
double
double

Get the minimum mean square error in matching the geometric pattern to measurements.

PiiMatrix< double >

Get the coordinates of the selected calibration points.

void
(
  • double maxDistance
)
void
(
  • double minDistance
)

Function details

  • PiiCalibrationPointFinder

    (
    • double minDistance = 0.0
    • double maxDistance = INFINITY
    )

    Create a new point finder.

    Parameters
    minDistance

    the minimum allowed distance (in pixels) between two points in the calibration pattern. on the image plane. This value can be used to cut off too small detections.

    maxDistance

    the maximum allowed extent (in pixels) of the whole calibration pattern on the image plane. This is used to cut off detections that clearly deviate from the others.

  • ~PiiCalibrationPointFinder

    ()
  • PiiCalibration::RelativePosition calculateCameraPosition

    ( )

    Find the set of measurements that best matches the geometric arrangement of worldPoints.

    Parameters
    worldPoints

    known 3D coordinates of calibration points

    imagePoints

    2D locations of detected calibration (and possibly other) points in image coordinates. One should try to make this set as small as possible while still including all the calibration points. The order of image points is irrelevant. Conventional pixel coordinate system is assumed.

    intrinsic

    the intrinsic parameters of the camera.

    Returns

    the relative position of the camera with respect to the world coordinate system.

    Exceptions
    PiiCalibrationException&

    if the camera position cannot be calculated with the given data.

  • double maxDistance

    ()
  • double minDistance

    ()
  • double minError

    ()

    Get the minimum mean square error in matching the geometric pattern to measurements.

  • PiiMatrix< double > selectedPoints

    ()

    Get the coordinates of the selected calibration points.

    Returns

    the image coordinates of the calibration points as a N-by-2 matrix, in the same order they appeared in worldPoints. If calculateCameraPosition() has not been called or an error occured, an empty matrix will be returned.

  • void setMaxDistance

    (
    • double maxDistance
    )
  • void setMinDistance

    (
    • double minDistance
    )
Notes (0)

Add a note

Not a single note added yet. Be the first, add yours.