soundex-code

soundex-code

Fast Soundex implementation. No cruft. Real fast.

Soundex is one of the earlier phonetics algorithms, specifically designed for surnames, inspiring others such as metaphone.

Depending on your goals, additionally use a stemmer (e.g., my own porter stemmer implementation) for better results.

Installation

npm:

$ npm install soundex-code

Component.js:

$ component install wooorm/soundex-code

Bower:

$ bower install soundex-code

Duo:

var soundex = require('wooorm/soundex-code');

Usage

var soundex = require('soundex-code');

soundex("phonetics"); // "P532"
soundex("Ashcraft"); // "A261"
soundex("Lissajous"); // "L222"
soundex("Smith") === soundex-code("Schmit"); // true

soundex("Ashcraftersson", 6); // "A26136"
soundex("A", 6); // "A000"

CLI

Install:

$ npm install --global soundex-code

Use:

Usage: soundex-code [options] <words...>

Fast Soundex implementation

Options:

  -h, --help           output usage information
  -v, --version        output version number

Usage:

# output phonetics
$ soundex-code phonetics unicorn
# P532 U526

# output phonetics from stdin
$ echo "phonetics banana" | soundex-code
# P532 B550

Benchmark

On a MacBook Air, it runs about 516,000 op/s.

           soundexCode — this module
  410 op/s » op/s * 1,000

           natural
  182 op/s » op/s * 1,000

           soundex-encode
   45 op/s » op/s * 1,000

           soundex
   30 op/s » op/s * 1,000

Related

• metaphone — The orignal Metaphone algorithm;
• double-metaphone — The Double Metaphone algorithm.

License

MIT © Titus Wormer