Returns calibration information associated with an image.
Reference to the image containing calibration information.
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Default: No error
Output that defines the region specified at the time of calibration.
Coordinates of the bounding rectangle.
Individual shapes that define an ROI.
Control specifying whether the contour is the external or internal edge of an ROI.
Shape type of the contour.
Relative position of the contour.
ROI that corresponds to the region of the image where the calibration information is accurate.
Coordinates of the bounding rectangle.
Individual shapes that define an ROI.
Control specifying whether the contour is the external or internal edge of an ROI.
Shape type of the contour.
Relative position of the contour.
Reference to the output image.
Information about the calibration axis.
Origin of the reference coordinate system expressed in pixel units.
Angle relative to the horizontal in degrees.
The horizontal is expressed by a row of circle centers.
Orientation of the axis.
Information about the calibrated image.
Type of calibration method used.
Name | Value | Description |
---|---|---|
perspective | 0 |
Image contains perspective calibration information. |
microplane | 1 |
Image contains nonlinear calibration information. |
simple | 2 |
Image contains simple calibration information (no perspective or nonlinear information). |
corrected | 3 |
Image has been corrected and contains calibration unit and scaling factor. |
none | 4 |
Image contains no calibration information. |
Type of distortion found in the image.
Name | Value | Description |
---|---|---|
none | -1 |
Image does not contain distortion correction. |
polynomial | 0 |
Image was calibrated using a polynomial distortion model. |
division | 1 |
Image was calibrated using the division distortion model. |
Aspect scaling used to correct the image.
Name | Value | Description |
---|---|---|
scale to preserve area | 0 |
The corrected image is scaled such that the features in the image have the same size as the input image. |
scale to fit | 1 |
The corrected image is scaled to be the same size as the input image. |
ROI used to correct the image.
Name | Value | Description |
---|---|---|
full image | 0 |
The whole image is always corrected, regardless of the user-defined or calibration-defined ROIs. |
calibration ROI | 1 |
The area defined by the Calibration ROI is corrected. The calibration ROI is computed by the algorithm and corresponds to the area of the calibration template containing dots. |
ROI | 2 |
The area defined by ROI descriptor is corrected. |
ROI AND calibration ROI | 3 |
The area defined by the intersection of the ROI and Calibration ROI is corrected. |
ROI OR calibration ROI | 4 |
The area defined by the union of the ROI and Calibration ROI is corrected. |
Value set when the calibration was learned.
Scaling constants used to calibrate the image.
Horizontal distance between points in the calibration grid in real-world units.
Vertical distance between points in the calibration grid in real-world units.
Units of x step and y step.
Range of grayscale values in a grid image that represent the circles.
This is the threshold range for detecting the centers of the circles. lower value and upper value must be between 128 and 255.
Lowest pixel value used during a manual threshold.
Default: 128
Highest pixel value used during a manual threshold.
Default: 255
Error information.
The node produces this output according to standard error behavior.
Standard Error Behavior
Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.
Error information about the calibrated image.
Mean distance error in real-world units.
Maximum distance error in real-world units.
Standard deviation of the distance errors in real-world units.
Distortion percentage as the average result produced by calculating the error divided by the distance from the optical axis for each grid point.
Output that returns the error map if determined by the Learn Calibration node.
Where This Node Can Run:
Desktop OS: Windows
FPGA: Not supported
Web Server: Not supported in VIs that run in a web application