Score result – Epson 5 User Manual

Page 154

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.