Manages a complete context for the EChecker golden template inspection tool. More...

Public Member Functions
None	__init__ (self)
	Constructs a golden template inspection context.
None	__init__ (self, eVision.EChecker other)
	Constructs a golden template inspection context.
None	Train (self, list[eVision._eVision.EROIBW8\|None] rois, list[eVision._eVision.EFrame] frames, eVision.ERegion inspectionRegion)
	Train.
None	Train (self, list[eVision._eVision.EROIBW8\|None] rois, list[eVision._eVision.EFrame] frames)
	Train.
None	Train (self, list[eVision._eVision.EROIBW8\|None] rois, eVision.ERegion inspectionRegion)
	Train.
None	Train (self, list[eVision._eVision.EROIBW8\|None] rois)
	Train.
None	TrainOnSingleImage (self, eVision.EROIBW8 roi, eVision.EFrame frame, eVision.ERegion inspectionRegion, int geometricTolerance, int grayLevelTolerance)
	Train on a single image.
None	TrainOnSingleImage (self, eVision.EROIBW8 roi, eVision.EFrame frame, int geometricTolerance, int grayLevelTolerance)
	Train on a single image.
None	TrainOnSingleImage (self, eVision.EROIBW8 roi, eVision.ERegion inspectionRegion, int geometricTolerance, int grayLevelTolerance)
	Train on a single image.
None	TrainOnSingleImage (self, eVision.EROIBW8 roi, int geometricTolerance, int grayLevelTolerance)
	Train on a single image.
None	ResetTraining (self)
	Reset training.
None	Inspect (self, eVision.EROIBW8 roi, eVision.EFrame frame, eVision.ECodedImage2 defects)
	Inspect the image.
None	Inspect (self, eVision.EROIBW8 roi, eVision.ECodedImage2 defects)
	Inspect the image.
None	DrawInspectionRegion (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX, float panY)
	Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
None	DrawInspectionRegion (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY, float panX)
	Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
None	DrawInspectionRegion (self, eVision.EDrawAdapter\|None graphicContext, float zoomX, float zoomY)
	Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
None	DrawInspectionRegion (self, eVision.EDrawAdapter\|None graphicContext, float zoomX)
	Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
None	DrawInspectionRegion (self, eVision.EDrawAdapter\|None graphicContext)
	Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
None	Load (self, str file)
	Load an inspection model.
None	Load (self, eVision.ESerializer\|None serializer)
	Load an inspection model.
None	Save (self, eVision.ESerializer\|None serializer)
	Save the inspection model.
None	Save (self, str file)
	Save the inspection model.

Properties
	TrainingMode = property(_TrainingMode__getter, _TrainingMode__setter)
	Training mode.
	NormalizationMode = property(_NormalizationMode__getter, _NormalizationMode__setter)
	Normalization mode.
	InspectionTolerance = property(_InspectionTolerance__getter, _InspectionTolerance__setter)
	Inspection Tolerance factor.
	LowThresholdImage = property(_LowThresholdImage__getter, None)
	Low threshold image.
	HighThresholdImage = property(_HighThresholdImage__getter, None)
	High threshold image.
	LastRegisteredImage = property(_LastRegisteredImage__getter, None)
	Represents the last source image, after it has been aligned with the reference image and normalized.
	InspectionRegion = property(_InspectionRegion__getter, None)
	Represents the inspection region, overlayed on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.
	IsTrained = property(_IsTrained__getter, None)
	Application state.

Detailed Description

Manages a complete context for the EChecker golden template inspection tool.

Remarks:

License(s): EasyObject

Constructor & Destructor Documentation

◆ init() [1/2]

None eVision.EChecker.__init__ ( self )

Constructs a golden template inspection context.

◆ init() [2/2]

None eVision.EChecker.__init__	(		self,
		eVision.EChecker	other )

Constructs a golden template inspection context.

Parameters

other The eVision.EChecker to copy into this one.

Member Function Documentation

◆ DrawInspectionRegion() [1/5]

None eVision.EChecker.DrawInspectionRegion	(		self,
		eVision.EDrawAdapter \| None	graphicContext )

Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

Parameters

graphicContext Device context of the drawing window.

◆ DrawInspectionRegion() [2/5]

None eVision.EChecker.DrawInspectionRegion	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX )

Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

Parameters

graphicContext	Device context of the drawing window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in true scale.

◆ DrawInspectionRegion() [3/5]

None eVision.EChecker.DrawInspectionRegion	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY )

Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

Parameters

graphicContext	Device context of the drawing window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in true scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).

◆ DrawInspectionRegion() [4/5]

None eVision.EChecker.DrawInspectionRegion	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX )

Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

Parameters

graphicContext	Device context of the drawing window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in true scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning factor. By default, no panning occurs.

◆ DrawInspectionRegion() [5/5]

None eVision.EChecker.DrawInspectionRegion	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		float	zoomX,
		float	zoomY,
		float	panX,
		float	panY )

Draws the inspection region on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

Parameters

graphicContext	Device context of the drawing window.
zoomX	Magnification factor for zooming in or out in the horizontal direction. By default, the image is displayed in true scale.
zoomY	Magnification factor for zooming in or out in the vertical direction. Setting a 0 value (which is the default) will result in isotropic scaling (i.e. equal horizontal and vertical factors).
panX	Horizontal panning factor. By default, no panning occurs.
panY	Vertical panning factor. By default, no panning occurs.

◆ Inspect() [1/2]

None eVision.EChecker.Inspect	(		self,
		eVision.EROIBW8	roi,
		eVision.ECodedImage2	defects )

Inspect the image.

The defects are returned in the referential images aligned on the inspection region. See eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage and eVision.EChecker.LastRegisteredImage.

Frame is assumed to be a default frame when not specified.

Parameters

roi	ROI or Image to inspect.
defects	List of defects returned by the inspection.

◆ Inspect() [2/2]

None eVision.EChecker.Inspect	(		self,
		eVision.EROIBW8	roi,
		eVision.EFrame	frame,
		eVision.ECodedImage2	defects )

Inspect the image.

The defects are returned in the referential images aligned on the inspection region. See eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage and eVision.EChecker.LastRegisteredImage.

Frame is assumed to be a default frame when not specified.

Parameters

roi	ROI or Image to inspect.
frame	Frame relative to roi.
defects	List of defects returned by the inspection.

◆ Load() [1/2]

None eVision.EChecker.Load	(		self,
		eVision.ESerializer \| None	serializer )

Load an inspection model.

Parameters

serializer Serializer. Must be in read mode

◆ Load() [2/2]

None eVision.EChecker.Load	(		self,
		str	file )

Load an inspection model.

Parameters

file File path

◆ ResetTraining()

None eVision.EChecker.ResetTraining ( self )

Reset training.

Use this if you want to reset the state of the object.

◆ Save() [1/2]

None eVision.EChecker.Save	(		self,
		eVision.ESerializer \| None	serializer )

Save the inspection model.

Parameters

serializer Serializer. Must be in write mode

◆ Save() [2/2]

None eVision.EChecker.Save	(		self,
		str	file )

Save the inspection model.

Parameters

file File path

◆ Train() [1/4]

None eVision.EChecker.Train	(		self,
		list[eVision._eVision.EROIBW8 \| None]	rois )

Train.

The distribution of noise is estimated for each pixel based on the training images. At inspection, a pixel is validated it if is close enough to the average value on the training set. The size of that interval is proportional to eVision.EChecker.InspectionTolerance.

Frames argument is assumed to be default frames if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

rois	ROI or Images to train on.

◆ Train() [2/4]

None eVision.EChecker.Train	(		self,
		list[eVision._eVision.EROIBW8 \| None]	rois,
		eVision.ERegion	inspectionRegion )

Train.

The distribution of noise is estimated for each pixel based on the training images. At inspection, a pixel is validated it if is close enough to the average value on the training set. The size of that interval is proportional to eVision.EChecker.InspectionTolerance.

Frames argument is assumed to be default frames if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

rois	ROI or Images to train on.
inspectionRegion	Region used for the inspection process.

◆ Train() [3/4]

None eVision.EChecker.Train	(		self,
		list[eVision._eVision.EROIBW8 \| None]	rois,
		list[eVision._eVision.EFrame]	frames )

Train.

The distribution of noise is estimated for each pixel based on the training images. At inspection, a pixel is validated it if is close enough to the average value on the training set. The size of that interval is proportional to eVision.EChecker.InspectionTolerance.

Frames argument is assumed to be default frames if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

rois	ROI or Images to train on.
frames	Frames that correspond to each of the rois.

◆ Train() [4/4]

None eVision.EChecker.Train	(		self,
		list[eVision._eVision.EROIBW8 \| None]	rois,
		list[eVision._eVision.EFrame]	frames,
		eVision.ERegion	inspectionRegion )

Train.

The distribution of noise is estimated for each pixel based on the training images. At inspection, a pixel is validated it if is close enough to the average value on the training set. The size of that interval is proportional to eVision.EChecker.InspectionTolerance.

Frames argument is assumed to be default frames if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

rois	ROI or Images to train on.
frames	Frames that correspond to each of the rois.
inspectionRegion	Region used for the inspection process.

◆ TrainOnSingleImage() [1/4]

None eVision.EChecker.TrainOnSingleImage	(		self,
		eVision.EROIBW8	roi,
		eVision.EFrame	frame,
		eVision.ERegion	inspectionRegion,
		int	geometricTolerance,
		int	grayLevelTolerance )

Train on a single image.

At inspection, a pixel is validated if it is above "the smallest pixel in a geometricTolerance vicinity" - grayLevelTolerance and below "the biggest pixel in a geometricTolerance vicinity" + grayLevelTolerance. eVision.EChecker.InspectionTolerance and eVision.EChecker.TrainingMode are ignored by this method.

Frame argument is assumed to be a default frame if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

roi	ROI or Image to train on.
frame	Frame that correspond to the roi.
inspectionRegion	Region used for the inspection process.
geometricTolerance	Tolerance in geometric space (in pixels).
grayLevelTolerance	Tolerance in gray level space.

◆ TrainOnSingleImage() [2/4]

None eVision.EChecker.TrainOnSingleImage	(		self,
		eVision.EROIBW8	roi,
		eVision.EFrame	frame,
		int	geometricTolerance,
		int	grayLevelTolerance )

Train on a single image.

At inspection, a pixel is validated if it is above "the smallest pixel in a geometricTolerance vicinity" - grayLevelTolerance and below "the biggest pixel in a geometricTolerance vicinity" + grayLevelTolerance. eVision.EChecker.InspectionTolerance and eVision.EChecker.TrainingMode are ignored by this method.

Frame argument is assumed to be a default frame if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

roi	ROI or Image to train on.
frame	Frame that correspond to the roi.
geometricTolerance	Tolerance in geometric space (in pixels).
grayLevelTolerance	Tolerance in gray level space.

◆ TrainOnSingleImage() [3/4]

None eVision.EChecker.TrainOnSingleImage	(		self,
		eVision.EROIBW8	roi,
		eVision.ERegion	inspectionRegion,
		int	geometricTolerance,
		int	grayLevelTolerance )

Train on a single image.

At inspection, a pixel is validated if it is above "the smallest pixel in a geometricTolerance vicinity" - grayLevelTolerance and below "the biggest pixel in a geometricTolerance vicinity" + grayLevelTolerance. eVision.EChecker.InspectionTolerance and eVision.EChecker.TrainingMode are ignored by this method.

Frame argument is assumed to be a default frame if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

roi	ROI or Image to train on.
inspectionRegion	Region used for the inspection process.
geometricTolerance	Tolerance in geometric space (in pixels).
grayLevelTolerance	Tolerance in gray level space.

◆ TrainOnSingleImage() [4/4]

None eVision.EChecker.TrainOnSingleImage	(		self,
		eVision.EROIBW8	roi,
		int	geometricTolerance,
		int	grayLevelTolerance )

Train on a single image.

At inspection, a pixel is validated if it is above "the smallest pixel in a geometricTolerance vicinity" - grayLevelTolerance and below "the biggest pixel in a geometricTolerance vicinity" + grayLevelTolerance. eVision.EChecker.InspectionTolerance and eVision.EChecker.TrainingMode are ignored by this method.

Frame argument is assumed to be a default frame if not specified (no transformation performed). Inspection region is assumed to be the whole image when not specified.

Parameters

roi	ROI or Image to train on.
geometricTolerance	Tolerance in geometric space (in pixels).
grayLevelTolerance	Tolerance in gray level space.

Property Documentation

◆ HighThresholdImage

eVision.EChecker.HighThresholdImage = property(_HighThresholdImage__getter, None)

static

High threshold image.

◆ InspectionRegion

eVision.EChecker.InspectionRegion = property(_InspectionRegion__getter, None)

static

Represents the inspection region, overlayed on eVision.EChecker.LowThresholdImage, eVision.EChecker.HighThresholdImage or eVision.EChecker.LastRegisteredImage.

◆ InspectionTolerance

eVision.EChecker.InspectionTolerance = property(_InspectionTolerance__getter, _InspectionTolerance__setter)

static

Inspection Tolerance factor.

If you need to be more tolerant towards noise, texture or illumination irregularities, raise this value. If you have clean images, low texture and some defects are missed, lower this value. Default value: 4.0

◆ IsTrained

eVision.EChecker.IsTrained = property(_IsTrained__getter, None)

static

Application state.

Has the checker been trained.

◆ LastRegisteredImage

eVision.EChecker.LastRegisteredImage = property(_LastRegisteredImage__getter, None)

static

Represents the last source image, after it has been aligned with the reference image and normalized.

◆ LowThresholdImage

eVision.EChecker.LowThresholdImage = property(_LowThresholdImage__getter, None)

static

Low threshold image.

◆ NormalizationMode

eVision.EChecker.NormalizationMode = property(_NormalizationMode__getter, _NormalizationMode__setter)

static

Normalization mode.

This setting allows you to specify if you want to enable normalization, and if yes, which type. Normalization allows the training and inspection processes to automatically correct global illumination differences between the images. Default: Moments based normalization.

Remarks:

If you have consistent illumination between your images, using normalization can prove detrimental, as in that case the defect themselves might be enough to shift the global contrast.

◆ TrainingMode

eVision.EChecker.TrainingMode = property(_TrainingMode__getter, _TrainingMode__setter)

static

Training mode.

The training mode determines which process will be used to build the threshold images used for inspection. EChecker has two training modes: A Quick mode, efficient for crude defects and stable images, and a Precise mode, designed for more subtle defects and handling more variability in the images. Default: Precise training mode.

Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/2]

◆ __init__() [2/2]

Member Function Documentation

◆ DrawInspectionRegion() [1/5]

◆ DrawInspectionRegion() [2/5]

◆ DrawInspectionRegion() [3/5]

◆ DrawInspectionRegion() [4/5]

◆ DrawInspectionRegion() [5/5]

◆ Inspect() [1/2]

◆ Inspect() [2/2]

◆ Load() [1/2]

◆ Load() [2/2]

◆ ResetTraining()

◆ Save() [1/2]

◆ Save() [2/2]

◆ Train() [1/4]

◆ Train() [2/4]

◆ Train() [3/4]

◆ Train() [4/4]

◆ TrainOnSingleImage() [1/4]

◆ TrainOnSingleImage() [2/4]

◆ TrainOnSingleImage() [3/4]

◆ TrainOnSingleImage() [4/4]

Property Documentation

◆ HighThresholdImage

◆ InspectionRegion

◆ InspectionTolerance

◆ IsTrained

◆ LastRegisteredImage

◆ LowThresholdImage

◆ NormalizationMode

◆ TrainingMode

◆ init() [1/2]

◆ init() [2/2]