Table Of Contents

Convert Pixel Position to Real World (G Dataflow)

Last Modified: October 25, 2017

Transforms pixel coordinates to real-world coordinates, according to the calibration information contained in the image.

Calibration information is attached to this image by the Learn Calibration Template node, the Set Simple Calibration node, or the Set Calibration Information node.

connector_pane_image
datatype_icon

calibrated image

Reference to the input image that has attached calibration information.

datatype_icon

pixel coordinates

Cluster of pixel coordinates to convert to real-world coordinates.

datatype_icon

array of pixel coordinates

Array of pixel coordinate clusters to convert to real-world coordinates.

If both pixel coordinates and array of pixel coordinates are connected, the node uses array of pixel coordinates.

datatype_icon

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.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

calibrated image dup

Reference to the output image.

This image is identical to the input calibrated image.

datatype_icon

real-world coordinates

Cluster of real-world point coordinates that correspond to the points specified by pixel coordinates.

datatype_icon

valid coordinates

Boolean that returns if the transformed coordinate lies within or outside the ROI.

True The transformed coordinate lies inside the ROI
False The transformed coordinate lies outside the ROI

Default: TRUE

datatype_icon

array of real-world coordinates

Array of real-world point coordinates corresponding to the coordinates specified by array of pixel coordinates.

datatype_icon

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 in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.
datatype_icon

array of valid coordinates

Array of Boolean values specifying if each transformation of the array of pixel coordinates is valid, according to the region selected in the corrected image learn ROI of the Learn Calibration Template node.

Depending on which areas of the image were calibrated, not all pixel positions can be converted to real-world coordinates.

True Transformation is valid
False Transformation is not valid

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics