__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