You are here: Start » FIL.NET » FIS.CalibrateWorldPlane_Labeled Method

FIS.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:FilNet
Assembly:FIL.NET.dll

Syntax

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

Parameters

Name Type Range Default Description
inImageGridSystem.Collections.Generic.IList<FilNet.AnnotatedPoint2D>Annotated calibration grid.
inLabeledWorldPointsSystem.Collections.Generic.IList<FilNet.AnnotatedPoint2D>Sparse array of world coordinate points. Annotations need to correspond to those in the inImageGrid input.
inCameraModelFilNet.NullableRef<FilNet.AnyCameraModel>For undistortion of inImageGrid. If not supplied, the filter will assume that grid came from undistorted image. Default value: ftl::NIL.
inGridSpacingfloat?<0.000001f, INF>World distance between grid indices. Used when spacing cannot be computed from supplied inLabeledWorldPoints. Default value: ftl::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.
outTransformFilNet.RectificationTransform
outGridWorldPointsSystem.Collections.Generic.IList<FilNet.AnnotatedPoint2D>Array of world coordinates of the calibration grid points.
outComputedGridSpacingfloat?World distance between grid indices. NIL when there is no enough information to compute the spacing.
outRmsImageErrorfloatRMS 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.
outRmsWorldErrorfloatRMS 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.
outMaxReprojectionErrorfloatMaximum 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.
outReprojectionErrorSegmentsSystem.Collections.Generic.IList<FilNet.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.

Function Overrides

See also