# CalibratePoints

The CalibratePoints function Functions are tools that are available in Spreadsheet for processing and analyzing acquisitions or other results. You can add functions to your Spreadsheet job to create tool chains and produce results for specific applications. is used to compute transformations with correct perspective (linear) and lens (non-linear) distortions.

## CalibratePoints Overview

CalibratePoints uses a reference to a set of calibration points and a lens distortion model to compute a transformation mapping between image and real-world coordinates. It can be used in any calibration tool which requires a Calib data structure as input.

## CalibratePoints Inputs

Parameter | Description
--- | ---
Calibration Points | Reference to a cell containing a CalibPoints data structure which will be used to construct the coordinate transform.
Lens Distortion | The linear or non-linear lens distortion model to use in mapping real world to image coordinates.
0 = No lens distortion | Only account for perspective distortion.
1 = Center radial distortion | Account for minor radial distortion that originates from the center of the image.
2 = Off-center radial distortion | Account for radial distortion originating from areas other than the center of the image.
3 = Projection distortion | Account for distortion caused by fish-eye and wide-angle lenses
4 = Broad distortion | Account for lens distortion ranging from minor to sever.
Timeout | Specifies a length of time (milliseconds) to allow the CalibratePoints function to run. Function execution stops when the time out has been exceeded. (Minimum = 0, Maximum = 9999999, Default = 30000) Note: 0 disables the timeout feature.

## CalibratePoints Outputs

Returns | A Calib data structure which can be used as an input to any calibration tool requiring a transformation such as TransformImage, TransWorldToPixel, CalibrateImage, etc.