com.wcohen.ss.expt

Class MatchExptScript

java.lang.Object

com.wcohen.ss.expt.MatchExptScript

public class MatchExptScript
extends Object

Perform a series of match experiments, specified by a script in an input file.

The input file can contain these commands:

1. echo on, echo off

2. blocker CLASS, distance CLASS, dataset FILE
3. clear blockers, clear learners, clear datasets
4. show blockers, show learners, show datasets

5. compute: compute pairwise learners for using all declared blockers, learners, datasets
6. table maxF1, table averagePrecision, table time, table blockerRecall: show summary performance tables
7. precisionRecall: show precision-recall curves (11-pt interpolated, plus non-interpolated average precision.)

8. save FILE, restore FILE: save previously 'compute'-d results
9. runScript FILE: execute a sub-script

Field Summary

Fields

Modifier and Type	Field and Description
static String	BLOCKER_PACKAGE
static String	DISTANCE_PACKAGE

Constructor Summary

Constructors

Constructor and Description
MatchExptScript()

Method Summary

Modifier and Type	Method and Description
void	blocker(String blockerClass) Load a blocker.
void	blocker(String blockerClass, String param, String value) Load a blocker, with optional boolean value
void	clear(String what) Clear datasets, blockers, or learners.
void	compute() Compute learners.
void	dataset(String dataFile) Load a dataset.
void	distance(String distanceClass) Load a distance learner.
void	echo(String onOrOff) Turn echoing of commands on/off.
void	learner(String learnerClass) Load a learner.
static void	main(String[] argv)
void	precisionRecall() Show interpolated 11-pt precision curves for each blocker/distance/dataset
void	restore(String file) Restore experimental data previously 'saved' toa file.
void	runScript(String configFileName) Load commands from a file and execute them.
void	save(String file) Save current experimental data to a file
void	show(String what) Show datasets, blockers, or learners.
void	table(String what) Show a table of some expt-wide numeric measurement.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

BLOCKER_PACKAGE

public static final String BLOCKER_PACKAGE

See Also:

Constant Field Values

DISTANCE_PACKAGE

public static final String DISTANCE_PACKAGE

See Also:

Constant Field Values

Constructor Detail

MatchExptScript

public MatchExptScript()

Method Detail

clear

public void clear(String what)

Clear datasets, blockers, or learners.

show

public void show(String what)

Show datasets, blockers, or learners.

echo

public void echo(String onOrOff)

Turn echoing of commands on/off.

dataset

public void dataset(String dataFile)
             throws MatchData.InputFormatException

Load a dataset.

Throws:

MatchData.InputFormatException

learner

public void learner(String learnerClass)

Load a learner.

distance

public void distance(String distanceClass)

Load a distance learner. Same as 'learner', provided for backward compatibility, and because sometimes it's more reasonable to think of a distance functions rather than learners for them.

blocker

public void blocker(String blockerClass)
             throws ClassNotFoundException,
                    InstantiationException,
                    IllegalAccessException

Load a blocker.

Throws:

ClassNotFoundException

InstantiationException

IllegalAccessException

blocker

public void blocker(String blockerClass,
                    String param,
                    String value)
             throws ClassNotFoundException,
                    InstantiationException,
                    IllegalAccessException,
                    InvocationTargetException,
                    NoSuchMethodException

Load a blocker, with optional boolean value

Throws:

ClassNotFoundException

InstantiationException

IllegalAccessException

InvocationTargetException

NoSuchMethodException

compute

public void compute()

Compute learners.

table

public void table(String what)
           throws NoSuchMethodException,
                  IllegalAccessException,
                  InvocationTargetException

Show a table of some expt-wide numeric measurement.

Throws:

NoSuchMethodException

IllegalAccessException

InvocationTargetException

precisionRecall

public void precisionRecall()

Show interpolated 11-pt precision curves for each blocker/distance/dataset

save

public void save(String file)
          throws IOException,
                 FileNotFoundException

Save current experimental data to a file

Throws:

IOException

FileNotFoundException

restore

public void restore(String file)
             throws IOException,
                    FileNotFoundException,
                    ClassNotFoundException

Restore experimental data previously 'saved' toa file. It will be possible to analyze this data with 'table' commands and etc, but not to perform additional experiments.

Throws:

IOException

FileNotFoundException

ClassNotFoundException

runScript

public void runScript(String configFileName)

Load commands from a file and execute them.

main

public static void main(String[] argv)