CalibrateWorldCoordinates

Calculates the world plane for the given sets of corresponding 2D and 3D points.

Name	Type	Description
inImagePoints	Point2D Array
inWorldPoints	Point3D Array
outResolution	Real
outWorldPlane	Position3D	Calibrated world plane
outError	Real	Average distance between provided points and points found on calibration plane
outCorrectedImagePoints	Point2D Array	Points projected to the found plane
outCorrectedWorldPoints	Point3D Array	World points found using output plane

Use this filter to prepare data necessary for translating image coordinates to real-world units, e.g. for robot guidance applications.

Select at least four points on an image for which you know the real-world coordinates. Put these values into inImagePoints and inWorldPoints inputs.
Use the values of outResolution and outWorldPlane outputs for transforming coordinates from image to real-world units. Use these with filters such as PointToWorldCoordinates.
Please note, that this filter should not usually be executed in each iteration. It is even advisable to store its results in global parameters and disable the filter for the production system.

Description of usage of this filter can be found in examples and tutorial: Calibration of World Coordinates.

This filter can throw an exception to report error. Read how to deal with errors here: Error Handling

Error type	Description
DomainError	At least 4 points are required in CalibrateWorldCoordinates
DomainError	Number of points in inImagePoints and inWorldPoints must be equal in CalibrateWorldCoordinates

This filter is available on Basic Complexity Level.