CogPMAlignZoneScale Overlap Property Cognex VisionPro 9.5
Result candidates overlap for a scale DOF if the scale ratio (larger scale/smaller scale) <= Overlap. PMAlign discards the weaker pattern instance when two pattern instances overlap for all degrees of freedom (DOF) as well as area.

Namespace: Cognex.VisionPro.PMAlign
Assembly: Cognex.VisionPro.PMAlign (in Cognex.VisionPro.PMAlign.dll) Version: 69.0.0.0
Syntax

public double Overlap { get; set; }

Property Value

Type: Double
Events

Event TypeReason
CogPMAlignZoneScale Changed

Fires when the value of this property changes.

The following state flag may be affected:

Exceptions

ExceptionCondition
ArgumentException

The supplied value is less than one.

Remarks

Result candidates overlap for the scale degree of freedom if the ratio of the results' scale values is less than or equal to the Overlap value you specify. PMAlign discards the weaker pattern instance when two pattern instances overlap for all degrees of freedom as well as area.

The scale overlap threshold is expressed as the ratio of the scale of the instance with a larger scale to the scale of the instance with the smaller scale. If the ratio of the two results is less than or equal to Overlap, the results are considered overlapping.

Since the ratio is the greater scale over the smaller scale, the overlap threshold must be greater than or equal to one. For example, if you specify 1.2 for the overlap threshold and two instances had scales of 1.25 and 2.50, they would not meet the overlap threshold because the ratio of 2.5 to 1.25 (2.0) is greater than the threshold value (1.2).

Default Value: 1.4

See Also