You are here: Start » FIL.NET » Invoke.CalibrateWorldPlane_Multigrid

Invoke.CalibrateWorldPlane_Multigrid

Finds the image to world plane transformation parameters using multiple grids, using sparse world coordinate information.

Namespace:Fil
Assembly:FilNet.dll

Syntax

C++
C#
 
public static void CalibrateWorldPlane_Multigrid
(
	List<List<Fil.AnnotatedPoint2D>> inImageGrids,
	List<List<Fil.AnnotatedPoint2D>> inLabeledWorldPoints,
	Optional<Fil.AnyCameraModel> inCameraModel,
	Optional<float> inGridSpacing,
	float inGridThickness,
	bool inInvertedWorldY,
	Fil.RectificationTransform outTransform,
	Optional<List<List<Fil.AnnotatedPoint2D>>> outGridWorldPoints,
	Optional<Conditional<float>> outComputedGridSpacing,
	Optional<float> outRmsImageError,
	Optional<float> outRmsWorldError,
	Optional<List<float>> outMaxReprojectionErrors,
	Optional<List<List<Fil.Segment2D>>> outReprojectionErrorSegments,
	Optional<List<float>> outGridRotations,
	Optional<List<Fil.Vector2D>> outGridTranslations
)

Parameters

Name Type Range Default Description
inImageGridsSystem.Collections.Generic.List<System.Collections.Generic.List<Fil.AnnotatedPoint2D>>Array of annotated calibration grids.
inLabeledWorldPointsSystem.Collections.Generic.List<System.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 inGridImagePoints. If not supplied, the filter will assume that grids came from undistorted images. 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<System.Collections.Generic.List<Fil.AnnotatedPoint2D>>>For each grid: 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 inImageGrids 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 inLabeledGridIds onto the world plane, in world units. This is a partial error characterizing inaccuracies with labeling of world coordinate system, excluding perspective estimation.
outMaxReprojectionErrorsFtl.Optional<System.Collections.Generic.List<float>>For each grid: Maximum reprojection error of inImageGrids 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<System.Collections.Generic.List<Fil.Segment2D>>>For each grid: 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.
outGridRotationsFtl.Optional<System.Collections.Generic.List<float>>Grids' rotations on the world plane.
outGridTranslationsFtl.Optional<System.Collections.Generic.List<Fil.Vector2D>>Grids' positions on the world plane.

See also