edu.stanford.nlp.parser.common

Class ParserGrammar

java.lang.Object

edu.stanford.nlp.parser.common.ParserGrammar

All Implemented Interfaces:

Function<List<? extends HasWord>,Tree>

Direct Known Subclasses:

LexicalizedParser, ShiftReduceParser

public abstract class ParserGrammar
extends Object
implements Function<List<? extends HasWord>,Tree>

An interface for the classes which store the data for a parser. Objects which inherit this interface have a way to produce ParserQuery objects, have a general Options object, and return a list of Evals to perform on a parser. This helps classes such as EvaluateTreebank analyze the performance of a parser. TODO: it would be nice to actually make this an interface again. Perhaps Java 8 will allow that

Author:

John Bauer

Constructor Summary

Constructors

Constructor and Description
ParserGrammar()

Method Summary

Methods

Modifier and Type	Method and Description
abstract Tree	apply(List<? extends HasWord> words) A convenience method which wraps the ParserQuery and returns a Tree
abstract String[]	defaultCoreNLPFlags() Returns a set of options which should be set by default when used in corenlp.
abstract List<Eval>	getExtraEvals() Returns a list of extra Eval objects to use when scoring the parser.
abstract Options	getOp()
abstract List<ParserQueryEval>	getParserQueryEvals() Return a list of Eval-style objects which care about the whole ParserQuery, not just the finished tree
abstract TreebankLangParserParams	getTLPParams()
static ParserGrammar	loadModel(String path, String... extraFlags)
abstract ParserQuery	parserQuery()
abstract boolean	requiresTags() The model requires text to be pretagged
abstract void	setOptionFlags(String... flags)
abstract TreebankLanguagePack	treebankLanguagePack()

Methods inherited from class java.lang.Object

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

Constructor Detail

ParserGrammar

public ParserGrammar()

Method Detail

parserQuery

public abstract ParserQuery parserQuery()

apply

public abstract Tree apply(List<? extends HasWord> words)

A convenience method which wraps the ParserQuery and returns a Tree

Specified by:

apply in interface Function<List<? extends HasWord>,Tree>

Parameters:

words - The function's argument

Returns:

The function's evaluated value

getExtraEvals

public abstract List<Eval> getExtraEvals()

Returns a list of extra Eval objects to use when scoring the parser.

getParserQueryEvals

public abstract List<ParserQueryEval> getParserQueryEvals()

Return a list of Eval-style objects which care about the whole ParserQuery, not just the finished tree

getOp

public abstract Options getOp()

getTLPParams

public abstract TreebankLangParserParams getTLPParams()

treebankLanguagePack

public abstract TreebankLanguagePack treebankLanguagePack()

defaultCoreNLPFlags

public abstract String[] defaultCoreNLPFlags()

Returns a set of options which should be set by default when used in corenlp. For example, the English PCFG/RNN models want -retainTmpSubcategories, and the ShiftReduceParser models may want -beamSize 4 depending on how they were trained.
TODO: right now completely hardcoded, should be settable as a training time option

setOptionFlags

public abstract void setOptionFlags(String... flags)

requiresTags

public abstract boolean requiresTags()

The model requires text to be pretagged

loadModel

public static ParserGrammar loadModel(String path,
                      String... extraFlags)