Confusion Property
Applies To
Vision Objects: Correlation, Geometric, Polar
Description
Indicates the amount of confusion expected in the image to be searched. This is the highest shape score a
feature can get that is not an instance of the feature for which you are searching. (i.e. Will there be patterns
in the image which will "confuse" the searching algorithms? To what level?)
Usage
VGet Sequence.Object.Confusion, var
VSet Sequence.Object.Confusion, value
Sequence Name of a sequence or string variable containing a sequence name.
Object Name of an object or string variable containing an object name. The object must exist in the
specified sequence.
var Integer variable that will contain the value of the property.
value Integer expression for the new value of the property.
Values
Integer number from 1-999 with the higher numbers representing a higher confusion in an image.
Default: 800
Remarks
Both the Confusion property and the Accept property affect searching and pattern finding speed. The
Confusion property allows the system to quit the Correlation Search or Polar Search before exploring all
possible regions of the image, thus speeding up the process.
Set the Confusion property based on the highest value you expect the "wrong part" to get (plus a margin for
error). The Confusion property should be greater than or equal to the Accept property. Setting the
Confusion property to a high value may increase the time of the search, but may be necessary to insure that
the correct features are found.
The Confusion property becomes very important when there are multiple features within an image which
are very similar. In these cases the proper setting of the Confusion property (i.e. at a high enough level)
helps eliminate the wrong features from the Correlation Search, or Polar Search. However, when an image
has few features which look the same then the Confusion property can be set a little lower. This can help
reduce processing time.
See Also
Accept Property, Correlation Object, Geometric Object, Object Tab, Polar Object, Score Result
Vision Guide 5.0 Reference (Ver.5.3) Rev.1 37