package de.anomic.data; import java.util.Collections; import java.util.Comparator; import java.util.Set; import java.util.SortedSet; import java.util.TreeSet; import java.util.concurrent.LinkedBlockingQueue; import net.yacy.cora.storage.ReversibleScoreMap; import net.yacy.cora.storage.ClusteredScoreMap; import net.yacy.document.LibraryProvider; import net.yacy.kelondro.data.word.Word; import net.yacy.kelondro.data.word.WordReference; import net.yacy.kelondro.logging.Log; import net.yacy.kelondro.rwi.IndexCell; /** * People make mistakes when they type words. * The most common mistakes are the four categories listed below: *
    *
  1. Changing one letter: bat / cat;
  2. *
  3. Adding one letter: bat / boat;
  4. *
  5. Deleting one letter: frog / fog; or
  6. *
  7. Reversing two consecutive letters: two / tow.
  8. *
* DidYouMean provides producer threads, that feed a blocking queue with word variations according to * the above mentioned four categories. Consumer threads check then the generated word variations against a term index. * Only words contained in the term index are return by the getSuggestion method.

* @author apfelmaennchen * @author orbiter (extensions for multi-language support) */ public class DidYouMean { private static final int MinimumInputWordLength = 2; private static final int MinimumOutputWordLength = 4; private static final char[] ALPHABET_LATIN = { 'a','b','c','d','e','f','g','h','i','j','k','l','m','n','o','p', 'q','r','s','t','u','v','w','x','y','z', '\u00df', '\u00e0','\u00e1','\u00e2','\u00e3','\u00e4','\u00e5','\u00e6','\u00e7', '\u00e8','\u00e9','\u00ea','\u00eb','\u00ec','\u00ed','\u00ee','\u00ef', '\u00f0','\u00f1','\u00f2','\u00f3','\u00f4','\u00f5','\u00f6', '\u00f8','\u00f9','\u00fa','\u00fb','\u00fc','\u00fd','\u00fe','\u00ff'}; private static final char[] ALPHABET_KANJI = new char[512]; static { // this is very experimental: a very small subset of Kanji for (char a = '\u3400'; a <= '\u34ff'; a++) ALPHABET_KANJI[0xff & (a - '\u3400')] = a; for (char a = '\u4e00'; a <= '\u4eff'; a++) ALPHABET_KANJI[0xff & (a - '\u4e00') + 256] = a; } private static final char[][] ALPHABETS = {ALPHABET_LATIN, ALPHABET_KANJI}; private static char[] alphabet = ALPHABET_LATIN; private static final String POISON_STRING = "\n"; public static final int AVAILABLE_CPU = Runtime.getRuntime().availableProcessors(); private static final wordLengthComparator WORD_LENGTH_COMPARATOR = new wordLengthComparator(); private final IndexCell index; private final String word; private final int wordLen; private final LinkedBlockingQueue guessGen, guessLib; private long timeLimit; private boolean createGen; // keeps the value 'true' as long as no entry in guessLib is written private final SortedSet resultSet; private final indexSizeComparator INDEX_SIZE_COMPARATOR; /** * @param index a termIndex - most likely retrieved from a switchboard object. * @param sort true/false - sorts the resulting TreeSet by index.count(); Warning: this causes heavy i/o. */ public DidYouMean(final IndexCell index, final String word0) { this.resultSet = Collections.synchronizedSortedSet(new TreeSet(new headMatchingComparator(word0, WORD_LENGTH_COMPARATOR))); this.word = word0.toLowerCase(); this.wordLen = word.length(); this.index = index; this.guessGen = new LinkedBlockingQueue(); this.guessLib = new LinkedBlockingQueue(); this.createGen = true; this.INDEX_SIZE_COMPARATOR = new indexSizeComparator(); // identify language if (this.word.length() > 0) { char testchar = this.word.charAt(0); boolean alphafound = false; alphatest: for (char[] alpha: ALPHABETS) { if (isAlphabet(alpha, testchar)) { alphabet = alpha; alphafound = true; break alphatest; } } if (!alphafound) { // generate generic alphabet using simply a character block of 256 characters char firstchar = (char) ((0xff & (testchar / 256)) * 256); char lastchar = (char) (firstchar + 255); alphabet = new char[256]; for (char a = firstchar; a <= lastchar; a++) { alphabet[0xff & (a - firstchar)] = a; } } } } private static final boolean isAlphabet(final char[] alpha, final char testchar) { for (final char a: alpha) if (a == testchar) return true; return false; } public void reset() { this.resultSet.clear(); this.guessGen.clear(); this.guessLib.clear(); } /** * get suggestions for a given word. The result is first ordered using a term size ordering, * and a subset of the result is sorted again with a IO-intensive order based on the index size * @param word0 * @param timeout * @param preSortSelection the number of words that participate in the IO-intensive sort * @return */ public SortedSet getSuggestions(final long timeout, final int preSortSelection) { if (this.word.length() < MinimumInputWordLength) return this.resultSet; // return nothing if input is too short final long startTime = System.currentTimeMillis(); final long timelimit = startTime + timeout; if (this.word.indexOf(' ') > 0) return getSuggestions(this.word.split(" "), timeout, preSortSelection, this.index); final SortedSet preSorted = getSuggestions(timeout); if (System.currentTimeMillis() > timelimit) { Log.logInfo("DidYouMean", "found and returned " + preSorted.size() + " unsorted suggestions (1); execution time: " + (System.currentTimeMillis() - startTime) + "ms"); return preSorted; } final ReversibleScoreMap scored = new ClusteredScoreMap(); for (final String s: preSorted) { if (System.currentTimeMillis() > timelimit) break; if (!(scored.sizeSmaller(2 * preSortSelection))) break; scored.inc(s, index.count(Word.word2hash(s))); } final SortedSet countSorted = Collections.synchronizedSortedSet(new TreeSet(new headMatchingComparator(this.word, this.INDEX_SIZE_COMPARATOR))); final int wc = index.count(Word.word2hash(this.word)); // all counts must be greater than this while (!scored.isEmpty() && countSorted.size() < preSortSelection) { final String s = scored.getMaxKey(); int score = scored.delete(s); if (s.length() >= MinimumOutputWordLength && score > wc) countSorted.add(s); if (System.currentTimeMillis() > timelimit) break; } // finished if (countSorted.size() == 0) { Log.logInfo("DidYouMean", "found and returned " + preSorted.size() + " unsorted suggestions (2); execution time: " + (System.currentTimeMillis() - startTime) + "ms"); return preSorted; } Log.logInfo("DidYouMean", "found " + preSorted.size() + " unsorted terms, returned " + countSorted.size() + " sorted suggestions; execution time: " + (System.currentTimeMillis() - startTime) + "ms"); return countSorted; } /** * return a string that is a suggestion list for the list of given words * @param words * @param timeout * @param preSortSelection * @return */ @SuppressWarnings("unchecked") private static SortedSet getSuggestions(final String[] words, final long timeout, final int preSortSelection, final IndexCell index) { final SortedSet[] s = new SortedSet[words.length]; for (int i = 0; i < words.length; i++) { s[i] = new DidYouMean(index, words[i]).getSuggestions(timeout / words.length, preSortSelection); } // make all permutations final SortedSet result = new TreeSet(); StringBuilder sb; for (int i = 0; i < words.length; i++) { if (s[i].isEmpty()) continue; sb = new StringBuilder(20); for (int j = 0; j < words.length; j++) { if (j > 0) sb.append(' '); if (i == j) sb.append(s[j].first()); else sb.append(words[j]); } result.add(sb.toString()); } return result; } /** * This method triggers the producer and consumer threads of the DidYouMean object. * @param word a String with a single word * @param timeout execution time in ms. * @return a Set<String> with word variations contained in term index. */ private SortedSet getSuggestions(final long timeout) { long startTime = System.currentTimeMillis(); this.timeLimit = startTime + timeout; // create one consumer thread that checks the guessLib queue // for occurrences in the index. If the producers are started next, their // results can be consumers directly final Consumer[] consumers = new Consumer[AVAILABLE_CPU]; consumers[0] = new Consumer(); consumers[0].start(); // get a single recommendation for the word without altering the word Set libr = LibraryProvider.dymLib.recommend(this.word); for (final String t: libr) { if (!t.equals(this.word)) try { createGen = false; guessLib.put(t); } catch (InterruptedException e) {} } // create and start producers // the CPU load to create the guessed words is very low, but the testing // against the library may be CPU intensive. Since it is possible to test // words in the library concurrently, it is a good idea to start separate threads final Thread[] producers = new Thread[4]; producers[0] = new ChangingOneLetter(); producers[1] = new AddingOneLetter(); producers[2] = new DeletingOneLetter(); producers[3] = new ReversingTwoConsecutiveLetters(); for (final Thread t: producers) t.start(); // start more consumers if there are more cores if (consumers.length > 1) for (int i = 1; i < consumers.length; i++) { consumers[i] = new Consumer(); consumers[i].start(); } // now decide which kind of guess is better // we take guessLib entries as long as there is any entry in it // to see if this is the case, we must wait for termination of the producer for (final Thread t: producers) try { t.join(); } catch (InterruptedException e) {} // if there is not any entry in guessLib, then transfer all entries from the // guessGen to guessLib if (createGen) try { this.guessGen.put(POISON_STRING); String s; while (!(s = this.guessGen.take()).equals(POISON_STRING)) this.guessLib.put(s); } catch (InterruptedException e) {} // put poison into guessLib to terminate consumers for (@SuppressWarnings("unused") final Consumer c: consumers) try { guessLib.put(POISON_STRING); } catch (InterruptedException e) {} // wait for termination of consumer for (final Consumer c: consumers) try { c.join(); } catch (InterruptedException e) {} // we don't want the given word in the result this.resultSet.remove(this.word); return this.resultSet; } private void test(final String s) throws InterruptedException { final Set libr = LibraryProvider.dymLib.recommend(s); libr.addAll(LibraryProvider.geoLoc.recommend(s)); if (!libr.isEmpty()) createGen = false; for (final String t: libr) { guessLib.put(t); } if (createGen) { guessGen.put(s); } } /** * DidYouMean's producer thread that changes one letter (e.g. bat/cat) for a given term * based on the given alphabet and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (alphabet.length * len) tests. */ public class ChangingOneLetter extends Thread { @Override public void run() { char m; for (int i = 0; i < wordLen; i++) try { m = word.charAt(i); for (char c: alphabet) { if (m != c) test(word.substring(0, i) + c + word.substring(i + 1)); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that deletes extra letters (e.g. frog/fog) for a given term * and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (len) tests. */ private class DeletingOneLetter extends Thread { @Override public void run() { for (int i = 0; i < wordLen; i++) try { test(word.substring(0, i) + word.substring(i+1)); if (System.currentTimeMillis() > timeLimit) return; } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that adds missing letters (e.g. bat/boat) for a given term * based on the given alphabet and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (alphabet.length * len) tests. */ private class AddingOneLetter extends Thread { @Override public void run() { for (int i = 0; i <= wordLen; i++) try { for (final char c: alphabet) { test(word.substring(0, i) + c + word.substring(i)); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * DidYouMean's producer thread that reverses any two consecutive letters (e.g. two/tow) for a given term * and puts it on the blocking queue, to be 'consumed' by a consumer thread.

* Note: the loop runs (len-1) tests. */ private class ReversingTwoConsecutiveLetters extends Thread { @Override public void run() { for (int i = 0; i < wordLen - 1; i++) try { test(word.substring(0, i) + word.charAt(i + 1) + word.charAt(i) + word.substring(i +2)); if (System.currentTimeMillis() > timeLimit) return; } catch (InterruptedException e) {} } } /** * DidYouMean's consumer thread takes a String object (term) from the blocking queue * and checks if it is contained in YaCy's RWI index. * Note: this causes no or moderate i/o as it uses the efficient index.has() method. */ private class Consumer extends Thread { @Override public void run() { String s; try { while (!(s = guessLib.take()).equals(POISON_STRING)) { if (s.length() >= MinimumOutputWordLength && index.has(Word.word2hash(s))) resultSet.add(s); if (System.currentTimeMillis() > timeLimit) return; } } catch (InterruptedException e) {} } } /** * indexSizeComparator is used by DidYouMean to order terms by index.count() * Warning: this causes heavy i/o */ private class indexSizeComparator implements Comparator { public int compare(final String o1, final String o2) { final int i1 = index.count(Word.word2hash(o1)); final int i2 = index.count(Word.word2hash(o2)); if (i1 == i2) return WORD_LENGTH_COMPARATOR.compare(o1, o2); return (i1 < i2) ? 1 : -1; // '<' is correct, because the largest count shall be ordered to be the first position in the result } } /** * wordLengthComparator is used by DidYouMean to order terms by the term length * This is the default order if the indexSizeComparator is not used */ private static class wordLengthComparator implements Comparator { public int compare(final String o1, final String o2) { final int i1 = o1.length(); final int i2 = o2.length(); if (i1 == i2) return o1.compareTo(o2); return (i1 < i2) ? 1 : -1; // '<' is correct, because the longest word shall be first } } /** * headMatchingComparator is used to sort results in such a way that words that match with the given words are sorted first */ private static class headMatchingComparator implements Comparator { private final String head; private final Comparator secondaryComparator; public headMatchingComparator(final String head, final Comparator secondaryComparator) { this.head = head.toLowerCase(); this.secondaryComparator = secondaryComparator; } public int compare(final String o1, final String o2) { boolean o1m = o1.toLowerCase().startsWith(head); boolean o2m = o2.toLowerCase().startsWith(head); if ((o1m && o2m) || (!o1m && !o2m)) return secondaryComparator.compare(o1, o2); return o1m ? -1 : 1; } } }