Cog3DAlignRunParams ClutterMultiplier Property Cognex VisionPro
Gets or sets the clutter multiplier. This value controls how much the score of your result will be reduced by the presence of extraneous data points at the result location. Extraneous data points are known as clutter. They appear in the runtime image at locations that should be empty.

Namespace: Cognex.VisionPro3D
Assembly: Cognex.VisionPro3D (in Cognex.VisionPro3D.dll) Version: 65.1.0.0
Syntax

public double ClutterMultiplier { get; set; }

Property Value

Type: Double
The clutter multiplier. Default value is zero.
Events

Event TypeReason
ICogChangedEvent Changed Fires when this property changes. The following state flag may be affected:
Exceptions

ExceptionCondition
ArgumentOutOfRangeException The supplied value is less than zero.
Remarks

A runtime data point is considered extraneous if it lies within the bounding box of the found pattern (as returned by GetBoundingBox ), but does not match any point on that pattern. Extraneous data points are known as clutter. They appear in the runtime image at locations that should be empty.

The clutter value of each result measures the relative number of extraneous data points for that result. Clutter is a weighted ratio that divides the number of extraneous data points for a given result by the total number of points in the trained pattern. It can never be less than zero, but it can be larger than one.

You can choose how the clutter value of a result will affect that result's score by setting the clutter multiplier. Set it to a high value if you wish to significantly reduce the score of results that exhibit clutter. Set the clutter multiplier to zero if you wish the score of your results to be insensitive to clutter.

The score of a result is computed by multiplying the Clutter value of the result by the ClutterMultiplier and then subtracting that number from the result's Coverage value. The score increases as the coverage value rises, and typically decreases as the clutter value rises. The formula is:

Score = Coverage - (Clutter * ClutterMultiplier)

Notice that the score is never less than zero or greater than 1.0. It is always clipped to lie within this range.

See Also