You are here: Start » AVL.NET » Invoke.CalibrateWorldPlane_Labeled

Invoke.CalibrateWorldPlane_Labeled

Finds the image to world plane transformation parameters using sparse world coordinate information, i.e. world coordinates are known for only a few points of the grid.

Namespace:Avl
Assembly:AvlNet.dll

Syntax

C++
C#
 
public static void CalibrateWorldPlane_Labeled
(
	List<Avl.AnnotatedPoint2D> inImageGrid,
	List<Avl.AnnotatedPoint2D> inLabeledWorldPoints,
	Optional<Avl.AnyCameraModel> inCameraModel,
	Optional<float> inGridSpacing,
	float inGridThickness,
	bool inInvertedWorldY,
	Avl.RectificationTransform outTransform,
	Optional<List<Avl.AnnotatedPoint2D>> outGridWorldPoints,
	Optional<Conditional<float>> outComputedGridSpacing,
	Optional<float> outRmsImageError,
	Optional<float> outRmsWorldError,
	Optional<float> outMaxReprojectionError,
	Optional<List<Avl.Segment2D>> outReprojectionErrorSegments
)

Parameters

Name Type Range Default Description
inImageGridSystem.Collections.Generic.List<Avl.AnnotatedPoint2D>Annotated calibration grid.
inLabeledWorldPointsSystem.Collections.Generic.List<Avl.AnnotatedPoint2D>Sparse array of world coordinate points. Annotations need to correspond to those in the inImageGrid input.
inCameraModelAtl.Optional<Avl.AnyCameraModel>For undistortion of inImageGrid. If not supplied, the filter will assume that grid came from undistorted image. Default value: atl::NIL.
inGridSpacingAtl.Optional<float><0.000001f, INF>World distance between grid indices. Used when spacing cannot be computed from supplied inLabeledWorldPoints. Default value: atl::NIL.
inGridThicknessfloat0.0fThe world plane will be shifted by given amount in direction perpendicular to the grid to compensate for grid thickness. Default value: 0.0f.
inInvertedWorldYboolFalseSet to true if world coordinate system has right-handed orientation, also known as mathematical or standard. Default value: False.
outTransformAvl.RectificationTransform
outGridWorldPointsAtl.Optional<System.Collections.Generic.List<Avl.AnnotatedPoint2D>>Array of world coordinates of the calibration grid points.
outComputedGridSpacingAtl.Optional<Atl.Conditional<float>>World distance between grid indices. NIL when there is no enough information to compute the spacing.
outRmsImageErrorAtl.Optional<float>RMS reprojection error of inImageGrid onto the image plane, in pixels. This is a partial error characterizing inaccuracies in perspective estimation, excluding the influence of world point labeling.
outRmsWorldErrorAtl.Optional<float>RMS reprojection error of inLabeledWorldPoints onto the world plane, in world units. This is a partial error characterizing inaccuracies with labeling of world coordinate system, excluding perspective estimation.
outMaxReprojectionErrorAtl.Optional<float>Maximum reprojection error of inImageGrid onto the image plane, in pixels. This is a partial error characterizing inaccuracies in perspective estimation, excluding the influence of world point labeling.
outReprojectionErrorSegmentsAtl.Optional<System.Collections.Generic.List<Avl.Segment2D>>Array of segments connecting inImageGrid points to their reprojections. Note that these segments depict only inaccuracies in perspective estimation - excluding inaccuracies due to the world point labeling.

See also