edu.stanford.nlp.semgraph

Class SemanticGraphFactory

java.lang.Object

edu.stanford.nlp.semgraph.SemanticGraphFactory

public class SemanticGraphFactory
extends Object

Refactoring of static makers of SemanticGraphs in order to simplify the SemanticGraph class.

Author:

rafferty

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SemanticGraphFactory.Mode

Method Summary

Modifier and Type	Method and Description
static SemanticGraph	deepCopyFromGraphs(List<SemanticGraph> graphs, List<Integer> lengths) Like makeFromGraphs, but it makes a deep copy of the graphs and renumbers the index words.
static SemanticGraph	duplicateKeepNodes(SemanticGraph sg) This creates a new graph based off the given, but uses the existing nodes objects.
static SemanticGraph	generateCCProcessedDependencies(GrammaticalStructure gs) Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.
static SemanticGraph	generateCCProcessedDependencies(GrammaticalStructure gs, GrammaticalStructure.Extras extras) Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.
static SemanticGraph	generateCCProcessedDependencies(Tree tree) Deprecated. Use generateEnhancedDependencies(Tree) or generateEnhancedPlusPlusDependencies(Tree) instead.
static SemanticGraph	generateCollapsedDependencies(GrammaticalStructure gs) Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.
static SemanticGraph	generateCollapsedDependencies(GrammaticalStructure gs, GrammaticalStructure.Extras extras) Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.
static SemanticGraph	generateCollapsedDependencies(Tree tree) Deprecated. Use generateEnhancedDependencies(Tree) or generateEnhancedPlusPlusDependencies(Tree) instead.
static SemanticGraph	generateEnhancedDependencies(GrammaticalStructure gs) Produces an enhanced dependencies SemanticGraph.
static SemanticGraph	generateEnhancedDependencies(Tree tree) Produces an enhanced dependencies SemanticGraph.
static SemanticGraph	generateEnhancedPlusPlusDependencies(GrammaticalStructure gs) Produces an enhanced++ dependencies SemanticGraph.
static SemanticGraph	generateEnhancedPlusPlusDependencies(Tree tree) Produces an enhanced++ dependencies SemanticGraph.
static SemanticGraph	generateUncollapsedDependencies(GrammaticalStructure gs) Produces an Uncollapsed (basic) SemanticGraph.
static SemanticGraph	generateUncollapsedDependencies(GrammaticalStructure gs, GrammaticalStructure.Extras extras) Deprecated. Use generateUncollapsedDependencies(GrammaticalStructure) instead.
static SemanticGraph	generateUncollapsedDependencies(Tree tree) Produces an Uncollapsed (basic) SemanticGraph.
static SemanticGraph	makeFromEdges(Iterable<SemanticGraphEdge> edges) Given a list of edges, attempts to create and return a rooted SemanticGraph.
static SemanticGraph	makeFromGraphs(Collection<SemanticGraph> sgList) Given a list of graphs, constructs a new graph combined from the collection of graphs.
static SemanticGraph	makeFromTree(GrammaticalStructure structure)
static SemanticGraph	makeFromTree(GrammaticalStructure tree, SemanticGraphFactory.Mode mode, boolean includeExtras, Predicate<TypedDependency> filter) Deprecated.
static SemanticGraph	makeFromTree(GrammaticalStructure gs, SemanticGraphFactory.Mode mode, GrammaticalStructure.Extras includeExtras, Predicate<TypedDependency> filter)
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, boolean includeExtras) Deprecated.
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, boolean includeExtras, Predicate<TypedDependency> filter) Deprecated.
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, GrammaticalStructure.Extras includeExtras)
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, GrammaticalStructure.Extras includeExtras, Predicate<TypedDependency> filter)
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, GrammaticalStructure.Extras includeExtras, Predicate<TypedDependency> filter, boolean originalDependencies)
static SemanticGraph	makeFromTree(Tree tree, SemanticGraphFactory.Mode mode, GrammaticalStructure.Extras includeExtras, Predicate<TypedDependency> filter, boolean originalDependencies, boolean includePunctuationDependencies) Returns a new SemanticGraph constructed from a given Tree with given options.
static SemanticGraph	makeFromVertices(SemanticGraph sg, Collection<IndexedWord> nodes) Given a set of vertices, and the source graph they are drawn from, create a path composed of the minimum paths between the vertices.

Methods inherited from class java.lang.Object

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

Method Detail

generateUncollapsedDependencies

public static SemanticGraph generateUncollapsedDependencies(Tree tree)

Produces an Uncollapsed (basic) SemanticGraph.

generateCollapsedDependencies

@Deprecated
public static SemanticGraph generateCollapsedDependencies(Tree tree)

Deprecated. Use generateEnhancedDependencies(Tree) or generateEnhancedPlusPlusDependencies(Tree) instead.

Produces a Collapsed SemanticGraph.

generateCCProcessedDependencies

@Deprecated
public static SemanticGraph generateCCProcessedDependencies(Tree tree)

Deprecated. Use generateEnhancedDependencies(Tree) or generateEnhancedPlusPlusDependencies(Tree) instead.

Produces a CCProcessed SemanticGraph.

generateEnhancedDependencies

public static SemanticGraph generateEnhancedDependencies(Tree tree)

Produces an enhanced dependencies SemanticGraph.

generateEnhancedPlusPlusDependencies

public static SemanticGraph generateEnhancedPlusPlusDependencies(Tree tree)

Produces an enhanced++ dependencies SemanticGraph.

generateUncollapsedDependencies

public static SemanticGraph generateUncollapsedDependencies(GrammaticalStructure gs)

Produces an Uncollapsed (basic) SemanticGraph.

generateCollapsedDependencies

@Deprecated
public static SemanticGraph generateCollapsedDependencies(GrammaticalStructure gs)

Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.

Produces a Collapsed SemanticGraph.

generateCCProcessedDependencies

@Deprecated
public static SemanticGraph generateCCProcessedDependencies(GrammaticalStructure gs)

Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.

Produces a CCProcessed SemanticGraph.

generateEnhancedDependencies

public static SemanticGraph generateEnhancedDependencies(GrammaticalStructure gs)

Produces an enhanced dependencies SemanticGraph.

generateEnhancedPlusPlusDependencies

public static SemanticGraph generateEnhancedPlusPlusDependencies(GrammaticalStructure gs)

Produces an enhanced++ dependencies SemanticGraph.

generateUncollapsedDependencies

@Deprecated
public static SemanticGraph generateUncollapsedDependencies(GrammaticalStructure gs,
                                                                        GrammaticalStructure.Extras extras)

Deprecated. Use generateUncollapsedDependencies(GrammaticalStructure) instead.

Produces an Uncollapsed (basic) SemanticGraph. The extras parameter has no effect if gs is an instance of UniversalEnglishGrammaticalStructure.

generateCollapsedDependencies

@Deprecated
public static SemanticGraph generateCollapsedDependencies(GrammaticalStructure gs,
                                                                      GrammaticalStructure.Extras extras)

Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.

Produces a Collapsed SemanticGraph with optional extras.

generateCCProcessedDependencies

@Deprecated
public static SemanticGraph generateCCProcessedDependencies(GrammaticalStructure gs,
                                                                        GrammaticalStructure.Extras extras)

Deprecated. Use generateEnhancedDependencies(GrammaticalStructure) or generateEnhancedPlusPlusDependencies(GrammaticalStructure) instead.

Produces a CCProcessed SemanticGraph with optional extras.

makeFromTree

public static SemanticGraph makeFromTree(Tree tree,
                                         SemanticGraphFactory.Mode mode,
                                         GrammaticalStructure.Extras includeExtras,
                                         Predicate<TypedDependency> filter,
                                         boolean originalDependencies)

See Also:

#makeFromTree(Tree, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

public static SemanticGraph makeFromTree(Tree tree,
                                         SemanticGraphFactory.Mode mode,
                                         GrammaticalStructure.Extras includeExtras,
                                         Predicate<TypedDependency> filter,
                                         boolean originalDependencies,
                                         boolean includePunctuationDependencies)

Returns a new SemanticGraph constructed from a given Tree with given options. This factory method is intended to replace a profusion of highly similar factory methods, such as typedDependencies(), typedDependenciesCollapsed(), allTypedDependencies(), allTypedDependenciesCollapsed(), etc. For a fuller explanation of the meaning of the boolean arguments, see GrammaticalStructure.

Parameters:

tree - A tree representing a phrase structure parse

includeExtras - Whether to include extra dependencies, which may result in a non-tree

filter - A filter to exclude certain dependencies; ignored if null

originalDependencies - generate original Stanford dependencies instead of new Universal Dependencies

Returns:

A SemanticGraph

makeFromTree

public static SemanticGraph makeFromTree(GrammaticalStructure gs,
                                         SemanticGraphFactory.Mode mode,
                                         GrammaticalStructure.Extras includeExtras,
                                         Predicate<TypedDependency> filter)

makeFromTree

@Deprecated
public static SemanticGraph makeFromTree(GrammaticalStructure tree,
                                                     SemanticGraphFactory.Mode mode,
                                                     boolean includeExtras,
                                                     Predicate<TypedDependency> filter)

Deprecated.

See Also:

#makeFromTree(GrammaticalStructure, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

public static SemanticGraph makeFromTree(GrammaticalStructure structure)

See Also:

#makeFromTree(GrammaticalStructure, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

public static SemanticGraph makeFromTree(Tree tree,
                                         SemanticGraphFactory.Mode mode,
                                         GrammaticalStructure.Extras includeExtras,
                                         Predicate<TypedDependency> filter)

See Also:

#makeFromTree(Tree, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

@Deprecated
public static SemanticGraph makeFromTree(Tree tree,
                                                     SemanticGraphFactory.Mode mode,
                                                     boolean includeExtras,
                                                     Predicate<TypedDependency> filter)

Deprecated.

See Also:

#makeFromTree(Tree, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

public static SemanticGraph makeFromTree(Tree tree,
                                         SemanticGraphFactory.Mode mode,
                                         GrammaticalStructure.Extras includeExtras)

See Also:

#makeFromTree(Tree, Mode, GrammaticalStructure.Extras, Predicate

makeFromTree

@Deprecated
public static SemanticGraph makeFromTree(Tree tree,
                                                     SemanticGraphFactory.Mode mode,
                                                     boolean includeExtras)

Deprecated.

See Also:

makeFromTree(Tree, Mode, GrammaticalStructure.Extras)

makeFromEdges

public static SemanticGraph makeFromEdges(Iterable<SemanticGraphEdge> edges)

Given a list of edges, attempts to create and return a rooted SemanticGraph.

TODO: throw Exceptions, or flag warnings on conditions for concern (no root, etc)

makeFromVertices

public static SemanticGraph makeFromVertices(SemanticGraph sg,
                                             Collection<IndexedWord> nodes)

Given a set of vertices, and the source graph they are drawn from, create a path composed of the minimum paths between the vertices. i.e. this is a simple brain-dead attempt at getting something approximating a minimum spanning graph. NOTE: the hope is the vertices will already be contiguous, but facilities are added just in case for adding additional nodes.

duplicateKeepNodes

public static SemanticGraph duplicateKeepNodes(SemanticGraph sg)

This creates a new graph based off the given, but uses the existing nodes objects.

makeFromGraphs

public static SemanticGraph makeFromGraphs(Collection<SemanticGraph> sgList)

Given a list of graphs, constructs a new graph combined from the collection of graphs. Original vertices are used, edges are copied. Graphs are ordered by the sentence index and index of the original vertices. Intent is to create a "mega graph" similar to the graphs used in the RTE problem.
This method only works if the indexed words have different sentence ids, as otherwise the maps used will confuse several of the IndexedWords.

deepCopyFromGraphs

public static SemanticGraph deepCopyFromGraphs(List<SemanticGraph> graphs,
                                               List<Integer> lengths)

Like makeFromGraphs, but it makes a deep copy of the graphs and renumbers the index words.
lengths must be a vector containing the number of tokens in each sentence. This is used to reindex the tokens.