Mention (Stanford CoreNLP API)

java.lang.Object
- edu.stanford.nlp.dcoref.Mention

All Implemented Interfaces:

CoreAnnotation<Mention>, TypesafeMap.Key<Mention>, Serializable
```
public class Mention
extends Object
implements CoreAnnotation<Mention>, 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`
`Set<Mention>`	`appositions` Set of other mentions in the same sentence that are syntactic appositions to this
`Set<Mention>`	`belongToLists` Set of other mentions in the same sentence that I am a member of
`Tree`	`contextParseTree`
`int`	`corefClusterID`
`SemanticGraph`	`dependency`
`Set<String>`	`dependents`
`IndexedWord`	`dependingVerb`
`int`	`endIndex`
`Dictionaries.Gender`	`gender`
`boolean`	`generic`
`int`	`goldCorefClusterID`
`int`	`headIndex`
`IndexedWord`	`headIndexedWord`
`String`	`headString`
`CoreLabel`	`headWord`
`boolean`	`isDirectObject`
`boolean`	`isIndirectObject`
`boolean`	`isPrepositionObject`
`boolean`	`isSingleton`
`boolean`	`isSubject`
`Set<Mention>`	`listMembers` Set of other mentions in the same sentence that below to this list
`int`	`mentionID`
`Tree`	`mentionSubTree`
`Dictionaries.MentionType`	`mentionType`
`String`	`nerString`
`Dictionaries.Number`	`number`
`int`	`originalRef`
`List<CoreLabel>`	`originalSpan`
`int`	`paragraph`
`Dictionaries.Person`	`person`
`Set<Mention>`	`predicateNominatives`
`List<String>`	`preprocessedTerms`
`Set<Mention>`	`relativePronouns`
`List<CoreLabel>`	`sentenceWords`
`int`	`sentNum`
`SpeakerInfo`	`speakerInfo`
`int`	`startIndex`
`Object`	`synsets`
`boolean`	`twinless`
`int`	`utter`

Constructor Summary

Constructors
Constructor and Description
`Mention()`
`Mention(int mentionID, int startIndex, int endIndex, SemanticGraph dependency)`
`Mention(int mentionID, int startIndex, int endIndex, SemanticGraph dependency, List<CoreLabel> mentionSpan)`
`Mention(int mentionID, int startIndex, int endIndex, SemanticGraph dependency, List<CoreLabel> mentionSpan, Tree mentionTree)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
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 String`	`buildQueryText(List<String> terms)`
`boolean`	`entityTypesAgree(Mention m, Dictionaries dict)`
`boolean`	`entityTypesAgree(Mention m, Dictionaries dict, boolean strict)`
`boolean`	`gendersAgree(Mention m)`
`boolean`	`gendersAgree(Mention m, boolean strict)`
`List<String>`	`getContext()`
`int`	`getCoordination()`
`int`	`getModal(Dictionaries dict)`
`int`	`getModifiers(Dictionaries dict)`
`int`	`getNegation(Dictionaries dict)`
`String`	`getPattern()`
`String`	`getPattern(List<AbstractCoreLabel> pTokens)`
`String`	`getPosition()`
`ArrayList<ArrayList<IndexedWord>>`	`getPostmodifiers()`
`List<String>`	`getPremodifierContext()`
`ArrayList<ArrayList<IndexedWord>>`	`getPremodifiers()`
`String`	`getQuantification(Dictionaries dict)`
`String`	`getRelation()`
`int`	`getReportEmbedding(Dictionaries dict)`
`protected ArrayList<String>`	`getSingletonFeatures(Dictionaries dict)` Returns the features used by the singleton predictor (logistic classifier) to decide whether the mention belongs to a singleton entity
`String[]`	`getSplitPattern()`
`Class<Mention>`	`getType()` Returns the type associated with this annotation.
`protected 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)`
`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()`
`String`	`longestNNPEndsWithHead()`
`String`	`lowercaseNormalizedSpanString()`
`String`	`lowestNPIncludesHead()`
`boolean`	`moreRepresentativeThan(Mention m)`
`String`	`nerName()`
`List<CoreLabel>`	`nerTokens()`
`boolean`	`numbersAgree(Mention m)`
`List<String>`	`preprocessSearchTerm()`
`void`	`process(Dictionaries dict, Semantics semantics, MentionExtractor mentionExtractor)` Set attributes of a mention: head string, mention type, NER label, Number, Gender, Animacy
`void`	`process(Dictionaries dict, Semantics semantics, MentionExtractor mentionExtractor, LogisticClassifier<String,String> singletonPredictor)`
`static String`	`removeParenthesis(String text)`
`String`	`removePhraseAfterHead()` Remove any clause after headword
`boolean`	`sameSentence(Mention m)`
`protected void`	`setNumber(Dictionaries dict)`
`String`	`spanToString()`
`String`	`stringWithoutArticle(String str)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, 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 String headString
```

nerString
```
public 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
```

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
```

twinless
```
public boolean twinless
```

generic
```
public boolean generic
```

isSingleton
```
public boolean isSingleton
```

sentenceWords
```
public List<CoreLabel> sentenceWords
```

originalSpan
```
public List<CoreLabel> originalSpan
```

mentionSubTree
```
public Tree mentionSubTree
```

contextParseTree
```
public Tree contextParseTree
```

headWord
```
public CoreLabel headWord
```

dependency
```
public SemanticGraph dependency
```

dependents
```
public Set<String> dependents
```

preprocessedTerms
```
public List<String> preprocessedTerms
```

synsets
```
public Object synsets
```

appositions
```
public Set<Mention> appositions
```
Set of other mentions in the same sentence that are syntactic appositions to this

predicateNominatives

public Set<Mention> predicateNominatives

relativePronouns
```
public Set<Mention> relativePronouns
```

listMembers
```
public Set<Mention> listMembers
```
Set of other mentions in the same sentence that below to this list

belongToLists
```
public Set<Mention> belongToLists
```
Set of other mentions in the same sentence that I am a member of

speakerInfo
```
public SpeakerInfo speakerInfo
```

Constructor Detail

Mention
```
public Mention()
```

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               SemanticGraph dependency)

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               SemanticGraph dependency,
               List<CoreLabel> mentionSpan)

Mention

public Mention(int mentionID,
               int startIndex,
               int endIndex,
               SemanticGraph dependency,
               List<CoreLabel> mentionSpan,
               Tree mentionTree)

Method Detail

getType
```
public 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 String toString()
```
Overrides:

toString in class Object

spanToString
```
public String spanToString()
```

lowercaseNormalizedSpanString

public String lowercaseNormalizedSpanString()

nerTokens
```
public List<CoreLabel> nerTokens()
```

nerName
```
public String nerName()
```

process

public void process(Dictionaries dict,
                    Semantics semantics,
                    MentionExtractor mentionExtractor)
             throws Exception

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

Throws:: Exception

process

public void process(Dictionaries dict,
                    Semantics semantics,
                    MentionExtractor mentionExtractor,
                    LogisticClassifier<String,String> singletonPredictor)
             throws Exception

Throws:: Exception

getSingletonFeatures
```
protected ArrayList<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

protected 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 String longestNNPEndsWithHead()

lowestNPIncludesHead
```
public String lowestNPIncludesHead()
```

stringWithoutArticle

public String stringWithoutArticle(String str)

preprocessSearchTerm

public List<String> preprocessSearchTerm()

buildQueryText

public static String buildQueryText(List<String> terms)

removePhraseAfterHead
```
public String removePhraseAfterHead()
```
Remove any clause after headword

removeParenthesis

public static String removeParenthesis(String text)

isTheCommonNoun
```
protected boolean isTheCommonNoun()
```

insideIn
```
public boolean insideIn(Mention m)
```

moreRepresentativeThan

public boolean moreRepresentativeThan(Mention m)

getPremodifiers

public ArrayList<ArrayList<IndexedWord>> getPremodifiers()

getPostmodifiers

public ArrayList<ArrayList<IndexedWord>> getPostmodifiers()

getSplitPattern
```
public String[] getSplitPattern()
```

getPattern
```
public String getPattern()
```

getPattern

public String getPattern(List<AbstractCoreLabel> pTokens)

isCoordinated
```
public boolean isCoordinated()
```

getContext
```
public List<String> getContext()
```

getPremodifierContext

public List<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 String getPosition()
```

getRelation
```
public String getRelation()
```

getModifiers

public int getModifiers(Dictionaries dict)

getQuantification

public 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()
```

Class Mention

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

mentionType

number

gender

animacy

person

headString

nerString

startIndex

endIndex

headIndex

mentionID

originalRef

headIndexedWord

goldCorefClusterID

corefClusterID

sentNum

utter

paragraph

isSubject

isDirectObject

isIndirectObject

isPrepositionObject

dependingVerb

twinless

generic

isSingleton

sentenceWords

originalSpan

mentionSubTree

contextParseTree

headWord

dependency

dependents

preprocessedTerms

synsets

appositions

predicateNominatives

relativePronouns

listMembers

belongToLists

speakerInfo

Constructor Detail

Mention

Mention

Mention

Mention

Method Detail

getType

isPronominal

toString

spanToString

lowercaseNormalizedSpanString

nerTokens

nerName

process

process

getSingletonFeatures

isListMemberOf

addListMember

addBelongsToList

isMemberOfSameList

setNumber

sameSentence

headsAgree

numbersAgree

gendersAgree

gendersAgree

animaciesAgree

animaciesAgree

entityTypesAgree

entityTypesAgree

includedIn

attributesAgree

addApposition