org.simmetrics

Interface SetMetric<T>

Type Parameters:

T - the type of elements contained in the sets

All Superinterfaces:

Metric<Set<T>>

All Known Implementing Classes:

CosineSimilarity, DiceSimilarity, JaccardSimilarity, OverlapCoefficient

public interface SetMetric<T>
extends Metric<Set<T>>

Measures the similarity between two arbitrary sets containing elements of the same type. The measurement results in a value between 0 and 1 inclusive. A value of zero indicates that the sets are dissimilar, a value of 1 indicates they are similar.

The elements in the set have to implement Object.hashCode() and Object.equals(Object).

The elements in the sets may not be null if metric does not support null values.

The similarity measure should be consistent with equals such that a.equals(b) => compare(a,b) == 1.0.

The similarity measure should be reflexive such that compare(a,a) == 1.0.

The similarity measure should be symmetric such that compare(a,b) == compare(b,a).

Implementations may not modify the contents of the set. Sets should be treated as if wrapped by Collections.unmodifiableSet(Set).

Method Summary

Modifier and Type	Method and Description
float	compare(Set<T> a, Set<T> b) Measures the similarity between sets a and b.

Method Detail

compare

float compare(Set<T> a,
              Set<T> b)

Measures the similarity between sets a and b. The measurement results in a value between 0 and 1 inclusive. A value of zero indicates that the sets are dissimilar, a value of 1 indicates they are similar.

Specified by:

compare in interface Metric<Set<T>>

Parameters:

a - set a to compare

b - set b to compare

Returns:

a value between 0 and 1 inclusive indicating similarity

Throws:

NullPointerException - when either a or b is null