evaluateScore(OrdImageSignature, OrdImageSignature, String)

Format

public static float evaluateScore(OrdImageSignature signature1, OrdImageSignature signature2,
String attrWeights)

Description

Compares two image signatures, returning a score that indicates the degree of difference between the image signatures. This method compares the image signatures in signature1 and signature2 using weights specified for one or more visual attributes. Returns a score between 0.0 and 100.0, where a lower value indicates a closer match.

Specify a weight in the range 0.0 to 1.0 for one or more of the following visual attributes: color, shape, texture, location.

You must specify a value greater than 0.0 for at least one of the following attributes: color, shape, or texture. The location attribute indicates the importance of the distribution of the color, shape, or texture features in the images. During processing, the values are normalized such that they total 1.0. For example:

color=0.7,shape=0.3

Note:

The ORDImageSignature evaluateScore( ) method operates on two image signatures, not on indexes on database tables. Therefore, this method cannot take advantage of the increased performance that is possible using image matching with image signature indexes on the underlying tables. To use image signature indexes, use the IMGSimilar and IMGScore SQL operators.

See Oracle interMedia Reference for more information about image signature indexes.

Parameters

signature1: The first OrdImageSignature.
signature2: An OrdImageSignature to be compared to signature1.
attrWeights: A String that specifies a list of one or more visual attributes and the weight to be applied to each attribute.

Return Value

This method returns the score, as a floating-point value.

Exceptions

java.sql.SQLException

This exception is thrown if an error occurs calling the evaluateScore( ) method in the database.

Examples

None.