CalibrateWorldPlane_Default


Finds the image to world plane transformation parameters from world plane calibration grid. World plane origin and axes are unspecified.

Applications:Useful for cases where the position of world plane origin is not important, e.g. distance measurements on a world plane, or image rectification for perspective removal.

Syntax

C++
C#
Python
 
def CalibrateWorldPlane_Default(
	inImageGrid: list[AnnotatedPoint2D],
	outTransform: RectificationTransform,
	/,
	*,
	inCameraModel: AnyCameraModel | None = None,
	inGridSpacing: float = 1.0,
	inGridThickness: float = 0.0
)
-> (
	outRmsError: float,
	outMaxReprojectionError: float,
	outReprojectionErrorSegments: list[Segment2D]
)

Parameters

Name Type Range Default Description
Input value inImageGrid list[AnnotatedPoint2D] Annotated calibration grid
Input value inCameraModel AnyCameraModel | None None For undistortion of inImageGrid. If not supplied, the filter will assume that grid came from undistorted image.
Input value inGridSpacing float 0.000001 - 1.0 Real-world distance between adjacent grid points.
Input value inGridThickness float 0.0 The world plane will be shifted by given amount in direction perpendicular to the grid to compensate for grid thickness.
Output value outTransform RectificationTransform
Output value outRmsError float RMS reprojection error, in pixels.
Output value outMaxReprojectionError float Maximum reprojection error, in pixels.
Output value outReprojectionErrorSegments list[Segment2D] Array of segments connecting input image points to grid reprojections.