edu.stanford.nlp.coref.data

Class Mention

java.lang.Object

edu.stanford.nlp.coref.data.Mention

All Implemented Interfaces:

CoreAnnotation<Mention>, TypesafeMap.Key<Mention>, java.io.Serializable

public class Mention
extends java.lang.Object
implements CoreAnnotation<Mention>, java.io.Serializable

One mention for the SieveCoreferenceSystem.

Author:

Jenny Finkel, Karthik Raghunathan, Heeyoung Lee, Marta Recasens

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
Dictionaries.Animacy	animacy
IntCounter<java.lang.Integer>	antecedentOrdering
java.util.Set<Mention>	appositions Set of other mentions in the same sentence that are syntactic appositions to this
SemanticGraph	basicDependency
java.util.Set<Mention>	belongToLists Set of other mentions in the same sentence that I am a member of
Tree	contextParseTree
int	corefClusterID
java.util.Set<java.lang.String>	dependents
IndexedWord	dependingVerb
int	endIndex
SemanticGraph	enhancedDependency
Dictionaries.Gender	gender
boolean	generic
int	goldCorefClusterID
boolean	hasTwin
int	headIndex
IndexedWord	headIndexedWord
java.lang.String	headString
CoreLabel	headWord
boolean	isDirectObject
boolean	isIndirectObject
boolean	isPrepositionObject
boolean	isSingleton
boolean	isSubject
java.util.Set<Mention>	listMembers Set of other mentions in the same sentence that below to this list
int	mentionID
int	mentionNum
Tree	mentionSubTree
Dictionaries.MentionType	mentionType
java.lang.String	nerString
Dictionaries.Number	number
int	originalRef
java.util.List<CoreLabel>	originalSpan
int	paragraph
Dictionaries.Person	person
java.util.Set<Mention>	predicateNominatives
java.util.List<java.lang.String>	preprocessedTerms
java.util.Set<Mention>	relativePronouns
java.util.List<CoreLabel>	sentenceWords
int	sentNum
SpeakerInfo	speakerInfo
int	startIndex
java.lang.Object	synsets
int	utter

Constructor Summary

Constructors

Constructor and Description
Mention()
Mention(int mentionID, int startIndex, int endIndex, java.util.List<CoreLabel> sentenceWords, SemanticGraph basicDependency, SemanticGraph enhancedDependency)
Mention(int mentionID, int startIndex, int endIndex, java.util.List<CoreLabel> sentenceWords, SemanticGraph basicDependency, SemanticGraph enhancedDependency, java.util.List<CoreLabel> mentionSpan)
Mention(int mentionID, int startIndex, int endIndex, java.util.List<CoreLabel> sentenceWords, SemanticGraph basicDependency, SemanticGraph enhancedDependency, java.util.List<CoreLabel> mentionSpan, Tree mentionTree)

Method Summary

Modifier and Type	Method and Description
void	addApposition(Mention m) Find apposition
void	addBelongsToList(Mention m)
void	addListMember(Mention m)
void	addPredicateNominatives(Mention m) Find predicate nominatives
void	addRelativePronoun(Mention m) Find relative pronouns
boolean	animaciesAgree(Mention m)
boolean	animaciesAgree(Mention m, boolean strict)
boolean	appearEarlierThan(Mention m) Find which mention appears first in a document
boolean	attributesAgree(Mention potentialAntecedent, Dictionaries dict) Detects if the mention and candidate antecedent agree on all attributes respectively.
static java.lang.String	buildQueryText(java.util.List<java.lang.String> terms)
boolean	entityTypesAgree(Mention m, Dictionaries dict)
boolean	entityTypesAgree(Mention m, Dictionaries dict, boolean strict)
boolean	equals(java.lang.Object obj)
boolean	gendersAgree(Mention m)
boolean	gendersAgree(Mention m, boolean strict)
java.util.List<java.lang.String>	getContext()
int	getCoordination()
int	getModal(Dictionaries dict)
int	getModifiers(Dictionaries dict)
int	getNegation(Dictionaries dict)
java.lang.String	getPattern()
java.lang.String	getPattern(java.util.List<AbstractCoreLabel> pTokens)
java.lang.String	getPosition()
java.util.ArrayList<java.util.ArrayList<IndexedWord>>	getPostmodifiers()
java.util.List<java.lang.String>	getPremodifierContext()
java.util.ArrayList<java.util.ArrayList<IndexedWord>>	getPremodifiers()
java.lang.String	getQuantification(Dictionaries dict)
java.lang.String	getRelation()
int	getReportEmbedding(Dictionaries dict)
java.util.ArrayList<java.lang.String>	getSingletonFeatures(Dictionaries dict) Returns the features used by the singleton predictor (logistic classifier) to decide whether the mention belongs to a singleton entity
java.lang.String[]	getSplitPattern()
java.lang.Class<Mention>	getType() Returns the type associated with this annotation.
int	hashCode()
boolean	headsAgree(Mention m)
boolean	includedIn(Mention m) Verifies if this mention's tree is dominated by the tree of the given mention
boolean	insideIn(Mention m) Returns true if this mention is contained inside m.
boolean	isApposition(Mention m) Check apposition
boolean	isCoordinated()
boolean	isDemonym(Mention m, Dictionaries dict)
boolean	isListMemberOf(Mention m) Check list member? True if this mention is inside the other mention and the other mention is a list
boolean	isMemberOfSameList(Mention m)
boolean	isPredicateNominatives(Mention m) Check predicate nominatives
boolean	isPronominal()
boolean	isRelativePronoun(Mention m) Check relative pronouns
boolean	isRoleAppositive(Mention m, Dictionaries dict)
protected boolean	isTheCommonNoun()
java.lang.String	longestNNPEndsWithHead()
java.lang.String	lowercaseNormalizedSpanString()
java.lang.String	lowestNPIncludesHead()
boolean	moreRepresentativeThan(Mention m)
java.lang.String	nerName()
java.util.List<CoreLabel>	nerTokens()
boolean	numbersAgree(Mention m)
java.util.List<java.lang.String>	preprocessSearchTerm()
void	process(Dictionaries dict, Semantics semantics) Set attributes of a mention: head string, mention type, NER label, Number, Gender, Animacy
void	process(Dictionaries dict, Semantics semantics, LogisticClassifier<java.lang.String,java.lang.String> singletonPredictor)
static java.lang.String	removeParenthesis(java.lang.String text)
java.lang.String	removePhraseAfterHead() Remove any clause after headword
boolean	sameSentence(Mention m)
protected void	setNumber(Dictionaries dict)
java.lang.String	spanToString()
java.lang.String	stringWithoutArticle(java.lang.String str)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

mentionType

public Dictionaries.MentionType mentionType

number

public Dictionaries.Number number

gender

public Dictionaries.Gender gender

animacy

public Dictionaries.Animacy animacy

person

public Dictionaries.Person person

headString

public java.lang.String headString

nerString

public java.lang.String nerString

startIndex

public int startIndex

endIndex

public int endIndex

headIndex

public int headIndex

mentionID

public int mentionID

originalRef

public int originalRef

headIndexedWord

public IndexedWord headIndexedWord

goldCorefClusterID

public int goldCorefClusterID

corefClusterID

public int corefClusterID

mentionNum

public int mentionNum

sentNum

public int sentNum

utter

public int utter

paragraph

public int paragraph

isSubject

public boolean isSubject

isDirectObject

public boolean isDirectObject

isIndirectObject

public boolean isIndirectObject

isPrepositionObject

public boolean isPrepositionObject

dependingVerb

public IndexedWord dependingVerb

hasTwin

public boolean hasTwin

generic

public boolean generic

isSingleton

public boolean isSingleton

sentenceWords

public java.util.List<CoreLabel> sentenceWords

originalSpan

public java.util.List<CoreLabel> originalSpan

mentionSubTree

public Tree mentionSubTree

contextParseTree

public Tree contextParseTree

headWord

public CoreLabel headWord

basicDependency

public SemanticGraph basicDependency

enhancedDependency

public SemanticGraph enhancedDependency

dependents

public java.util.Set<java.lang.String> dependents

preprocessedTerms

public java.util.List<java.lang.String> preprocessedTerms

synsets

public java.lang.Object synsets

appositions

public java.util.Set<Mention> appositions

Set of other mentions in the same sentence that are syntactic appositions to this

predicateNominatives

public java.util.Set<Mention> predicateNominatives

relativePronouns

public java.util.Set<Mention> relativePronouns

listMembers

public java.util.Set<Mention> listMembers

Set of other mentions in the same sentence that below to this list

belongToLists

public java.util.Set<Mention> belongToLists

Set of other mentions in the same sentence that I am a member of

speakerInfo

public SpeakerInfo speakerInfo

antecedentOrdering

public IntCounter<java.lang.Integer> antecedentOrdering

Constructor Detail

Mention

public Mention()

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               java.util.List<CoreLabel> sentenceWords,
               SemanticGraph basicDependency,
               SemanticGraph enhancedDependency)

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               java.util.List<CoreLabel> sentenceWords,
               SemanticGraph basicDependency,
               SemanticGraph enhancedDependency,
               java.util.List<CoreLabel> mentionSpan)

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               java.util.List<CoreLabel> sentenceWords,
               SemanticGraph basicDependency,
               SemanticGraph enhancedDependency,
               java.util.List<CoreLabel> mentionSpan,
               Tree mentionTree)

Method Detail

getType

public java.lang.Class<Mention> getType()

Description copied from interface: CoreAnnotation

Returns the type associated with this annotation. This method must return the same class type as its value type parameter. It feels like one should be able to get away without this method, but because Java erases the generic type signature, that info disappears at runtime.

Specified by:

getType in interface CoreAnnotation<Mention>

isPronominal

public boolean isPronominal()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

spanToString

public java.lang.String spanToString()

lowercaseNormalizedSpanString

public java.lang.String lowercaseNormalizedSpanString()

nerTokens

public java.util.List<CoreLabel> nerTokens()

nerName

public java.lang.String nerName()

process

public void process(Dictionaries dict,
                    Semantics semantics)
             throws java.lang.Exception

Set attributes of a mention: head string, mention type, NER label, Number, Gender, Animacy

Throws:

java.lang.Exception

process

public void process(Dictionaries dict,
                    Semantics semantics,
                    LogisticClassifier<java.lang.String,java.lang.String> singletonPredictor)
             throws java.lang.Exception

Throws:

java.lang.Exception

getSingletonFeatures

public java.util.ArrayList<java.lang.String> getSingletonFeatures(Dictionaries dict)

Returns the features used by the singleton predictor (logistic classifier) to decide whether the mention belongs to a singleton entity

isListMemberOf

public boolean isListMemberOf(Mention m)

Check list member? True if this mention is inside the other mention and the other mention is a list

addListMember

public void addListMember(Mention m)

addBelongsToList

public void addBelongsToList(Mention m)

isMemberOfSameList

public boolean isMemberOfSameList(Mention m)

setNumber

protected void setNumber(Dictionaries dict)

sameSentence

public boolean sameSentence(Mention m)

headsAgree

public boolean headsAgree(Mention m)

numbersAgree

public boolean numbersAgree(Mention m)

gendersAgree

public boolean gendersAgree(Mention m)

gendersAgree

public boolean gendersAgree(Mention m,
                            boolean strict)

animaciesAgree

public boolean animaciesAgree(Mention m)

animaciesAgree

public boolean animaciesAgree(Mention m,
                              boolean strict)

entityTypesAgree

public boolean entityTypesAgree(Mention m,
                                Dictionaries dict)

entityTypesAgree

public boolean entityTypesAgree(Mention m,
                                Dictionaries dict,
                                boolean strict)

includedIn

public boolean includedIn(Mention m)

Verifies if this mention's tree is dominated by the tree of the given mention

attributesAgree

public boolean attributesAgree(Mention potentialAntecedent,
                               Dictionaries dict)

Detects if the mention and candidate antecedent agree on all attributes respectively.

Parameters:

potentialAntecedent -

Returns:

true if all attributes agree between both mention and candidate, else false.

addApposition

public void addApposition(Mention m)

Find apposition

isApposition

public boolean isApposition(Mention m)

Check apposition

addPredicateNominatives

public void addPredicateNominatives(Mention m)

Find predicate nominatives

isPredicateNominatives

public boolean isPredicateNominatives(Mention m)

Check predicate nominatives

addRelativePronoun

public void addRelativePronoun(Mention m)

Find relative pronouns

appearEarlierThan

public boolean appearEarlierThan(Mention m)

Find which mention appears first in a document

longestNNPEndsWithHead

public java.lang.String longestNNPEndsWithHead()

lowestNPIncludesHead

public java.lang.String lowestNPIncludesHead()

stringWithoutArticle

public java.lang.String stringWithoutArticle(java.lang.String str)

preprocessSearchTerm

public java.util.List<java.lang.String> preprocessSearchTerm()

buildQueryText

public static java.lang.String buildQueryText(java.util.List<java.lang.String> terms)

removePhraseAfterHead

public java.lang.String removePhraseAfterHead()

Remove any clause after headword

removeParenthesis

public static java.lang.String removeParenthesis(java.lang.String text)

isTheCommonNoun

protected boolean isTheCommonNoun()

insideIn

public boolean insideIn(Mention m)

Returns true if this mention is contained inside m. That is, it is a subspan of the same sentence.

moreRepresentativeThan

public boolean moreRepresentativeThan(Mention m)

getPremodifiers

public java.util.ArrayList<java.util.ArrayList<IndexedWord>> getPremodifiers()

getPostmodifiers

public java.util.ArrayList<java.util.ArrayList<IndexedWord>> getPostmodifiers()

getSplitPattern

public java.lang.String[] getSplitPattern()

getPattern

public java.lang.String getPattern()

getPattern

public java.lang.String getPattern(java.util.List<AbstractCoreLabel> pTokens)

isCoordinated

public boolean isCoordinated()

getContext

public java.util.List<java.lang.String> getContext()

getPremodifierContext

public java.util.List<java.lang.String> getPremodifierContext()

isRelativePronoun

public boolean isRelativePronoun(Mention m)

Check relative pronouns

isRoleAppositive

public boolean isRoleAppositive(Mention m,
                                Dictionaries dict)

isDemonym

public boolean isDemonym(Mention m,
                         Dictionaries dict)

getPosition

public java.lang.String getPosition()

getRelation

public java.lang.String getRelation()

getModifiers

public int getModifiers(Dictionaries dict)

getQuantification

public java.lang.String getQuantification(Dictionaries dict)

getNegation

public int getNegation(Dictionaries dict)

getModal

public int getModal(Dictionaries dict)

getReportEmbedding

public int getReportEmbedding(Dictionaries dict)

getCoordination

public int getCoordination()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object