blob: 898e59f7c10d66618d28606964d0e52b99e42210 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
#stringmetric
A collection of string metrics implemented in Scala. Includes a light-weight core API and CLI for each string metric. The following string metrics are currently supported:
* __Dice / Sorensen__ (<http://en.wikipedia.org/wiki/Dice%27s_coefficient>)
* _API_: org.hashtree.stringmetric.similarity.DiceSorensenMetric
* _CLI_: diceSorensenMetric
* __Hamming__ (<http://en.wikipedia.org/wiki/Hamming_distance>)
* _API_: org.hashtree.stringmetric.similarity.HammingMetric
* _CLI_: hammingMetric
* __Jaro__ (<http://en.wikipedia.org/wiki/Jaro-Winkler_distance>)
* _API_: org.hashtree.stringmetric.similarity.JaroMetric
* _CLI_: jaroMetric
* __Jaro-Winkler__ (<http://en.wikipedia.org/wiki/Jaro-Winkler_distance>)
* _API_: org.hashtree.stringmetric.similarity.JaroWinklerMetric
* _CLI_: jaroWinklerMetric
* __Levenshtein__ (<http://en.wikipedia.org/wiki/Levenshtein_distance>)
* _API_: org.hashtree.stringmetric.similarity.LevenshteinMetric
* _CLI_: levenshteinMetric
* __Metaphone__ (<http://en.wikipedia.org/wiki/Metaphone>)
* _API_: org.hashtree.stringmetric.phonetic.MetaphoneMetric
* _CLI_: metaphoneMetric
* __NYSIIS__ (<http://en.wikipedia.org/wiki/New_York_State_Identification_and_Intelligence_System>)
* _API_: org.hashtree.stringmetric.phonetic.NysiisMetric
* _CLI_: nysiisMetric
* __Refined Soundex__ (<http://ntz-develop.blogspot.com/2011/03/phonetic-algorithms.html>)
* _API_: org.hashtree.stringmetric.phonetic.RefinedSoundexMetric
* _CLI_: refinedSoundexMetric
* __Soundex__ (<http://en.wikipedia.org/wiki/Soundex>)
* _API_: org.hashtree.stringmetric.phonetic.SoundexMetric
* _CLI_: soundexMetric
All phonetic string metrics have a standalone algorithm counterpart. They provide a means to determine the phonetic representation of the argument passed, rather than evaluating if two arguments sound the same phonetically.
* __Metaphone__
* _API_: org.hashtree.stringmetric.phonetic.MetaphoneAlgorithm
* _CLI_: metaphoneAlgorithm
* __NYSIIS__
* _API_: org.hashtree.stringmetric.phonetic.NysiisAlgorithm
* _CLI_: nysiisAlgorithm
* __Refined Soundex__
* _API_: org.hashtree.stringmetric.phonetic.RefinedSoundexAlgorithm
* _CLI_: refinedSoundexAlgorithm
* __Soundex__
* _API_: org.hashtree.stringmetric.phonetic.SoundexAlgorithm
* _CLI_: soundexAlgorithm
Filters are available which clean up arguments prior to evaluation. Filtering rules can be composed via trait decoration.
* __Differing Case__ (Ignore all ASCII letter case differences)
* _API_: org.hashtree.stringmetric.AsciiLetterCaseStringFilter
* __Non-Letters__ (Ignore all characters except for ASCII letters)
* _API_: org.hashtree.stringmetric.AsciiLetterOnlyStringFilter
* __Spaces__ (Ignore all spaces)
* _API_: org.hashtree.stringmetric.SpaceStringFilter
## Building the API
gradle :stringmetric-core:jar
## Building the CLI
gradle :stringmetric-cli:tar
## Using the API
`// Import metric of choice.`
`import org.hashtree.stringmetric.similarity.JaroWinklerMetric`
`// Import some filters, optionally.`
`import org.hashtree.stringmetric.{ AsciiLetterCaseStringFilter, AsciiLetterOnlyStringFilter, StringFilterDelegate }`
`// Invoke metric compare method without filters.`
`val distance0 = JaroWinklerMetric.compare("string1", "string2")`
`// Invoke metric compare method with filters to ignore non-letter characters and case.`
`val distance1 = JaroWinklerMetric.compare("string1", "string2")`
`(new StringFilterDelegate with AsciiLetterCaseStringFilter with AsciiLetterOnlyStringFilter)`
`// Invoke metric compare method with filters to ignore case.`
`val distance2 = JaroWinklerMetric.compare("string1", "string2")`
`(new StringFilterDelegate with AsciiLetterCaseStringFilter)`
`// All metrics have an overloaded compare method which accepts character arrays.`
`val distance3 = JaroWinklerMetric.compare("string1".toCharArray, "string2".toCharArray)`
`// Do something. In this case, distance is between 1.0 and 0.0.`
`if (distance0 >= 0.9) println("It's likely you're a match!")`
## Using the CLI
Uncompress the built tar and ensure you have ability to execute the commands. Execute the metric of choice via the command line:
`// The help option prints command syntax and usage.`
`jaroWinklerMetric --help`
`metaphoneMetric --help`
`metaphoneAlgorithm --help`
`// Compare "abc" to "xyz" using the Jaro-Winkler metric.`
`jaroWinklerMetric abc xyz`
`// Compare "abc "to "xyz" using the Metaphone metric.`
`metaphoneMetric abc xyz`
`// Get the phonetic representation of "abc" via the metaphone phonetic algorithm.`
`metaphoneAlgorithm abc`
## Requirements
* Scala 2.9.2
* Gradle 1.0 or above
## License
Apache License, Version 2.0
|
