__header__

Description

The 2D Distortion calibration tool. this tool does polynomial fit between a grid of points
for radial distortion please use the IPToolCalibrateDistortRadial tool
polynomial distortion
This fit a curve between the points and interpolates between these curves

Using the 2D Distortion Calibration Tool

1. Grab or place a prepared grid of dots/gird onto a sequence.

Distorted Grid
Example Distorted Grid 7x6

2. Use the Blob tool to locate the position of the dots on the grid.

3. On the 2D Distortion Calibration Tool's inputs page, drag the Blob tool onto the "Points" and set it for "Blobs".

4. On the 2D Distortion Calibration Tool's GeoGrid page set the grid size and calibrated spacing based on the image.  If the grid is seven dots across and six dots down set the "X Dimension" to 7 and the "Y Dimension" to 6.  Set the "Spacing(s)" for the distance between the centre two adjacent dots on the grid.

For polynomimial distortion:
At this point, if the sequence is set-up properly and the X and Y Dimensions are set to 100, the centre of the first dot will be considered (0, 0) the centre of the second dot to the right of the first dot will be considered (100, 0) etc.  The 2D Distortion Calibration Tool's Origin page allows the origin to be adjusted.  If the "World Origin X" is set to 45 then the first dot would be considered (45, 0) and the second dot to the right of the first dot would be considered (145, 0).

Note: The minimum grid size is 3x2.

Inputs

CIFViewer

Only set this is the calibration is to be attached to this viewer.

CalibrationCollection

Optional so the determined calibration(s) can be added.

PointsImage

PointsWorld

Only needed/applicable to a polynomial distortion fit

Parameters

Name

the name given to the calibration.

GridSizeX
GridSizeY

for a polynomial distortion fit is the distance between the points
effectively this does distortion and spacial calibration.

for a radial distortion the point a assumed to be sorted into a grid. Strictly this should not be necessary.

Type

as explained above

Max Error
SD Error

The errors on the evaluated points

GrabPersistance

If set the the calibration is permanently attached to the viewer
NOTE to not attach the calibration to a viewer to not set this input

Calibration

the return distortion calibration

RadialImageWidth
RadialImageHeight

The image size needed for Radial distortion calibration. Uses the minimum of the two

RadialOptions

Radial|Radial And Center|Radial And Center And Aspect
Aspect/Skew is questionaable??

RadialK1
RadialK2
RadialK3
RadialK4

Which radial k terms to evaluate. Recommend k2 and k4 __footer__