NAME
Set::Similarity - similarity measures for sets
SYNOPSIS
use Set::Similarity::Dice;
# object method
my $dice = Set::Similarity::Dice->new;
my $similarity = $dice->similarity('Photographer','Fotograf');
# class method
my $dice = 'Set::Similarity::Dice';
my $similarity = $dice->similarity('Photographer','Fotograf');
# from 2-grams
my $width = 2;
my $similarity = $dice->similarity('Photographer','Fotograf',$width);
# from arrayref of tokens
my $similarity = $dice->similarity(['a','b'],['b']);
# from hashref of features
my $bird = {
wings => true,
eyes => true,
feathers => true,
hairs => false,
legs => true,
arms => false,
};
my $mammal = {
wings => false,
eyes => true,
feathers => false,
hairs => true,
legs => true,
arms => true,
};
my $similarity = $dice->similarity($bird,$mammal);
# from arrayref sets
my $bird = [qw(
wings
eyes
feathers
legs
)];
my $mammal = [qw(
eyes
hairs
legs
arms
)];
my $similarity = $dice->from_sets($bird,$mammal);
DESCRIPTION
This is the base class including mainly helper and convenience methods.
Overlap coefficient
( A intersect B ) / min(A,B)
Jaccard Index
The Jaccard coefficient measures similarity between sample sets, and is
defined as the size of the intersection divided by the size of the
union of the sample sets
( A intersect B ) / (A union B)
The Tanimoto coefficient is the ratio of the number of features common
to both sets to the total number of features, i.e.
( A intersect B ) / ( A + B - ( A intersect B ) ) # the same as Jaccard
The range is 0 to 1 inclusive.
Dice coefficient
The Dice coefficient is the number of features in common to both sets
relative to the average size of the total number of features present,
i.e.
( A intersect B ) / 0.5 ( A + B ) # the same as sorensen
The weighting factor comes from the 0.5 in the denominator. The range
is 0 to 1.
METHODS
All methods can be used as class or object methods.
new
$object = Set::Similarity->new();
similarity
my $similarity = $object->similarity($any1,$any1,$width);
$any can be an arrayref, a hashref or a string. Strings are tokenized
into n-grams of width $width.
$width must be integer, or defaults to 1.
from_tokens
my $similarity = $object->from_tokens(['a','b'],['b']);
from_sets
my $similarity = $object->from_sets(['a'],['b']);
Croaks if called directly. This method should be implemented in a child
module.
intersection
my $intersection_size = $object->intersection(['a'],['b']);
uniq
my @uniq = $object->uniq(['a','b']);
Transforms an arrayref of strings into an array of unique elements.
combined_length
my $set_size_sum = $object->combined_length(['a'],['b']);
min
my $min_set_size = $object->min(['a'],['b']);
ngrams
my @monograms = $object->ngrams('abc');
my @bigrams = $object->ngrams('abc',2);
_any
my $arrayref = $object->_any($any,$width);
SEE ALSO
Set::Similarity::Cosine
Set::Similarity::Dice
Set::Similarity::Jaccard
Set::Similarity::Overlap
Bag::Similarity doing the same for bags or multisets.
Text::Levenshtein for distance measures of strings, and a very overview
of similar modules,
http://en.wikipedia.org/wiki/String_metric for an overview of
similarity measures.
Cluster::Similarity for clusters.
SOURCE REPOSITORY
http://github.com/wollmers/Set-Similarity
AUTHOR
Helmut Wollmersdorfer,
COPYRIGHT AND LICENSE
Copyright (C) 2013-2015 by Helmut Wollmersdorfer
This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.