edu.illinois.cs.cogcomp.lbjava.IR

Class InferenceDeclaration

java.lang.Object

edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

edu.illinois.cs.cogcomp.lbjava.IR.Declaration

edu.illinois.cs.cogcomp.lbjava.IR.InferenceDeclaration

All Implemented Interfaces:

CodeGenerator

public class InferenceDeclaration
extends Declaration
implements CodeGenerator

Represents an inference specification.

Author:

Nick Rizzolo

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	InferenceDeclaration.Clause An intermediate class used during parsing to represent the various clauses of an inference declaration.
static class	InferenceDeclaration.HeadFinder A head finder is a method that finds the head object for an inference given another object.
static class	InferenceDeclaration.NormalizerDeclaration A normalizer declaration is a clause of an inference declaration that specifies a normalizer to be used in association with a particular learning classifier or in general.

Field Summary

Fields

Modifier and Type	Field and Description
InstanceCreationExpression	algorithm (ø) A constructor for the inference algorithm to use.
ConstraintDeclaration	constraint (¬ø) The constraint that must be respected during optimization.
static InstanceCreationExpression	defaultInferenceConstructor If no inference algorithm is specified, this algorithm is used.
Argument	head (¬ø) A specification of the object from which all variables can be found.
InferenceDeclaration.HeadFinder[]	headFinders (¬ø) The methods used to find the head object given objects of different types.
InferenceDeclaration.NormalizerDeclaration[]	normalizerDeclarations (¬ø) Declarations describing how the scores produced by various learning classifiers should be normalized.
int	subjecttoClauses Counts the number of subjectto clauses for error detection.
int	withClauses Counts the number of with clauses for error detection.

Fields inherited from class edu.illinois.cs.cogcomp.lbjava.IR.Declaration

comment, name

Fields inherited from class edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

byteOffset, line, nodeID, symbolTable

Constructor Summary

Constructors

Constructor and Description
InferenceDeclaration(String com, int line, int byteOffset, Name n, Argument h, InferenceDeclaration.HeadFinder[] f, InferenceDeclaration.NormalizerDeclaration[] d, ConstraintDeclaration con, InstanceCreationExpression a) Full constructor.
InferenceDeclaration(TokenValue t, TokenValue i, Argument h, LinkedList c) Parser's constructor.

Method Summary

Modifier and Type	Method and Description
Object	clone() Creates a new object with the same primitive data, and recursively creates new member data objects as well.
boolean	containsTypeSpecificNormalizer() Returns true iff at least one of the normalizer declarations is specific to a given type.
int	getLine() Returns the line number on which this AST node is found in the source (starting from line 0).
String	getName() Returns the name of the InferenceDeclaration.
Type	getType() Returns the type of the declaration.
ASTNodeIterator	iterator() Returns an iterator used to successively access the children of this node.
void	runPass(Pass pass) Ensures that the correct run() method is called for this type of node.
StringBuffer	shallow() Returns a shallow textual representation of this AST node.
void	write(StringBuffer buffer) Writes a string representation of this ASTNode to the specified buffer.

Methods inherited from class edu.illinois.cs.cogcomp.lbjava.IR.ASTNode

toString

Methods inherited from class java.lang.Object

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

Field Detail

defaultInferenceConstructor

public static final InstanceCreationExpression defaultInferenceConstructor

If no inference algorithm is specified, this algorithm is used.

head

public Argument head

(¬ø) A specification of the object from which all variables can be found.

headFinders

public InferenceDeclaration.HeadFinder[] headFinders

(¬ø) The methods used to find the head object given objects of different types.

normalizerDeclarations

public InferenceDeclaration.NormalizerDeclaration[] normalizerDeclarations

(¬ø) Declarations describing how the scores produced by various learning classifiers should be normalized.

constraint

public ConstraintDeclaration constraint

(¬ø) The constraint that must be respected during optimization.

subjecttoClauses

public int subjecttoClauses

Counts the number of subjectto clauses for error detection.

algorithm

public InstanceCreationExpression algorithm

(ø) A constructor for the inference algorithm to use.

withClauses

public int withClauses

Counts the number of with clauses for error detection.

Constructor Detail

InferenceDeclaration

public InferenceDeclaration(String com,
                            int line,
                            int byteOffset,
                            Name n,
                            Argument h,
                            InferenceDeclaration.HeadFinder[] f,
                            InferenceDeclaration.NormalizerDeclaration[] d,
                            ConstraintDeclaration con,
                            InstanceCreationExpression a)

Full constructor.

Parameters:

com - A Javadoc comment associated with the declaration.

line - The line on which the source code represented by this node is found.

byteOffset - The byte offset from the beginning of the source file at which the source code represented by this node is found.

n - The inference's name.

h - The specification of the head object.

f - An array of methods used to find the head object.

d - An array of normalizer declarations.

con - The constraint this inference must respect.

a - A constructor for the inference algorithm.

InferenceDeclaration

public InferenceDeclaration(TokenValue t,
                            TokenValue i,
                            Argument h,
                            LinkedList c)

Parser's constructor. Line and byte offset information is taken from the first token.

Parameters:

t - The first token indicates line and byte offset information.

i - The identifier token representing the classifier's name.

h - The specification of the head object.

c - A list of clauses from the body of the declaration.

Method Detail

containsTypeSpecificNormalizer

public boolean containsTypeSpecificNormalizer()

Returns true iff at least one of the normalizer declarations is specific to a given type.

getType

public Type getType()

Returns the type of the declaration.

Specified by:

getType in class Declaration

Returns:

The type of the declaration.

getName

public String getName()

Returns the name of the InferenceDeclaration.

Specified by:

getName in interface CodeGenerator

getLine

public int getLine()

Returns the line number on which this AST node is found in the source (starting from line 0). This method exists to fulfull the implementation of CodeGenerator.

Specified by:

getLine in interface CodeGenerator

See Also:

CodeGenerator

shallow

public StringBuffer shallow()

Returns a shallow textual representation of this AST node. The difference between the result of this method and the result of write(StringBuffer) is that this method omits the subjectto clause.

Specified by:

shallow in interface CodeGenerator

iterator

public ASTNodeIterator iterator()

Returns an iterator used to successively access the children of this node.

Overrides:

iterator in class Declaration

Returns:

An iterator used to successively access the children of this node.

clone

public Object clone()

Creates a new object with the same primitive data, and recursively creates new member data objects as well.

Overrides:

clone in class ASTNode

Returns:

The clone node.

runPass

public void runPass(Pass pass)

Ensures that the correct run() method is called for this type of node.

Specified by:

runPass in class ASTNode

Parameters:

pass - The pass whose run() method should be called.

write

public void write(StringBuffer buffer)

Writes a string representation of this ASTNode to the specified buffer. The representation written is parsable by the LBJava compiler, but not very readable.

Specified by:

write in class ASTNode

Parameters:

buffer - The buffer to write to.