You are here: Start » FIL.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:Fil
Assembly:FilNet.dll

Syntax

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

Parameters

Name Type Range Default Description
inImageGridSystem.Collections.Generic.List<Fil.AnnotatedPoint2D>Annotated calibration grid.
inLabeledWorldPointsSystem.Collections.Generic.List<Fil.AnnotatedPoint2D>Sparse array of world coordinate points. Annotations need to correspond to those in the inImageGrid input.
inCameraModelFtl.Optional<Fil.AnyCameraModel>For undistortion of inImageGrid. If not supplied, the filter will assume that grid came from undistorted image. Default value: ftl::NIL.
inGridSpacingFtl.Optional<float><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.
outTransformFil.RectificationTransform
outGridWorldPointsFtl.Optional<System.Collections.Generic.List<Fil.AnnotatedPoint2D>>Array of world coordinates of the calibration grid points.
outComputedGridSpacingFtl.Optional<Ftl.Conditional<float>>World distance between grid indices. NIL when there is no enough information to compute the spacing.
outRmsImageErrorFtl.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.
outRmsWorldErrorFtl.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.
outMaxReprojectionErrorFtl.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.
outReprojectionErrorSegmentsFtl.Optional<System.Collections.Generic.List<Fil.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