Cog3DAlignRunParams.AcceptThreshold Property

Cog3DAlignRunParams AcceptThreshold Property

Cognex VisionPro

Gets or sets the acceptance threshold for the score of a result. Only instances of the pattern that receive scores greater than or equal to this threshold are reported as results. Valid range is from zero to one.

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

Syntax

C++

Copy to Clipboard Print

public double AcceptThreshold { get; set; }

public double AcceptThreshold { get; set; }

Public Property AcceptThreshold As Double 
	Get 
	Set

Public Property AcceptThreshold As Double 
	Get 
	Set

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

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

Property Value

Type: Double
The acceptance threshold. Default value is 0.5.

Events

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

Exceptions

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

Remarks

You should supply an acceptance threshold that is lower than the lowest score you ever expect to receive from a true instance of your pattern.

A Cog3DAlignResult is returned only if all of the following conditions are met:

Its Score is greater than or equal to AcceptThreshold.
Its position satisfies the LocationConstraintMode that you specified.
Its rotation (as reported by the Rotation property of the Cog3DTransformRigid returned by GetPose ) falls within the angle zone ranges you specified using ZoneAngleFirst, ZoneAngleSecond and ZoneAngleThird with your chosen ZoneAngleDecomposition mode.
Its Score makes it one of the top-scoring results. Only the NumberToFind top-scoring results (that meet all of the other conditions) will be returned.