You are here: Start » AVL.NET » AVS.CalibrateWorldPlane_Labeled Method

AVS.CalibrateWorldPlane_Labeled Method

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:AvlNet
Assembly:AVL.NET.dll

Syntax

public static void CalibrateWorldPlane_Labeled
(
	IList<AvlNet.AnnotatedPoint2D> inImageGrid,
	IList<AvlNet.AnnotatedPoint2D> inLabeledWorldPoints,
	NullableRef<AvlNet.AnyCameraModel> inCameraModel,
	float? inGridSpacing,
	float inGridThickness,
	bool inInvertedWorldY,
	AvlNet.RectificationTransform outTransform,
	NullableRef<List<AvlNet.AnnotatedPoint2D>> outGridWorldPoints,
	NullableRef<NullableValue<float>> outComputedGridSpacing,
	NullableValue<float> outRmsImageError,
	NullableValue<float> outRmsWorldError,
	NullableValue<float> outMaxReprojectionError,
	NullableRef<List<AvlNet.Segment2D>> outReprojectionErrorSegments
)

Parameters

Name Type Range Default Description
inImageGridSystem.Collections.Generic.IList<AvlNet.AnnotatedPoint2D>Annotated calibration grid.
inLabeledWorldPointsSystem.Collections.Generic.IList<AvlNet.AnnotatedPoint2D>Sparse array of world coordinate points. Annotations need to correspond to those in the inImageGrid input.
inCameraModelAvlNet.NullableRef<AvlNet.AnyCameraModel>For undistortion of inImageGrid. If not supplied, the filter will assume that grid came from undistorted image. Default value: atl::NIL.
inGridSpacingfloat?<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.
outTransformAvlNet.RectificationTransform
outGridWorldPointsAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.AnnotatedPoint2D>>Array of world coordinates of the calibration grid points. Can be null to skip this parameter calculation.
outComputedGridSpacingAvlNet.NullableRef<AvlNet.NullableValue<float>>World distance between grid indices. NIL when there is no enough information to compute the spacing. Can be null to skip this parameter calculation.
outRmsImageErrorAvlNet.NullableValue<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. Can be null to skip this parameter calculation.
outRmsWorldErrorAvlNet.NullableValue<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. Can be null to skip this parameter calculation.
outMaxReprojectionErrorAvlNet.NullableValue<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. Can be null to skip this parameter calculation.
outReprojectionErrorSegmentsAvlNet.NullableRef<System.Collections.Generic.List<AvlNet.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. Can be null to skip this parameter calculation.

Function Overrides

See also