Table Of Contents

Quantify (G Dataflow)

Last Modified: June 25, 2019

Quantifies the contents of an image or the regions within an image.

The region definition is performed with a labeled image mask. Each region of the mask has a single unique value.

connector_pane_image
datatype_icon

image in

Reference to the source image.

datatype_icon

image mask

Labeled version of the source image that specifies the regions to quantify.

This image must be an 8-bit image or 16-bit image. Only the pixels in the original image that correspond to an equivalent pixel in the mask different from 0 are used for the quantification. Each pixel in this image (mask) indicates, by its value, which region belongs to the corresponding pixel in image in. Up to 255 different regions for an 8-bit image, or 65,535 regions for a 16-bit image, can be quantified directly from the image in. A quantification is performed on the complete image if the image mask is not connected.

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

image out

Reference to image in.

datatype_icon

global report

Cluster containing the quantification data relative to all the regions within an image, or to the entire image if the image mask is not connected.

This cluster contains the following elements:

datatype_icon

mean value

Mean value of the pixels.

datatype_icon

standard variation

Distribution of the values in relation to the average.

The higher this value, the better the distribution of the pixel values.

datatype_icon

minimal value

Smallest pixel value.

datatype_icon

maximal value

Largest pixel value.

datatype_icon

area (calibrated)

Analyzed surface area in user-defined units.

datatype_icon

area (pixels)

Analyzed surface area in pixels.

datatype_icon

%

Percentage of the analyzed surface in relation to the complete image.

datatype_icon

calibration valid

Boolean indicator specifying whether the calibration information is valid.

A pixel has invalid calibration information when the pixel lies outside the area of the image that was calibrated. area (calibrated) contains the sum of all the area (calibrated) measurements for every region report regardless of whether the region has valid or invalid calibration information.

True Calibration information is valid for the image.
False Calibration information is invalid for any of the regions.
datatype_icon

region reports

Array of clusters containing the quantification data relative to each region within an image. Each pixel in the image mask indicates, by its pixel value, to which region the corresponding pixel in the image belongs.

The nth element in this array contains the data regarding the nth + 1 region. The size of this array is equal to 2Bit Depth - 1. If the image mask is not connected, this array is empty. The quantification data is still returned for the entire image in the global report.

datatype_icon

mean value

Mean value of the pixels.

datatype_icon

standard variation

Distribution of the values in relation to the average.

The higher this value, the better the distribution of the pixel values.

datatype_icon

minimal value

Smallest pixel value.

datatype_icon

maximal value

Largest pixel value.

datatype_icon

area (calibrated)

Analyzed surface area in user-defined units.

datatype_icon

area (pixels)

Analyzed surface area in pixels.

datatype_icon

%

Percentage of the analyzed surface in relation to the complete image.

datatype_icon

calibration valid

Boolean that indicates whether the calibration information is valid.

A region has invalid calibration information when any of the pixels of that region lie outside the area of the image that was calibrated. area (calibrated) contains the measurement for the valid portion of the region regardless of whether the entire region has valid or invalid calibration information.

True Calibration information is valid for the image.
False Calibration information is invalid for the image.
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.

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