CheckPresence_Intensity


Verifies object presence by analysing pixel intensities in the specified region.

Applications:Quick and easy presence verification, e.g. for missing caps, screws, labels.

Syntax

C++
C#
Python
 
def CheckPresence_Intensity(
	inImage: Image,
	inRoi: ShapeRegion,
	/,
	*,
	inRoiAlignment: CoordinateSystem2D | None = None,
	inMinIntensity: float | None = None,
	inMaxIntensity: float | None = None,
	inMinContrast: float = 0,
	inMaxContrast: float | None = None,
	outAlignedRoi: ShapeRegion | None = None
)
-> (
	outIsPresent: bool,
	outIntensity: float,
	outContrast: float
)

Parameters

Name Type Range Default Description
Input value inImage Image Input image
Input value inRoi ShapeRegion Location at which object presence is being checked
Input value inRoiAlignment CoordinateSystem2D | None None Adjusts the region of interest to the position of the inspected object
Input value inMinIntensity float | None None Lowest acceptable value for the average pixel value
Input value inMaxIntensity float | None None Highest acceptable value for the average pixel value
Input value inMinContrast float 0.0 - 0 Lowest acceptable value for the standard deviation of the pixel values
Input value inMaxContrast float | None 0.0 - None Highest acceptable value for the standard deviation of the pixel values
Output value outIsPresent bool Flag indicating whether the object is present or not
Output value outIntensity float Average pixel value
Output value outContrast float Standard deviation of the pixel values
Output value outAlignedRoi ShapeRegion | None None Input ROI after transformation (in the image coordinates)