edu.stanford.nlp.ie.util

Class RelationTriple

java.lang.Object

edu.stanford.nlp.ie.util.RelationTriple

Direct Known Subclasses:

RelationTriple.WithTree

public class RelationTriple
extends Object

A (subject, relation, object) triple; e.g., as used in the KBP challenges or in OpenIE systems.

Author:

Gabor Angeli

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	RelationTriple.WithTree A RelationTriple, but with the tree saved as well.

Field Summary

Fields

Modifier and Type	Field and Description
List<CoreLabel>	object The object (third argument) of this triple
List<CoreLabel>	relation The relation (second argument) of this triple
List<CoreLabel>	subject The subject (first argument) of this triple

Constructor Summary

Constructors

Constructor and Description
RelationTriple(List<CoreLabel> subject, List<CoreLabel> relation, List<CoreLabel> object) Create a new triple with known values for the subject, relation, and object.

Method Summary

Modifier and Type	Method and Description
Optional<SemanticGraph>	asDependencyTree() An optional method, returning the dependency tree this triple was extracted from
List<CoreLabel>	asSentence() Return the given relation triple as a flat sentence
boolean	equals(Object o)
int	hashCode()
String	objectGloss() The object of this relation triple, as a String
String	relationGloss() The relation of this relation triple, as a String
static Optional<RelationTriple>	segment(SemanticGraph parse) Try to segment this sentence as a relation triple.
String	subjectGloss() The subject of this relation triple, as a String
String	toString() Print a human-readable description of this relation triple, as a tab-separated line

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

subject

public final List<CoreLabel> subject

The subject (first argument) of this triple

relation

public final List<CoreLabel> relation

The relation (second argument) of this triple

object

public final List<CoreLabel> object

The object (third argument) of this triple

Constructor Detail

RelationTriple

public RelationTriple(List<CoreLabel> subject,
                      List<CoreLabel> relation,
                      List<CoreLabel> object)

Create a new triple with known values for the subject, relation, and object. For example, "(cats, play with, yarn)"

Parameters:

subject - The subject of this triple; e.g., "cats".

relation - The relation of this triple; e.g., "play with".

object - The object of this triple; e.g., "yarn".

Method Detail

subjectGloss

public String subjectGloss()

The subject of this relation triple, as a String

objectGloss

public String objectGloss()

The object of this relation triple, as a String

relationGloss

public String relationGloss()

The relation of this relation triple, as a String

asDependencyTree

public Optional<SemanticGraph> asDependencyTree()

An optional method, returning the dependency tree this triple was extracted from

asSentence

public List<CoreLabel> asSentence()

Return the given relation triple as a flat sentence

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Print a human-readable description of this relation triple, as a tab-separated line

Overrides:

toString in class Object

segment

public static Optional<RelationTriple> segment(SemanticGraph parse)

Try to segment this sentence as a relation triple. This sentence must already match one of a few strict patterns for a valid OpenIE extraction. If it does not, then no relation triple is created. That is, this is not a relation extractor; it is just a utility to segment what is already a (subject, relation, object) triple into these three parts.

Parameters:

parse - The sentence to process, as a dependency tree.

Returns:

A relation triple, if this sentence matches one of the patterns of a valid relation triple.