Point gauge. More...

Inheritance diagram for eVision.EPointGauge:

Collaboration diagram for eVision.EPointGauge:

Public Member Functions
None	__init__ (self)
	Constructs a eVision.EPointGauge.
None	__init__ (self, eVision.EPointGauge other)
	Copy constructor.
None	CopyTo (self, eVision.EPointGauge other)
	Copy the object to the other object.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX, float originY)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, float width, float height, float originX)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, float width, float height)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height, float originX, float originY)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height, float originX)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
None	Plot (self, eVision.EDrawAdapter\|None graphicContext, eVision.EPlotItem drawItems, eVision.EPlotDecorationOptions opts, float width, float height)
	Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.
eVision.EPointSet	Measure (self, eVision.EROIBW8 sourceImage, eVision.EFrame frame)
	Performs the gauge measurement.
eVision.EPointSet	Measure (self, eVision.EROIBW8 sourceImage)
	Performs the gauge measurement.
eVision.EPointSet	Measure (self, eVision.EROIBW8 sourceImage, eVision.ERegion region, eVision.EFrame frame)
	Performs the gauge measurement.
eVision.EPointSet	Measure (self, eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Performs the gauge measurement.
eVision.EPoint	GetMeasuredPoint (self, int index)
	Coordinates of a sample point measured along the path of the point gauge.
eVision.EPoint	GetMeasuredPoint (self)
	Coordinates of a sample point measured along the path of the point gauge.
eVision.EPeak	GetMeasuredPeak (self, int index)
	Returns information pertaining to the default derivative peak along the path of the point gauge.
eVision.EPeak	GetMeasuredPeak (self)
	Returns information pertaining to the default derivative peak along the path of the point gauge.
float	Tolerance (self)
	Half thickness of the model fitting gauge.
	Tolerance (self, float value)
	Half thickness of the model fitting gauge.
eVision.EPoint	Center (self)
	Center of the eVision.EPointGauge.NominalLine.
	Center (self, eVision.EPoint value)
	Center of the eVision.EPointGauge.NominalLine.
float	NominalLineLength (self)
	Length of the eVision.EPointGauge.NominalLine.
	NominalLineLength (self, float value)
	Length of the eVision.EPointGauge.NominalLine.
float	NominalLineAngle (self)
	Angle of the eVision.EPointGauge.NominalLine.
	NominalLineAngle (self, float value)
	Angle of the eVision.EPointGauge.NominalLine.
eVision.ELine	NominalLine (self)
	The line upon which we try to measure edge crossing points.
	NominalLine (self, eVision.ELine value)
	The line upon which we try to measure edge crossing points.
eVision.EShapeType	Type (self)
	Shape type.
eVision.EShape\|None	Nominal (self)
	Nominal shape of the gauge.
	Nominal (self, eVision.EShape\|None value)
	Nominal shape of the gauge.
eVision.EEditionMode	AvailableEditionModes (self)
	Returns all possible edition modes of the gauge.
bool	HVConstraint (self)
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
	HVConstraint (self, bool value)
	Status of the restriction on the orientation of the point location gauge or model fitting sample paths.
eVision.ETransitionType	TransitionType (self)
	Transition type.
	TransitionType (self, eVision.ETransitionType value)
	Transition type.
eVision.ETransitionChoice	TransitionChoice (self)
	Transition choice.
	TransitionChoice (self, eVision.ETransitionChoice value)
	Transition choice.
int	TransitionIndex (self)
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.
	TransitionIndex (self, int value)
	Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.
int	Threshold (self)
	Threshold level used to delimit significant peaks in the data profile.
	Threshold (self, int value)
	Threshold level used to delimit significant peaks in the data profile.
int	MinAmplitude (self)
	Offset added to the Threshold when a peak is to be detected.
	MinAmplitude (self, int value)
	Offset added to the Threshold when a peak is to be detected.
int	MinArea (self)
	Minimum area value.
	MinArea (self, int value)
	Minimum area value.
int	Thickness (self)
	Number of parallel segments used to extract the data profile.
	Thickness (self, int value)
	Number of parallel segments used to extract the data profile.
int	Smoothing (self)
	Number of pixels used for the low-pass filtering operation.
	Smoothing (self, int value)
	Number of pixels used for the low-pass filtering operation.
bool	RectangularSamplingArea (self)
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
	RectangularSamplingArea (self, bool value)
	Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.
int	NumSamples (self)
	Number of sampled points during the model fitting operation.
eVision.EShape\|None	Measured (self)
	Copy of the measured shape.
int	NumMeasuredPoints (self)
	Number of edge-crossing points measured along the path of the point gauge.
eVision.EPointSet	MeasuredPointSet (self)
	Coordinates of a sample point measured along the path of the point gauge.
list[eVision._eVision.EPoint]	MeasuredPoints (self)
	Coordinates of all edge-crossing points measured along the path of the point gauge.
list[eVision._eVision.EPeak]	MeasuredPeaks (self)
	Returns information pertaining to the derivative peaks associated with all the edge-crossing point, such as their area, amplitude, start, length and center.
Public Member Functions inherited from eVision.EBaseGauge
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, float zoomX, float zoomY)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, float zoomX)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX, float zoomY)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame, float zoomX)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
None	Draw (self, eVision.EDrawAdapter\|None graphicContext, eVision.EDrawingMode drawingMode, eVision.EFrame frame)
	Draws a graphical representation of a shape, as defined by eVision.EDrawingMode.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY, float panX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX, float zoomY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, float zoomX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame, float zoomX)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
eVision.EEditionMode	HitTest (self, int x, int y, eVision.EFrame frame)
	Checks if there is a handle under the cursor and returns the corresponding edition mode.
None	Drag (self, int x, int y, float zoomX, float zoomY, float panX, float panY)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, float zoomX, float zoomY, float panX)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, float zoomX, float zoomY)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, float zoomX)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX, float panY)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY, float panX)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX, float zoomY)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Drag (self, int x, int y, eVision.EFrame frame, float zoomX)
	Moves a handle to a new position and updates the position parameters of the shape.
None	Save (self, str path)
	Saves a gauge.The given eVision.ESerializer must have been created for writing.
None	Save (self, eVision.ESerializer\|None serializer)
	Saves a gauge.The given eVision.ESerializer must have been created for writing.
None	Load (self, str path)
	Loads a gauge.The given eVision.ESerializer must have been created for reading.
None	Load (self, eVision.ESerializer\|None serializer)
	Loads a gauge.The given eVision.ESerializer must have been created for reading.
bool	HasProperty (self, str aProperty)
	Returns whether a eVision.EBaseGauge has a property named aProperty.
str	GetProperty (self, str aProperty)
	Gets the value of property aProperty.
None	SetProperty (self, str aProperty, str aValue)
	Sets the value of property aProperty to aValue for this eVision.EBaseGauge.
None	RemoveProperty (self, str aProperty)
	Removes the property name aProperty from the eVision.EBaseGauge.
bool	HasValidPolarityProperty (self)
	Returns whether the eVision.EBaseGauge has a valid polarity property.
eVision.ESamplePoint	GetSample (self, int index)
	Retrieves sampled points used during the model fitting operation.
bool	HasSamples (self)
	Whether the samples are available or not.
int	AddSkipRange (self, eVision.EIntegerRange range)
	Adds an item to the set of skip ranges and returns the index of the newly added range.
eVision.EIntegerRange	GetSkipRange (self, int index)
	Allows to retrieve the start and end values of the skip range corresponding to the given index, if it is valid (i.e.
None	RemoveSkipRange (self, int index)
	After a call to eVision.EBaseGauge.AddSkipRange, removes the skip range with the given index.
None	RemoveAllSkipRanges (self)
	Removes all the skip ranges previously created by a call to eVision.EBaseGauge.AddSkipRange.
None	MeasureWithoutFitting (self, eVision.EROIBW8 sourceImage, eVision.EFrame frame)
	Triggers the point location without line fitting operation.
None	MeasureWithoutFitting (self, eVision.EROIBW8 sourceImage)
	Triggers the point location without line fitting operation.
None	MeasureWithoutFitting (self, eVision.EROIBW8 sourceImage, eVision.ERegion region, eVision.EFrame frame)
	Triggers the point location without line fitting operation.
None	MeasureWithoutFitting (self, eVision.EROIBW8 sourceImage, eVision.ERegion region)
	Triggers the point location without line fitting operation.
bool	IsFound (self)
	Flag indicating whether a measured shape has been found.
eVision.ESamplePath	MeasureSamplePath (self, eVision.EROIBW8 sourceImage, int pathIndex, eVision.EFrame frame)
	Measures the specified sample path.
eVision.ESamplePath	MeasureSamplePath (self, eVision.EROIBW8 sourceImage, int pathIndex)
	Measures the specified sample path.
eVision.ESamplePath	MeasureSamplePath (self, eVision.EROIBW8 sourceImage, int pathIndex, eVision.ERegion region, eVision.EFrame frame)
	Measures the specified sample path.
eVision.ESamplePath	MeasureSamplePath (self, eVision.EROIBW8 sourceImage, int pathIndex, eVision.ERegion region)
	Measures the specified sample path.
str	Name (self)
	Name of the eVision.EBaseGauge object.
	Name (self, str value)
	Name of the eVision.EBaseGauge object.
eVision.EEditionMode	EditionMode (self)
	Graphical edition mode (default: eVision.EBaseGauge.AvailableEditionModes).
	EditionMode (self, eVision.EEditionMode value)
	Graphical edition mode (default: eVision.EBaseGauge.AvailableEditionModes).
bool	Labeled (self)
	Whether to draw a label describing the gauge (default: no).
	Labeled (self, bool value)
	Whether to draw a label describing the gauge (default: no).
float	SamplingStep (self)
	Approximate distance between sampled points during a model fitting operation.
	SamplingStep (self, float value)
	Approximate distance between sampled points during a model fitting operation.
float	FilteringThreshold (self)
	Relative filtering threshold, that is the fraction of the average distance between the sampled points and the fitted model above which a point is filtered out.
	FilteringThreshold (self, float value)
	Relative filtering threshold, that is the fraction of the average distance between the sampled points and the fitted model above which a point is filtered out.
int	NumFilteringPasses (self)
	Number of filtering passes for a model fitting operation.
	NumFilteringPasses (self, int value)
	Number of filtering passes for a model fitting operation.
int	NumValidSamples (self)
	Number of valid sample points remaining after a model fitting operation.
int	SamplePointIndex (self)
	Sampled.
	SamplePointIndex (self, int value)
	Sampled.
float	AverageDistance (self)
	Average distance between the sampled points and the fitted model.
list[int]	MinNumFitSamples (self)
	Sets/Gets the minimum number of samples required for fitting the shape.
	MinNumFitSamples (self, list[int] value)
	Sets/Gets the minimum number of samples required for fitting the shape.
int	NumSkipRanges (self)
	Number of skip ranges in the gauge after a call to eVision.EBaseGauge.AddSkipRange.

Additional Inherited Members
Static Public Member Functions inherited from eVision.EBaseGauge
eVision.EBaseGauge\|None	Make (str path)
	Creates a gauge of the correct type.

Detailed Description

Point gauge.

Its nominal shape can be instances of eVision.ELine or eVision.EPointSet. The returned nominal shape will always be a eVision.EPointSet.

Its measured shape is an instance of eVision.EPointSet.

Remarks:

License(s): EasyGauge

Constructor & Destructor Documentation

◆ init() [1/2]

None eVision.EPointGauge.__init__ ( self )

Constructs a eVision.EPointGauge.

◆ init() [2/2]

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

Copy constructor.

Parameters

other Other eVision.EPointGauge object to copy.

Member Function Documentation

◆ AvailableEditionModes()

eVision.EEditionMode eVision.EPointGauge.AvailableEditionModes ( self )

Returns all possible edition modes of the gauge.

Reimplemented from eVision.EBaseGauge.

◆ Center() [1/2]

eVision.EPoint eVision.EPointGauge.Center ( self )

Center of the eVision.EPointGauge.NominalLine.

Remarks:

This is an accessor for the center of the nominal shape.

◆ Center() [2/2]

eVision.EPointGauge.Center	(		self,
		eVision.EPoint	value )

Center of the eVision.EPointGauge.NominalLine.

Remarks:

This is an accessor for the center of the nominal shape.

◆ CopyTo()

None eVision.EPointGauge.CopyTo	(		self,
		eVision.EPointGauge	other )

Copy the object to the other object.

Parameters

other Other eVision.EPointGauge object in which to copy the content of this object.

◆ GetMeasuredPeak() [1/2]

eVision.EPeak eVision.EPointGauge.GetMeasuredPeak ( self )

Returns information pertaining to the default derivative peak along the path of the point gauge.

Remarks:

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the eVision.EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using eVision.EPointGauge.MeasuredPeaks should be faster.

◆ GetMeasuredPeak() [2/2]

eVision.EPeak eVision.EPointGauge.GetMeasuredPeak	(		self,
		int	index )

Returns information pertaining to the default derivative peak along the path of the point gauge.

Remarks:

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the eVision.EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using eVision.EPointGauge.MeasuredPeaks should be faster.

Parameters

index Index of the edge-crossing point along the probed line segment, between 0 and eVision.EPointGauge.NumMeasuredPoints (excluded).

◆ GetMeasuredPoint() [1/2]

eVision.EPoint eVision.EPointGauge.GetMeasuredPoint ( self )

Coordinates of a sample point measured along the path of the point gauge.

Remarks:

These coordinates pertain to the World space.

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the eVision.EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using eVision.EPointGauge.MeasuredPoints should be faster.

◆ GetMeasuredPoint() [2/2]

eVision.EPoint eVision.EPointGauge.GetMeasuredPoint	(		self,
		int	index )

Coordinates of a sample point measured along the path of the point gauge.

Remarks:

These coordinates pertain to the World space.

If index is left unchanged from its default value (i.e. ~0 = 0xFFFFFFFF), the default edge-crossing point is inspected. This default point is chosen according to the transition choice parameter that is managed by the eVision.EPointGauge.TransitionChoice property.

If you want to query more than 10 points, using eVision.EPointGauge.MeasuredPoints should be faster.

Parameters

index Index of the edge-crossing point along the path of the point gauge, between 0 and eVision.EPointGauge.NumMeasuredPoints (excluded).

◆ HVConstraint() [1/2]

bool eVision.EPointGauge.HVConstraint ( self )

Status of the restriction on the orientation of the point location gauge or model fitting sample paths.

Remarks:

Sample paths are the point location gauges placed along the model to be fitted.

Reimplemented from eVision.EBaseGauge.

◆ HVConstraint() [2/2]

eVision.EPointGauge.HVConstraint	(		self,
		bool	value )

Status of the restriction on the orientation of the point location gauge or model fitting sample paths.

Remarks:

Sample paths are the point location gauges placed along the model to be fitted.

Reimplemented from eVision.EBaseGauge.

◆ Measure() [1/4]

eVision.EPointSet eVision.EPointGauge.Measure	(		self,
		eVision.EROIBW8	sourceImage )

Performs the gauge measurement.

Parameters

sourceImage Source image.

Reimplemented from eVision.EBaseGauge.

◆ Measure() [2/4]

eVision.EPointSet eVision.EPointGauge.Measure	(		self,
		eVision.EROIBW8	sourceImage,
		eVision.EFrame	frame )

Performs the gauge measurement.

Parameters

sourceImage	Source image.
frame	Frame of reference

Reimplemented from eVision.EBaseGauge.

◆ Measure() [3/4]

eVision.EPointSet eVision.EPointGauge.Measure	(		self,
		eVision.EROIBW8	sourceImage,
		eVision.ERegion	region )

Performs the gauge measurement.

Parameters

sourceImage	Source image.
region	Region to use with the source image.

Reimplemented from eVision.EBaseGauge.

◆ Measure() [4/4]

eVision.EPointSet eVision.EPointGauge.Measure	(		self,
		eVision.EROIBW8	sourceImage,
		eVision.ERegion	region,
		eVision.EFrame	frame )

Performs the gauge measurement.

Parameters

sourceImage	Source image.
region	Region to use with the source image.
frame	Frame of reference

Reimplemented from eVision.EBaseGauge.

◆ Measured()

eVision.EShape | None eVision.EPointGauge.Measured ( self )

Copy of the measured shape.

Reimplemented from eVision.EBaseGauge.

◆ MeasuredPeaks()

list[eVision._eVision.EPeak] eVision.EPointGauge.MeasuredPeaks ( self )

Returns information pertaining to the derivative peaks associated with all the edge-crossing point, such as their area, amplitude, start, length and center.

Remarks:

If you want to query less than 10 peaks, using eVision.EPointGauge.GetMeasuredPeak should be faster.

◆ MeasuredPoints()

list[eVision._eVision.EPoint] eVision.EPointGauge.MeasuredPoints ( self )

Coordinates of all edge-crossing points measured along the path of the point gauge.

Remarks:

These coordinates pertain to the World space.

If you want to query less than 10 points, using eVision.EPointGauge.GetMeasuredPoint should be faster.

◆ MeasuredPointSet()

eVision.EPointSet eVision.EPointGauge.MeasuredPointSet ( self )

Coordinates of a sample point measured along the path of the point gauge.

◆ MinAmplitude() [1/2]

int eVision.EPointGauge.MinAmplitude ( self )

Offset added to the Threshold when a peak is to be detected.

Remarks:

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

Reimplemented from eVision.EBaseGauge.

◆ MinAmplitude() [2/2]

eVision.EPointGauge.MinAmplitude	(		self,
		int	value )

Offset added to the Threshold when a peak is to be detected.

Remarks:

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

Reimplemented from eVision.EBaseGauge.

◆ MinArea() [1/2]

int eVision.EPointGauge.MinArea ( self )

Minimum area value.

Remarks:

A transition is detected if its derivative peak reaches Threshold + MinAmplitude value, and then declared valid if the area between the peak curve and the horizontal at level Threshold reaches the MinArea value.

Reimplemented from eVision.EBaseGauge.

◆ MinArea() [2/2]

eVision.EPointGauge.MinArea	(		self,
		int	value )

Minimum area value.

Remarks:

A transition is detected if its derivative peak reaches Threshold + MinAmplitude value, and then declared valid if the area between the peak curve and the horizontal at level Threshold reaches the MinArea value.

Reimplemented from eVision.EBaseGauge.

◆ Nominal() [1/2]

eVision.EShape | None eVision.EPointGauge.Nominal ( self )

Nominal shape of the gauge.

Remarks:

Note that the gauge stores a copy of the shape and returns a copy of the shape. The gauge applies its eVision.EBaseGauge.EditionMode to the shape.

Reimplemented from eVision.EBaseGauge.

◆ Nominal() [2/2]

eVision.EPointGauge.Nominal	(		self,
		eVision.EShape \| None	value )

Nominal shape of the gauge.

Remarks:

Note that the gauge stores a copy of the shape and returns a copy of the shape. The gauge applies its eVision.EBaseGauge.EditionMode to the shape.

Reimplemented from eVision.EBaseGauge.

◆ NominalLine() [1/2]

eVision.ELine eVision.EPointGauge.NominalLine ( self )

The line upon which we try to measure edge crossing points.

◆ NominalLine() [2/2]

eVision.EPointGauge.NominalLine	(		self,
		eVision.ELine	value )

The line upon which we try to measure edge crossing points.

◆ NominalLineAngle() [1/2]

float eVision.EPointGauge.NominalLineAngle ( self )

Angle of the eVision.EPointGauge.NominalLine.

◆ NominalLineAngle() [2/2]

eVision.EPointGauge.NominalLineAngle	(		self,
		float	value )

Angle of the eVision.EPointGauge.NominalLine.

◆ NominalLineLength() [1/2]

float eVision.EPointGauge.NominalLineLength ( self )

Length of the eVision.EPointGauge.NominalLine.

◆ NominalLineLength() [2/2]

eVision.EPointGauge.NominalLineLength	(		self,
		float	value )

Length of the eVision.EPointGauge.NominalLine.

◆ NumMeasuredPoints()

int eVision.EPointGauge.NumMeasuredPoints ( self )

Number of edge-crossing points measured along the path of the point gauge.

◆ NumSamples()

int eVision.EPointGauge.NumSamples ( self )

Number of sampled points during the model fitting operation.

Remarks:

Irrelevant in case of a point location operation.

After a model fitting operation, a number of points have been fitted along the model. Among them, some are not reliable because of their Area value. Among the remaining ones, some are filtered out (NumFilteringPasses, FilteringThreshold).

Reimplemented from eVision.EBaseGauge.

◆ Plot() [1/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
width	Width of the plot.
height	Height of the plot.

◆ Plot() [2/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height,
		float	originX )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.

◆ Plot() [3/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		eVision.EPlotDecorationOptions	opts,
		float	width,
		float	height,
		float	originX,
		float	originY )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
opts	Options to control the drawing of the plot decorations (axes, ticks, etc.).
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.
originY	Origin point coordinates of the plot along the Y axis.

◆ Plot() [4/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.

◆ Plot() [5/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.

◆ Plot() [6/6]

None eVision.EPointGauge.Plot	(		self,
		eVision.EDrawAdapter \| None	graphicContext,
		eVision.EPlotItem	drawItems,
		float	width,
		float	height,
		float	originX,
		float	originY )

Draws the profile of the sample path of the point gauge, as defined by eVision.EPlotItem.

Remarks:

The data will be plotted with the current pen of the eVision.EDrawAdapter. If there is no pen set, then the following color will be used:

Red for eVision.EPlotItem.Transitions
Blue for eVision.EPlotItem.Peak
Blue for eVision.EPlotItem.Thresholds
Green for eVision.EPlotItem.Points
Red for any combinations of eVision.EPlotItem

Parameters

graphicContext	Handle of the device context on which to draw.
drawItems	Boolean combination of eVision.EPlotItem members, that indicates which items must be displayed.
width	Width of the plot.
height	Height of the plot.
originX	Origin point coordinates of the plot along the X axis.
originY	Origin point coordinates of the plot along the Y axis.

◆ RectangularSamplingArea() [1/2]

bool eVision.EPointGauge.RectangularSamplingArea ( self )

Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.

Remarks:

By default, this flag is set to true: the sampling area always remains a rectangle. Setting this property is only useful when the thickness transition parameter is greater than 1. In fact, when thickness transition parameter is equal to 1, rectangle and parallelogram reduce to the same segment.

Reimplemented from eVision.EBaseGauge.

◆ RectangularSamplingArea() [2/2]

eVision.EPointGauge.RectangularSamplingArea	(		self,
		bool	value )

Flag indicating whether the sampling area remains a rectangle when rotated, instead of becoming a parallelogram.

Remarks:

By default, this flag is set to true: the sampling area always remains a rectangle. Setting this property is only useful when the thickness transition parameter is greater than 1. In fact, when thickness transition parameter is equal to 1, rectangle and parallelogram reduce to the same segment.

Reimplemented from eVision.EBaseGauge.

◆ Smoothing() [1/2]

int eVision.EPointGauge.Smoothing ( self )

Number of pixels used for the low-pass filtering operation.

Remarks:

To reduce the effect of noise, the profile data can be low-pass filtered along the point location gauge direction.

Reimplemented from eVision.EBaseGauge.

◆ Smoothing() [2/2]

eVision.EPointGauge.Smoothing	(		self,
		int	value )

Number of pixels used for the low-pass filtering operation.

Remarks:

To reduce the effect of noise, the profile data can be low-pass filtered along the point location gauge direction.

Reimplemented from eVision.EBaseGauge.

◆ Thickness() [1/2]

int eVision.EPointGauge.Thickness ( self )

Number of parallel segments used to extract the data profile.

Remarks:

To reduce the effect of noise and/or strengthen a transition, several parallel profiles can be accumulated.

Reimplemented from eVision.EBaseGauge.

◆ Thickness() [2/2]

eVision.EPointGauge.Thickness	(		self,
		int	value )

Number of parallel segments used to extract the data profile.

Remarks:

To reduce the effect of noise and/or strengthen a transition, several parallel profiles can be accumulated.

Reimplemented from eVision.EBaseGauge.

◆ Threshold() [1/2]

int eVision.EPointGauge.Threshold ( self )

Threshold level used to delimit significant peaks in the data profile.

Remarks:

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

Reimplemented from eVision.EBaseGauge.

◆ Threshold() [2/2]

eVision.EPointGauge.Threshold	(		self,
		int	value )

Threshold level used to delimit significant peaks in the data profile.

Remarks:

When analyzing a derivative profile, a peak is made up of consecutive pixel values above Threshold. To detect weak [strong] transitions, lower [raise] the Threshold value.

To avoid interference of noise, an additional parameter is provided. The MinAmplitude parameter is an offset added to Threshold when a peak is to be detected.

When the pixel values of the derivative profile do not reach Threshold + MinAmplitude, the peak is not taken into account. Anyway, when a peak is taken into account, all the pixels with values above Threshold are considered (for more accuracy). Setting the MinAmplitude value to 0 merely cancels its effect.

Reimplemented from eVision.EBaseGauge.

◆ Tolerance() [1/2]

float eVision.EPointGauge.Tolerance ( self )

Half thickness of the model fitting gauge.

Remarks:

By default, the tolerance is 20 (2x10), which means 20 pixels when the field of view is not calibrated, and 20 physical units in case of a calibrated field of view.

The tolerance isn't taken into consideration for the point gauge.

Reimplemented from eVision.EBaseGauge.

◆ Tolerance() [2/2]

eVision.EPointGauge.Tolerance	(		self,
		float	value )

Half thickness of the model fitting gauge.

Remarks:

By default, the tolerance is 20 (2x10), which means 20 pixels when the field of view is not calibrated, and 20 physical units in case of a calibrated field of view.

The tolerance isn't taken into consideration for the point gauge.

Reimplemented from eVision.EBaseGauge.

◆ TransitionChoice() [1/2]

eVision.ETransitionChoice eVision.EPointGauge.TransitionChoice ( self )

Transition choice.

Remarks:

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

In case of eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd transition choice, set eVision.EBaseGauge.TransitionIndex to specify the desired transition.

By default, the selected transition corresponds to the one with the largest amplitude (eVision.ETransitionChoice.LargestAmplitude).

Reimplemented from eVision.EBaseGauge.

◆ TransitionChoice() [2/2]

eVision.EPointGauge.TransitionChoice	(		self,
		eVision.ETransitionChoice	value )

Transition choice.

Remarks:

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

In case of eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd transition choice, set eVision.EBaseGauge.TransitionIndex to specify the desired transition.

By default, the selected transition corresponds to the one with the largest amplitude (eVision.ETransitionChoice.LargestAmplitude).

Reimplemented from eVision.EBaseGauge.

◆ TransitionIndex() [1/2]

int eVision.EPointGauge.TransitionIndex ( self )

Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.

Remarks:

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

By default, the first transition is retained (the index value is 0).

Reimplemented from eVision.EBaseGauge.

◆ TransitionIndex() [2/2]

eVision.EPointGauge.TransitionIndex	(		self,
		int	value )

Index (from 0 on) of the transition to be retained when the transition choice parameter is set to eVision.ETransitionChoice.NthFromBegin or eVision.ETransitionChoice.NthFromEnd.

Remarks:

Several peaks may be detected along a point location gauge. This parameter helps to select the desired transition.

By default, the first transition is retained (the index value is 0).

Reimplemented from eVision.EBaseGauge.

◆ TransitionType() [1/2]

eVision.ETransitionType eVision.EPointGauge.TransitionType ( self )

Transition type.

Remarks:

The type of transition tells whether it crosses increasing or decreasing gray-level values. This helps discriminate between nearby edges of an object.

By default, the searched transition type is indifferently a black to white or a white to black transition (eVision.ETransitionType.BwOrWb).

Reimplemented from eVision.EBaseGauge.

◆ TransitionType() [2/2]

eVision.EPointGauge.TransitionType	(		self,
		eVision.ETransitionType	value )

Transition type.

Remarks:

The type of transition tells whether it crosses increasing or decreasing gray-level values. This helps discriminate between nearby edges of an object.

By default, the searched transition type is indifferently a black to white or a white to black transition (eVision.ETransitionType.BwOrWb).

Reimplemented from eVision.EBaseGauge.

◆ Type()

eVision.EShapeType eVision.EPointGauge.Type ( self )

Shape type.

Reimplemented from eVision.EBaseGauge.

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __init__() [1/2]

◆ __init__() [2/2]

Member Function Documentation

◆ AvailableEditionModes()

◆ Center() [1/2]

◆ Center() [2/2]

◆ CopyTo()

◆ GetMeasuredPeak() [1/2]

◆ GetMeasuredPeak() [2/2]

◆ GetMeasuredPoint() [1/2]

◆ GetMeasuredPoint() [2/2]

◆ HVConstraint() [1/2]

◆ HVConstraint() [2/2]

◆ Measure() [1/4]

◆ Measure() [2/4]

◆ Measure() [3/4]

◆ Measure() [4/4]

◆ Measured()

◆ MeasuredPeaks()

◆ MeasuredPoints()

◆ MeasuredPointSet()

◆ MinAmplitude() [1/2]

◆ MinAmplitude() [2/2]

◆ MinArea() [1/2]

◆ MinArea() [2/2]

◆ Nominal() [1/2]

◆ Nominal() [2/2]

◆ NominalLine() [1/2]

◆ NominalLine() [2/2]

◆ NominalLineAngle() [1/2]

◆ NominalLineAngle() [2/2]

◆ NominalLineLength() [1/2]

◆ NominalLineLength() [2/2]

◆ NumMeasuredPoints()

◆ NumSamples()

◆ Plot() [1/6]

◆ Plot() [2/6]

◆ Plot() [3/6]

◆ Plot() [4/6]

◆ Plot() [5/6]

◆ Plot() [6/6]

◆ RectangularSamplingArea() [1/2]

◆ RectangularSamplingArea() [2/2]

◆ Smoothing() [1/2]

◆ Smoothing() [2/2]

◆ Thickness() [1/2]

◆ Thickness() [2/2]

◆ Threshold() [1/2]

◆ Threshold() [2/2]

◆ Tolerance() [1/2]

◆ Tolerance() [2/2]

◆ TransitionChoice() [1/2]

◆ TransitionChoice() [2/2]

◆ TransitionIndex() [1/2]

◆ TransitionIndex() [2/2]

◆ TransitionType() [1/2]

◆ TransitionType() [2/2]

◆ Type()

◆ init() [1/2]

◆ init() [2/2]