__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.
 |
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
- polynomial distortion
- radial distortion
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__