Back to Adaptive Vision Studio website
You are here: Start » Filter Reference » Computer Vision » World Coordinates » CalibrateWorldCoordinates_Deprecated
Module: | Calibration |
---|
Calculates the world plane for the given sets of corresponding 2D and 3D points.
Applications
Use this filter to prepare data necessary for translating image coordinates to real-world units, e.g. for robot guidance applications.
Name | Type | Description | |
---|---|---|---|
inImagePoints | Point2DArray | ||
inWorldPoints | Point3DArray | ||
outResolution | Real | ||
outWorldPlane | Position3D | Calibrated world plane | |
outError | Real | Average distance between provided points and points found on calibration plane | |
outCorrectedImagePoints | Point2DArray | Points projected to the found plane | |
outCorrectedWorldPoints | Point3DArray | World points found using output plane |
Hints
- 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_Deprecated.
- 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.
Errors
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
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 |
Complexity Level
This filter is available on Basic Complexity Level.