opennlp.tools.coref.resolver
Class SingularPronounResolver

java.lang.Object
  opennlp.tools.coref.resolver.AbstractResolver
      opennlp.tools.coref.resolver.MaxentResolver
          opennlp.tools.coref.resolver.SingularPronounResolver

All Implemented Interfaces:

Resolver

public class SingularPronounResolver
extends MaxentResolver

This class resolver singular pronouns such as "he", "she", "it" and their various forms.

Field Summary

Fields inherited from class opennlp.tools.coref.resolver.MaxentResolver

DEFAULT, DIFF, nonReferentialResolver, pairedSampleSelection, preferFirstReferent, SAME, useSameModelForNonRef

Fields inherited from class opennlp.tools.coref.resolver.AbstractResolver

distances, numEntitiesBack, numSentencesBack, showExclusions

Constructor Summary

SingularPronounResolver(String projectName, ResolverMode m)

SingularPronounResolver(String projectName, ResolverMode m, NonReferentialResolver nonReferentialResolver)

Method Summary

boolean	canResolve(MentionContext mention) Returns true if this resolver is able to resolve the referring expression of the same type as the specified mention.
boolean	excluded(MentionContext mention, DiscourseEntity entity) Excludes entities which you are not compatible with the entity under consideration.
protected List<String>	getFeatures(MentionContext mention, DiscourseEntity entity) Returns a list of features for deciding whether the specified mention refers to the specified discourse entity.
protected boolean	outOfRange(MentionContext mention, DiscourseEntity entity) Determines if the specified entity is too far from the specified mention to be resolved to it.

Methods inherited from class opennlp.tools.coref.resolver.MaxentResolver

defaultReferent, resolve, retain, setSimilarityModel, train

Methods inherited from class opennlp.tools.coref.resolver.AbstractResolver

featureString, getHead, getHeadIndex, getHeadString, getNumEntities, getNumEntities, setNumberSentencesBack

Methods inherited from class java.lang.Object

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

Constructor Detail

SingularPronounResolver

public SingularPronounResolver(String projectName,
                               ResolverMode m)
                        throws IOException

Throws:

IOException

SingularPronounResolver

public SingularPronounResolver(String projectName,
                               ResolverMode m,
                               NonReferentialResolver nonReferentialResolver)
                        throws IOException

Throws:

IOException

Method Detail

canResolve

public boolean canResolve(MentionContext mention)

Description copied from interface: Resolver

Returns true if this resolver is able to resolve the referring expression of the same type as the specified mention.

Parameters:

mention - The mention being considered for resolution.

Returns:

true if the resolver handles this type of referring expression, false otherwise.

getFeatures

protected List<String> getFeatures(MentionContext mention,
                                   DiscourseEntity entity)

Description copied from class: MaxentResolver

Returns a list of features for deciding whether the specified mention refers to the specified discourse entity.

Overrides:

getFeatures in class MaxentResolver

Parameters:

mention - the mention being considers as possibly referential.

entity - The discourse entity with which the mention is being considered referential.

Returns:

a list of features used to predict reference between the specified mention and entity.

excluded

public boolean excluded(MentionContext mention,
                        DiscourseEntity entity)

Description copied from class: AbstractResolver

Excludes entities which you are not compatible with the entity under consideration. The default implementation excludes entities whose last extent contains the extent under consideration. This prevents possessive pronouns from referring to the noun phrases they modify and other undesirable things.

Overrides:

excluded in class MaxentResolver

Parameters:

mention - The mention which is being considered as referential.

entity - The entity to which the mention is to be resolved.

Returns:

true if the entity should be excluded, false otherwise.

outOfRange

protected boolean outOfRange(MentionContext mention,
                             DiscourseEntity entity)

Description copied from class: AbstractResolver

Determines if the specified entity is too far from the specified mention to be resolved to it. Once an entity has been determined to be out of range subsequent entities are not considered. To skip intermediate entities @see excluded.

Overrides:

outOfRange in class AbstractResolver

Parameters:

mention - The mention which is being considered.

entity - The entity to which the mention is to be resolved.

Returns:

true is the entity is in range of the mention, false otherwise.