Back to Aurora Vision Studio website

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

DetectCalibrationGrid_Chessboard


Module: Calibration

Detects a chessboard calibration grid on the image, and returns calibration points where 4 chessboard squares meet.

Name Type Description
Input value inImage Image Input image
Input value inRoi Region* Range of pixels to be processed
Input value inBoardSize Size Number of checkerboard squares in X and Y dimensions.
Input value inFastApproximate Bool Fast filter execution, but result is approximate.
Output value outImageGrid AnnotatedPoint2DArray Detected grid

Hints

Make sure that the whole calibration grid is visible in the image. Otherwise, it will not be detected because the detection algorithm requires a few pixels wide quiet zone around the chessboard. Pay attention to the number of columns and rows, as providing misleading data may make the algorithm work incorrectly or not work at all.

Examples

DetectCalibrationGrid_Chessboard executed with inBoardSize = {10,7}

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 Input image is too small
DomainError Input image must have pixels of UInt8 type
DomainError Region of interest exceeds an input image.
DomainError Specified board is too small, minimum size is 4x4

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of DetectCalibrationGrid filter group.

See Also