Score Result
Applies To
Vision Objects: Correlation, Edge, Geometric, Polar
Description
Returns an integer value which represents the level at with the runtime image matches the model for which
it is searching. (In the case of the Edge object the Score result measures the level at which a contrast
between Light to Dark or Dark to Light transition takes place.) In summary an object's Score result is the
measure of how well the model was found.
Usage
VGet Sequence.Object.Score [(result)], var
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 result.
result Optional result number. If omitted, the result number is the CurrentResult.
Values
0 - 1000
Remarks
The Score result is the basic value used to measure how well a feature in the search area matches a
previously taught model. If the Score is not greater than or equal to the Accept property value, the object is
considered not found.
Normally a low Score result means that the image doesn't contain any patterns which closely match the
Model. However, it should be noted that a low Score result can also be obtained if the Accept property and
Confusion Properties are not set high enough. If these properties are set low, the first pattern found that
meets the Accept and Confusion property thresholds will be returned as found. This could mean that other
patterns in the image which may have been better matches would not be found.
Don't expect that your Score results will always be close to 1000. Just because a Score result is returned
which is relatively low (as compared to a perfect score of 1000) doesn't mean that the application cannot be
done or isn't reliable. There are many different application types and each has its own circumstances which
affect the Score results. Some applications will return Score results of less than 500 while others may
always return Score results over 900. Proper settings of lighting, part presentation, overall vision
application setup, and proper vision tool usage will all affect the Score results.
Statistics
For the Score Result, the following statistics are available. ScoreMax, ScoreMean, ScoreMin,
ScoreStdDev. Please see Statistics in the Vision Guide manual for details about using statistics.
See Also
Accept Property, Confusion Property, Correlation Object, Edge Object, Found Result, Geometric Object,
Object Tab, Polar Object
140 Vision Guide 5.0 Reference (Ver.5.3) Rev.1