Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Computer Vision » Camera Calibration » CalibrateWorldPlane_Multigrid_Deprecated

CalibrateWorldPlane_Multigrid_Deprecated


Module: Calibration

Finds the image to world plane transformation matrix using multiple grids.

Applications

Image to world coordinates transformations.
Name Type Description
inGridImagePoints Point2DArrayArray For each grid: Array of 2D points of the calibration pattern, in the picture.
inGridIds Point2DArrayArray For each grid: Array of 2D indices of the calibration pattern, corresponding to the inGridImagePoints.
inLabeledWorldPoints Point2DArrayArray For each grid: Sparse array of world coordinate points.
inLabeledGridIds Point2DArrayArray For each grid: Array of 2D indices of the calibration pattern, corresponding to the inLabeledWorldPoints.
inCameraModel AnyCameraModel* For undistortion of inGridImagePoints. If not supplied, the filter will assume undistorted inGridImagePoints.
inGridSpacing Real* World distance between grid indices. Used when spacing cannot be computed from supplied inLabeledWorldPoints.
inInvertedWorldY Bool Set to true if the world coordinate system has inverted y axis.
outTransform RectificationTransform
outGridWorldPoints Point2DArrayArray For each grid: Array of 2D points of the calibration pattern, in the world coordinate plane.
outComputedGridSpacing Real? World distance between grid indices. NIL when there is no enough information to compute the spacing.
outRmsImageError Real RMS reprojection error of inGridIds onto the image plane, in pixels. This is a partial error characterizing inaccuracies in perspective estimation, excluding the influence of world point labeling.
outRmsWorldError Real RMS reprojection error of inLabeledGridIds onto the world plane, in world units. This is a partial error characterizing inaccuracies with labeling of world coordinate system, excluding perspective estimation.
outMaxReprojectionErrors RealArray For each grid: Maximum reprojection error of inGridIds onto the image plane, in pixels. This is a partial error characterizing inaccuracies in perspective estimation, excluding the influence of world point labeling.
outReprojectionErrorSegments Segment2DArrayArray For each grid: Array of segments connecting inGridImagePoints to reprojected inGridIds. Note that these segments depict only inaccuracies in perspective estimation, excluding inaccuracies due to the world point labeling.
outGridRotations RealArray Grids' rotations on the world plane.
outGridTranslations Vector2DArray Grids' positions on the world plane.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Array inGridImagePoints and inGridIds sizes differ
DomainError Array inGridImagePoints and inLabeledGridIds sizes differ
DomainError Array inGridImagePoints and inLabeledWorldPoints sizes differ
DomainError size at index 0
DomainError size at index 0

Complexity Level

This filter is available on Expert Complexity Level.