Back to Aurora Vision Studio website

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

CalibrateWorldPlane_Multigrid_Deprecated

Expert

Module: Calibration

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

Applications

Image to world coordinates transformations.
Name Type Description
Input value inGridImagePoints Point2DArrayArray For each grid: Array of 2D points of the calibration pattern, in the picture.
Input value inGridIds Point2DArrayArray For each grid: Array of 2D indices of the calibration pattern, corresponding to the inGridImagePoints.
Input value inLabeledWorldPoints Point2DArrayArray For each grid: Sparse array of world coordinate points.
Input value inLabeledGridIds Point2DArrayArray For each grid: Array of 2D indices of the calibration pattern, corresponding to the inLabeledWorldPoints.
Input value inCameraModel AnyCameraModel* For undistortion of inGridImagePoints. If not supplied, the filter will assume undistorted inGridImagePoints.
Input value inGridSpacing Real* World distance between grid indices. Used when spacing cannot be computed from supplied inLabeledWorldPoints.
Input value inInvertedWorldY Bool Set to true if the world coordinate system has inverted y axis.
Output value outTransform RectificationTransform
Output value outGridWorldPoints Point2DArrayArray For each grid: Array of 2D points of the calibration pattern, in the world coordinate plane.
Output value outComputedGridSpacing Real? World distance between grid indices. NIL when there is no enough information to compute the spacing.
Output value 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.
Output value 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.
Output value 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.
Output value 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.
Output value outGridRotations RealArray Grids' rotations on the world plane.
Output value 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.