edu.illinois.cs.cogcomp.lbjava

Class Train

java.lang.Object

edu.illinois.cs.cogcomp.lbjava.Pass

edu.illinois.cs.cogcomp.lbjava.Train

public class Train
extends Pass

After code has been generated with TranslateToJava, this pass trains any classifiers for which training was indicated.

Author:

Nick Rizzolo

See Also:

TranslateToJava

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Train.TrainingThread This class contains the code that trains a learning classifier.

Field Summary

Fields

Modifier and Type	Field and Description
protected HashMap	learnerDependencies The keys of this map are the names of learners; the values are LinkedLists of the names of the learners that the learner named by the key depends on.
protected boolean	newCode Set to true iff there existed a LearningClassifierExpression for which new code was generated.
protected int	progressOutput Progress output will be printed every progressOutput examples.
protected HashMap	threadMap A map of all the training threads indexed by the name of the learner.
protected Train.TrainingThread[]	threads An array of the training threads, which is never modified after it is constructed.

Fields inherited from class edu.illinois.cs.cogcomp.lbjava.Pass

ast, canAddErrorsAndWarnings, fatalError, root

Constructor Summary

Constructors

Constructor and Description
Train(AST ast, int output) Instantiates a pass that runs on an entire AST.

Method Summary

Modifier and Type	Method and Description
protected void	executeReadyThreads(String name) This method updates the learnerDependencies graph by removing the specified name from every dependencies list, and then starts every thread that has no more dependencies.
protected void	fillLearnerDependorsDAG() This method initializes the learnerDependencies graph such that the entry for each learner contains the names of all learners that depend on it, except that cycles are broken by preferring that learners appearing earlier in the source get trained first.
void	run(AST ast) Runs this pass on all nodes of the indicated type.
void	run(CodedClassifier cc) Runs this pass on all nodes of the indicated type.
void	run(ConstraintDeclaration cd) Runs this pass on all nodes of the indicated type.
void	run(InferenceDeclaration id) Runs this pass on all nodes of the indicated type.
void	run(LearningClassifierExpression lce) Runs this pass on all nodes of the indicated type.
static boolean	runJavac(String arguments) Run the javac compiler with the specified arguments in addition to those specified on the command line.

Methods inherited from class edu.illinois.cs.cogcomp.lbjava.Pass

printErrorsAndWarnings, reportError, reportWarning, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, run, runOnChildren, setRoot

Methods inherited from class java.lang.Object

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

Field Detail

progressOutput

protected int progressOutput

Progress output will be printed every progressOutput examples.

newCode

protected boolean newCode

Set to true iff there existed a LearningClassifierExpression for which new code was generated.

threads

protected Train.TrainingThread[] threads

An array of the training threads, which is never modified after it is constructed.

threadMap

protected HashMap threadMap

A map of all the training threads indexed by the name of the learner.

learnerDependencies

protected HashMap learnerDependencies

The keys of this map are the names of learners; the values are LinkedLists of the names of the learners that the learner named by the key depends on.

Constructor Detail

Train

public Train(AST ast,
             int output)

Instantiates a pass that runs on an entire AST.

Parameters:

ast - The program to run this pass on.

output - Progress output will be printed every output examples.

Method Detail

runJavac

public static boolean runJavac(String arguments)

Run the javac compiler with the specified arguments in addition to those specified on the command line.

Parameters:

arguments - The arguments to send to javac.

Returns:

true iff errors were encountered.

fillLearnerDependorsDAG

protected void fillLearnerDependorsDAG()

This method initializes the learnerDependencies graph such that the entry for each learner contains the names of all learners that depend on it, except that cycles are broken by preferring that learners appearing earlier in the source get trained first.

executeReadyThreads

protected void executeReadyThreads(String name)

This method updates the learnerDependencies graph by removing the specified name from every dependencies list, and then starts every thread that has no more dependencies.

Parameters:

name - The name of a learner whose training has completed.

run

public void run(AST ast)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

ast - The node to process.

run

public void run(LearningClassifierExpression lce)

Runs this pass on all nodes of the indicated type.

Overrides:

run in class Pass

Parameters:

lce - The node to process.

run

public void run(CodedClassifier cc)

Runs this pass on all nodes of the indicated type. There's no reason to traverse children of CodedClassifiers, so this method exists simply to stop that from happening.

Overrides:

run in class Pass

Parameters:

cc - The node to process.

run

public void run(ConstraintDeclaration cd)

Runs this pass on all nodes of the indicated type. There's no reason to traverse children of ConstraintDeclarations, so this method exists simply to stop that from happening.

Overrides:

run in class Pass

Parameters:

cd - The node to process.

run

public void run(InferenceDeclaration id)

Runs this pass on all nodes of the indicated type. There's no reason to traverse children of InferenceDeclarations, so this method exists simply to stop that from happening.

Overrides:

run in class Pass

Parameters:

id - The node to process.