Table Of Contents
Get Calibration Information (G Dataflow)
Returns calibration information associated with an image.
reference image
Reference to the image containing calibration information.
return error information
error in
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
user ROI descriptor
Output that defines the region specified at the time of calibration.
global rectangle
Coordinates of the bounding rectangle.
contours
Individual shapes that define an ROI.
ID
Control specifying whether the contour is the external or internal edge of an ROI.
type
Shape type of the contour.
coordinates
Relative position of the contour.
calibration ROI descriptor
ROI that corresponds to the region of the image where the calibration information is accurate.
global rectangle
Coordinates of the bounding rectangle.
contours
Individual shapes that define an ROI.
ID
Control specifying whether the contour is the external or internal edge of an ROI.
type
Shape type of the contour.
coordinates
Relative position of the contour.
calibrated image dup
Reference to the output image.
calibration axis info
Information about the calibration axis.
origin pixel
Origin of the reference coordinate system expressed in pixel units.
angle relative to horizontal (deg)
Angle relative to the horizontal in degrees.
The horizontal is expressed by a row of circle centers.
axis reference
Orientation of the axis.
calibration learn setup
Information about the calibrated image.
method
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. |
distortion
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. |
corrected image scaling
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. |
corrected image learn ROI
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. |
learn correction table?
Value set when the calibration was learned.
grid descriptor
Scaling constants used to calibrate the image.
x step
Horizontal distance between points in the calibration grid in real-world units.
y step
Vertical distance between points in the calibration grid in real-world units.
unit
Units of x step and y step.
threshold range
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.
lower value
Lowest pixel value used during a manual threshold.
Default: 128
upper value
Highest pixel value used during a manual threshold.
Default: 255
error out
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 statistics
Error information about the calibrated image.
mean error
Mean distance error in real-world units.
maximum error
Maximum distance error in real-world units.
standard deviation
Standard deviation of the distance errors in real-world units.
% distortion
Distortion percentage as the average result produced by calculating the error divided by the distance from the optical axis for each grid point.
error map
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