CogPMRedLinePattern.FeatureThreshold Property

CogPMRedLinePattern FeatureThreshold Property

Cognex VisionPro 9.20

Gets or sets the feature threshold. This value controls how many features are included in the trained pattern. Raising the threshold reduces the number of trained features.

Namespace: Cognex.VisionPro.PMRedLine
Assembly: Cognex.VisionPro.PMRedLine (in Cognex.VisionPro.PMRedLine.dll) Version: 80.0.0.0

Syntax

C++

Copy to Clipboard Print

public double FeatureThreshold { get; set; }

public double FeatureThreshold { get; set; }

Public Property FeatureThreshold As Double 
	Get 
	Set

Public Property FeatureThreshold As Double 
	Get 
	Set

public:
property double FeatureThreshold {
	double get ();
	void set (double value);
}

public:
property double FeatureThreshold {
	double get ();
	void set (double value);
}

Property Value

Type: Double
The feature threshold. Default value is 0.2.

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this property changes. The following state flags may be affected: SfFeatureThreshold SfTrained SfCreateTrainedGraphics

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The supplied value is less than zero, or greater than or equal to one.

Remarks

Raising this threshold trains fewer features: the strongest existing features are retained and the weakest existing image features are discarded. Lowering the threshold trains more features: all of the existing features are retained and the next-strongest image features are included.

Only adjust this parameter after you have looked at your trained pattern and confirmed that you need more (or fewer) image features. Large values (0.7 or higher) may produce too few features for accurate pattern finding. Large values may also eliminate so many features that it is impossible to even train a pattern.

If you change this value on a trained pattern object, the pattern will become untrained.