cc.mallet.cluster.neighbor_evaluator
Class PairwiseEvaluator

java.lang.Object
  extended by cc.mallet.cluster.neighbor_evaluator.ClassifyingNeighborEvaluator
      extended by cc.mallet.cluster.neighbor_evaluator.PairwiseEvaluator
All Implemented Interfaces:
NeighborEvaluator, java.io.Serializable

public class PairwiseEvaluator
extends ClassifyingNeighborEvaluator

Uses a Classifier over pairs of Instances to score Neighbor. Currently only supports AgglomerativeNeighbors.

Since:
1.0
Version:
1.0
Author:
"Aron Culotta"
See Also:
ClassifyingNeighborEvaluator, Serialized Form

Nested Class Summary
static class PairwiseEvaluator.Average
           
static interface PairwiseEvaluator.CombiningStrategy
          Specifies how to combine a set of pairwise scores into a cluster-wise score.
static class PairwiseEvaluator.Maximum
           
static class PairwiseEvaluator.Minimum
           
 
Constructor Summary
PairwiseEvaluator(Classifier classifier, java.lang.String scoringLabel, PairwiseEvaluator.CombiningStrategy combiningStrategy, boolean mergeFirst)
           
 
Method Summary
 double evaluate(Neighbor neighbor)
           
 double[] evaluate(Neighbor[] neighbors)
           
 void reset()
          Reset the state of the evaluator.
 java.lang.String toString()
           
 
Methods inherited from class cc.mallet.cluster.neighbor_evaluator.ClassifyingNeighborEvaluator
getClassifier
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PairwiseEvaluator

public PairwiseEvaluator(Classifier classifier,
                         java.lang.String scoringLabel,
                         PairwiseEvaluator.CombiningStrategy combiningStrategy,
                         boolean mergeFirst)
Parameters:
classifier - Classifier to assign scores to Neighbors for which a pair of Instances has been merged.
scoringLabel - The predicted label that corresponds to a positive example (e.g. "YES").
combiningStrategy - How to combine the pairwise scores (e.g. max, mean, ...).
mergeFirst - If true, score all edges involved in a merge. If false, only score the edges that cross the boundaries of the clusters being merged.
Method Detail

evaluate

public double[] evaluate(Neighbor[] neighbors)
Specified by:
evaluate in interface NeighborEvaluator
Overrides:
evaluate in class ClassifyingNeighborEvaluator
Returns:
One score per neighbor. A higher score indicates that the modified Clustering is preferred.

evaluate

public double evaluate(Neighbor neighbor)
Specified by:
evaluate in interface NeighborEvaluator
Overrides:
evaluate in class ClassifyingNeighborEvaluator
Returns:
A higher score indicates that the modified Clustering is preferred.

reset

public void reset()
Description copied from interface: NeighborEvaluator
Reset the state of the evaluator.

Specified by:
reset in interface NeighborEvaluator
Overrides:
reset in class ClassifyingNeighborEvaluator

toString

public java.lang.String toString()
Overrides:
toString in class ClassifyingNeighborEvaluator