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

FIS.CalibrateWorldPlane_Labeled Method

Finds the image to world plane transformation matrix 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,
	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.
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