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,
	NullableRef<List<FilNet.AnnotatedPoint2D>> outGridWorldPoints,
	NullableRef<NullableValue<float>> outComputedGridSpacing,
	NullableValue<float> outRmsImageError,
	NullableValue<float> outRmsWorldError,
	NullableValue<float> outMaxReprojectionError,
	NullableRef<List<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
outGridWorldPointsFilNet.NullableRef<System.Collections.Generic.List<FilNet.AnnotatedPoint2D>>Array of world coordinates of the calibration grid points. Can be null to skip this parameter calculation.
outComputedGridSpacingFilNet.NullableRef<FilNet.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.
outRmsImageErrorFilNet.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.
outRmsWorldErrorFilNet.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.
outMaxReprojectionErrorFilNet.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.
outReprojectionErrorSegmentsFilNet.NullableRef<System.Collections.Generic.List<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. Can be null to skip this parameter calculation.

Function Overrides

See also