Score Result

Applies To
Vision Objects: ColorMatch, Correlation, Edge, Geometric, Polar

Description
Returns an integer value which represents the level at with the runtime object was found. For Correlation, Geomatric, and Polar objects, the score indicates how well an object matches the model for which it is searching. For the Edge object, the Score result measures the level at which a contrast between Light to Dark or Dark to Light transition takes place. For ColorMatch objects, this refers to the matching degree of colors in a color space.

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 to 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.

For ColorMatch objects, a score is calculated based on the distance in a color space. When the result is within the permitted range centering on the model color, a score of 1000 is returned. If the result is away from this permitted range, a score value is reduced according to its distance.

Statistics
For the Score Result, the following statistics are available.

ScoreMax, ScoreMean, ScoreMin, ScoreStdDev.

For details on how to use statistics, refer to 9.Using Vision Guide Statistics in the Vision Guide Software manual.

See Also
Accept Property, CodeReader Object, Confusion Property, Correlation Object, Edge Object, Found Result, Geometric Object, OCR Object, Polar Object