edu.stanford.nlp.ie.machinereading.structure

Class RelationMention

java.lang.Object

edu.stanford.nlp.ie.machinereading.structure.ExtractionObject

edu.stanford.nlp.ie.machinereading.structure.RelationMention

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

EventMention

public class RelationMention
extends ExtractionObject

Each relation has a type and set of arguments

Author:

Andrey Gusev, Mihai, David McClosky

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected List<String>	argNames List of argument names in this relation
protected List<ExtractionObject>	args List of arguments in this relation If unnamed, arguments MUST be stored in semantic order, e.g., ARG0 must be a person in a employed-by relation
static Logger	logger
protected String	signature A signature for a given relation mention, e.g., a concatenation of type and argument strings This is used in KBP, where we merge all RelationMentions corresponding to the same abstract relation
static String	UNRELATED

Fields inherited from class edu.stanford.nlp.ie.machinereading.structure.ExtractionObject

attributeMap, extentTokenSpan, objectId, sentence, subType, type, typeProbabilities

Constructor Summary

Constructors

Constructor and Description
RelationMention(String objectId, CoreMap sentence, Span span, String type, String subtype, ExtractionObject... args)
RelationMention(String objectId, CoreMap sentence, Span span, String type, String subtype, List<ExtractionObject> args)
RelationMention(String objectId, CoreMap sentence, Span span, String type, String subtype, List<ExtractionObject> args, List<String> argNames)

Method Summary

Modifier and Type	Method and Description
void	addArg(ExtractionObject a)
boolean	argsMatch(ExtractionObject... inputArgs)
boolean	argsMatch(List<ExtractionObject> inputArgs) Verifies if the two sets of arguments match
boolean	argsMatch(RelationMention rel)
static RelationMention	createUnrelatedRelation(RelationMentionFactory factory, ExtractionObject... args)
boolean	equals(Object o)
static Collection<RelationMention>	filterUnrelatedRelations(Collection<RelationMention> relationMentions)
ExtractionObject	getArg(int argpos)
List<String>	getArgNames()
List<ExtractionObject>	getArgs()
List<EntityMention>	getEntityMentionArgs() Fetches the arguments of this relation that are entity mentions
int	getFirstSyntacticHeadPosition() Find the left-most position of an argument's syntactic head
int	getLastSyntacticHeadPosition() Find the right-most position of an argument's syntactic head
String	getSignature()
int	hashCode()
boolean	isNegativeRelation()
static boolean	isUnrelatedLabel(String label)
static String	makeUniqueId() Creates a new unique id for a relation mention
boolean	printableObject(double beam)
void	removeArgument(ExtractionObject argToRemove, boolean removeParent)
void	removeArguments(Set<ExtractionObject> argsToRemove, boolean removeParent)
boolean	replaceGoldArgsWithPredicted(List<EntityMention> predictedMentions) Replaces the arguments of this relations with equivalent mentions from the predictedMentions list This works only for arguments that are EntityMention!
void	setArgNames(List<String> argNames)
void	setArgs(List<ExtractionObject> args)
void	setSignature(String s)
String	toString()

Methods inherited from class edu.stanford.nlp.ie.machinereading.structure.ExtractionObject

attributeMap, concatenateTypes, getDocumentId, getExtent, getExtentString, getExtentTokenEnd, getExtentTokenStart, getFullValue, getObjectId, getSentence, getSpan, getSubType, getType, getTypeProbabilities, getValue, printableObject, setExtent, setSentence, setType, setTypeProbabilities, sortByExtent

Methods inherited from class java.lang.Object

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

Field Detail

logger

public static final Logger logger

UNRELATED

public static final String UNRELATED

See Also:

Constant Field Values

argNames

protected List<String> argNames

List of argument names in this relation

args

protected List<ExtractionObject> args

List of arguments in this relation If unnamed, arguments MUST be stored in semantic order, e.g., ARG0 must be a person in a employed-by relation

signature

protected String signature

A signature for a given relation mention, e.g., a concatenation of type and argument strings This is used in KBP, where we merge all RelationMentions corresponding to the same abstract relation

Constructor Detail

RelationMention

public RelationMention(String objectId,
                       CoreMap sentence,
                       Span span,
                       String type,
                       String subtype,
                       List<ExtractionObject> args)

RelationMention

public RelationMention(String objectId,
                       CoreMap sentence,
                       Span span,
                       String type,
                       String subtype,
                       List<ExtractionObject> args,
                       List<String> argNames)

RelationMention

public RelationMention(String objectId,
                       CoreMap sentence,
                       Span span,
                       String type,
                       String subtype,
                       ExtractionObject... args)

Method Detail

argsMatch

public boolean argsMatch(RelationMention rel)

argsMatch

public boolean argsMatch(ExtractionObject... inputArgs)

argsMatch

public boolean argsMatch(List<ExtractionObject> inputArgs)

Verifies if the two sets of arguments match

Parameters:

inputArgs - List of arguments

getArgs

public List<ExtractionObject> getArgs()

setArgs

public void setArgs(List<ExtractionObject> args)

getEntityMentionArgs

public List<EntityMention> getEntityMentionArgs()

Fetches the arguments of this relation that are entity mentions

Returns:

List of entity-mention args sorted in semantic order

getArg

public ExtractionObject getArg(int argpos)

getArgNames

public List<String> getArgNames()

setArgNames

public void setArgNames(List<String> argNames)

addArg

public void addArg(ExtractionObject a)

isNegativeRelation

public boolean isNegativeRelation()

getFirstSyntacticHeadPosition

public int getFirstSyntacticHeadPosition()

Find the left-most position of an argument's syntactic head

getLastSyntacticHeadPosition

public int getLastSyntacticHeadPosition()

Find the right-most position of an argument's syntactic head

toString

public String toString()

Overrides:

toString in class Object

replaceGoldArgsWithPredicted

public boolean replaceGoldArgsWithPredicted(List<EntityMention> predictedMentions)

Replaces the arguments of this relations with equivalent mentions from the predictedMentions list This works only for arguments that are EntityMention!

Parameters:

predictedMentions -

removeArgument

public void removeArgument(ExtractionObject argToRemove,
                           boolean removeParent)

removeArguments

public void removeArguments(Set<ExtractionObject> argsToRemove,
                            boolean removeParent)

printableObject

public boolean printableObject(double beam)

setSignature

public void setSignature(String s)

getSignature

public String getSignature()

filterUnrelatedRelations

public static Collection<RelationMention> filterUnrelatedRelations(Collection<RelationMention> relationMentions)

makeUniqueId

public static String makeUniqueId()

Creates a new unique id for a relation mention

Returns:

the new id

createUnrelatedRelation

public static RelationMention createUnrelatedRelation(RelationMentionFactory factory,
                                                      ExtractionObject... args)

isUnrelatedLabel

public static boolean isUnrelatedLabel(String label)

equals

public boolean equals(Object o)

Overrides:

equals in class ExtractionObject

hashCode

public int hashCode()

Overrides:

hashCode in class Object