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
|
package com.wcohen.ss.api;
/**
* Learn a StringDistance.
*
*/
public interface StringDistanceLearner
{
/** Preprocess a StringWrapperIterator for unsupervised training. */
public StringWrapperIterator prepare(StringWrapperIterator i);
/** Preprocess a DistanceInstanceIterator for supervised training. */
public DistanceInstanceIterator prepare(DistanceInstanceIterator i);
/** Unsupervised learning method that observes strings for which
* distance will be computed. This examines a number of unlabeled
* StringWrapper's and uses that information to tune the distance
* function being learned. An example use of this method would be a
* TFIDF-based distance function, which accumulated token-frequency
* statistics over a corpus.
*/
public void setStringWrapperPool(StringWrapperIterator i);
/** Accept a set of unlabeled DistanceInstance, to use in making
* distance instance queries. Queries are made with the methods
* hasNextQuery(), nextQuery(), and setAnswer().
*/
public void setDistanceInstancePool(DistanceInstanceIterator i);
/** Returns true if the learner has more queries to answer. */
public boolean hasNextQuery();
/** Returns a DistanceInstance for which the learner would like a
* label. */
public DistanceInstance nextQuery();
/** Accept the answer to the last query. An 'answer' is a
* DistanceInstance with a known score or correctness.
*/
public void addExample(DistanceInstance answeredQuery);
/** Return the learned distance.
*/
public StringDistance getDistance();
}
|
