CogPMRedLineRunParams.ScoreUsingClutter Property

CogPMRedLineRunParams ScoreUsingClutter Property

Cognex VisionPro

Gets or sets whether PMRedLine should reduce the score of results that contain extraneous features at the found image location. Extraneous features are known as clutter. They appear in the runtime image at locations which should be empty.

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

Syntax

C++

Copy to Clipboard Print

public bool ScoreUsingClutter { get; set; }

public bool ScoreUsingClutter { get; set; }

Public Property ScoreUsingClutter As Boolean 
	Get 
	Set

Public Property ScoreUsingClutter As Boolean 
	Get 
	Set

public:
property bool ScoreUsingClutter {
	bool get ();
	void set (bool value);
}

public:
property bool ScoreUsingClutter {
	bool get ();
	void set (bool value);
}

Property Value

Type: Boolean
"True" if you want PMRedLine to reduce the score of results that exhibit clutter. "False" otherwise. Default value is "false".

Events

Event Type	Reason
ICogChangedEvent Changed	Fires when this property changes. The following state flag may be affected: SfScoreUsingClutter

Remarks

A pattern's score is reduced as the amount of clutter increases, but the score will never go negative.

A clutter measurement is computed, and reported in each result, only if ScoreUsingClutter is set to "true". Otherwise, each result reports a clutter value of -1.

The clutter value is a ratio. It is computed by dividing the number of clutter features at the found location by the number of features in the trained pattern. This ratio can be larger than one.

Clutter features are extra features that appear in the runtime image at locations which should be empty. The corresponding area of the train image is called "empty" when: it lies within the train region, it contains no features, and it is not masked as "Don't Care".