edu.stanford.nlp.parser.shiftreduce

Class ShiftReduceParser

java.lang.Object

edu.stanford.nlp.parser.common.ParserGrammar

edu.stanford.nlp.parser.shiftreduce.ShiftReduceParser

All Implemented Interfaces:

Serializable, java.util.function.Function<List<? extends HasWord>,Tree>

public class ShiftReduceParser
extends ParserGrammar
implements Serializable

A shift-reduce constituency parser. Overview and description available at http://nlp.stanford.edu/software/srparser.shtml

Author:

John Bauer

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ShiftReduceParser(ShiftReduceOptions op)
ShiftReduceParser(ShiftReduceOptions op, BaseModel model)

Method Summary

Modifier and Type	Method and Description
static List<Tree>	binarizeTreebank(Treebank treebank, Options op)
static ShiftReduceOptions	buildTrainingOptions(String tlppClass, String[] args)
String[]	defaultCoreNLPFlags() Returns a set of options which should be set by default when used in corenlp.
static Set<String>	findKnownStates(List<Tree> binarizedTrees)
static void	findKnownStates(Tree tree, Set<String> knownStates)
List<Eval>	getExtraEvals() TODO: add an eval which measures transition accuracy?
Options	getOp()
List<ParserQueryEval>	getParserQueryEvals() Return a list of Eval-style objects which care about the whole ParserQuery, not just the finished tree
TreebankLangParserParams	getTLPParams()
static State	initialStateFromGoldTagTree(Tree tree)
static State	initialStateFromTaggedSentence(List<? extends HasWord> words)
Set<String>	knownStates() Return an unmodifiableSet containing the known states (including binarization)
static ShiftReduceParser	loadModel(String path, String... extraFlags)
static void	main(String[] args)
Tree	parse(List<? extends HasWord> sentence) Parses the list of HasWord.
Tree	parse(String sentence) Will parse the text in sentence as if it represented a single sentence by first processing it with a tokenizer.
ParserQuery	parserQuery()
List<Tree>	readBinarizedTreebank(String treebankPath, FileFilter treebankFilter)
Treebank	readTreebank(String treebankPath, FileFilter treebankFilter)
static void	redoTags(List<Tree> trees, Tagger tagger, int nThreads)
static void	redoTags(Tree tree, Tagger tagger)
boolean	requiresTags() The model requires text to be pretagged
void	saveModel(String path)
void	setOptionFlags(String... flags)
Set<String>	tagSet() Return the Set of POS tags used in the model.
TreebankLanguagePack	treebankLanguagePack()

Methods inherited from class edu.stanford.nlp.parser.common.ParserGrammar

apply, lemmatize, lemmatize, loadTagger, tokenize

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.function.Function

andThen, compose, identity

Constructor Detail

ShiftReduceParser

public ShiftReduceParser(ShiftReduceOptions op)

ShiftReduceParser

public ShiftReduceParser(ShiftReduceOptions op,
                         BaseModel model)

Method Detail

getOp

public Options getOp()

Specified by:

getOp in class ParserGrammar

getTLPParams

public TreebankLangParserParams getTLPParams()

Specified by:

getTLPParams in class ParserGrammar

treebankLanguagePack

public TreebankLanguagePack treebankLanguagePack()

Specified by:

treebankLanguagePack in class ParserGrammar

defaultCoreNLPFlags

public String[] defaultCoreNLPFlags()

Description copied from class: ParserGrammar

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

Specified by:

defaultCoreNLPFlags in class ParserGrammar

knownStates

public Set<String> knownStates()

Return an unmodifiableSet containing the known states (including binarization)

tagSet

public Set<String> tagSet()

Return the Set of POS tags used in the model.

requiresTags

public boolean requiresTags()

Description copied from class: ParserGrammar

The model requires text to be pretagged

Specified by:

requiresTags in class ParserGrammar

parserQuery

public ParserQuery parserQuery()

Specified by:

parserQuery in class ParserGrammar

parse

public Tree parse(String sentence)

Description copied from class: ParserGrammar

Will parse the text in sentence as if it represented a single sentence by first processing it with a tokenizer.

Overrides:

parse in class ParserGrammar

parse

public Tree parse(List<? extends HasWord> sentence)

Description copied from class: ParserGrammar

Parses the list of HasWord. If the parse fails for some reason, an X tree is returned instead of barfing.

Specified by:

parse in class ParserGrammar

Parameters:

sentence - The input sentence (a List of words)

Returns:

A Tree that is the parse tree for the sentence. If the parser fails, a new Tree is synthesized which attaches all words to the root.

getExtraEvals

public List<Eval> getExtraEvals()

TODO: add an eval which measures transition accuracy?

Specified by:

getExtraEvals in class ParserGrammar

getParserQueryEvals

public List<ParserQueryEval> getParserQueryEvals()

Description copied from class: ParserGrammar

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

Specified by:

getParserQueryEvals in class ParserGrammar

initialStateFromGoldTagTree

public static State initialStateFromGoldTagTree(Tree tree)

initialStateFromTaggedSentence

public static State initialStateFromTaggedSentence(List<? extends HasWord> words)

buildTrainingOptions

public static ShiftReduceOptions buildTrainingOptions(String tlppClass,
                                                      String[] args)

readTreebank

public Treebank readTreebank(String treebankPath,
                             FileFilter treebankFilter)

readBinarizedTreebank

public List<Tree> readBinarizedTreebank(String treebankPath,
                                        FileFilter treebankFilter)

binarizeTreebank

public static List<Tree> binarizeTreebank(Treebank treebank,
                                          Options op)

findKnownStates

public static Set<String> findKnownStates(List<Tree> binarizedTrees)

findKnownStates

public static void findKnownStates(Tree tree,
                                   Set<String> knownStates)

redoTags

public static void redoTags(Tree tree,
                            Tagger tagger)

redoTags

public static void redoTags(List<Tree> trees,
                            Tagger tagger,
                            int nThreads)

setOptionFlags

public void setOptionFlags(String... flags)

Specified by:

setOptionFlags in class ParserGrammar

loadModel

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

saveModel

public void saveModel(String path)

main

public static void main(String[] args)