__header__
3D calibration tool will setup a calibration based on a known grid in a 3 dimensional space. This tool
is useful when inspecting parts coming in at different heights, or for finding the precise 3D location on a part.
It basically matches a set of image (camera) coordinates to a set of world coordinates and create a calibrations matrix.
The same tool can be used to link the matrix to a plane and so any image point on this plane can be converted to a x,y,z point
Using the 3D Calibration Tool to do a calibration
Create a sequence to determine a set of points.
at two different planes Typically this is the blob tool, where the points are sorted and appended to each other.
Use the GEOPointsGrid tool to create the world points for these blob points.
Altermatively import an scv file that lists the x,y,z coordinates into a GEOPointsManual tools
In the parameters set the action to "DoCalib"
Using the 3D Calibration Tool to set the calibration to a plane (single camera app)
Use Plane Manual or otherwise to define a plane
In the parameters set the action to "SetPlane"
Using the 3D Calibration Tool with muliple cameras
use the IPToolCalibrateCamera3DPos. This takes as input multiple calibrations and points
Inputs
CIFViewer
the viewer to which to assign any calibration
ImagePoints
Set of Image points
WorldPoints
Matching Set of World Points
Plane
Optional: only necessay if the tool is being used to "SetPlane" and so use this plane
CalibrationCollection
Global Calibration Collection. The Calibration is put into this collection
so to be used by other tools
Parameters
Name
The calibration Name, ie the identifier in the Calibrations Collection.
Action
SetPlane: link the calibration to a plane
DoCalib: Create the Calibration Matrix
MaxError/SDError
the reported Max and SD deviation errors are part of determining the calibration (in image coordinates ie pixels)
Calibration
the calibration matrix