Skip to main content

MentionType

Enum MentionType 

Source
pub enum MentionType {
    Proper,
    Nominal,
    Pronominal,
    Zero,
    Unknown,
}
Expand description

Type of referring expression in coreference.

This classification is fundamental to coreference resolution:

  • Proper nouns are typically antecedents (first mention)
  • Nominal mentions provide descriptive information
  • Pronominal mentions require resolution to an antecedent

§Examples

use anno_core::types::MentionType;

let mention_type = MentionType::classify("John Smith");
assert_eq!(mention_type, MentionType::Proper);

let mention_type = MentionType::classify("the president");
assert_eq!(mention_type, MentionType::Nominal);

let mention_type = MentionType::classify("he");
assert_eq!(mention_type, MentionType::Pronominal);

Variants§

§

Proper

Proper name (“John Smith”, “Microsoft”, “New York”)

Typically the first or canonical mention of an entity. Usually capitalized in English.

Also known as “Named” in NER terminology. Use MentionType::is_named() or the MentionType::NAMED constant for compatibility with code using that terminology.

§

Nominal

Common noun phrase (“the company”, “a dog”, “the president”)

Descriptive mentions that provide semantic information. May be definite (“the”) or indefinite (“a/an”).

§

Pronominal

Pronoun (“he”, “she”, “it”, “they”, “this”, “that”)

Anaphoric expressions that must be resolved to an antecedent. Includes personal, demonstrative, and relative pronouns.

§

Zero

Zero pronoun (pro-drop languages: Arabic, Spanish, Japanese, Korean, Chinese)

A dropped argument with no surface realization. The subject or object is grammatically required but omitted in the text. Common in:

  • Arabic: verb conjugation encodes subject (“ذهب” = “[he] went”)
  • Spanish: “Vino a casa” = “[He/She] came home”
  • Japanese: topic/subject frequently omitted
  • Chinese: arguments recoverable from context

Zero mentions have an anchor position (where they “would be”) but no text span. They carry phi-features (person, gender, number) from morphology or context.

§

Unknown

Unknown or unclassified mention type.

Implementations§

Source§

impl MentionType

Source

pub const NAMED: MentionType = MentionType::Proper

Alias for MentionType::Proper using NER terminology.

In NER, “named entity” is the standard term. In coreference literature, “proper noun/name” is preferred. Both refer to the same concept.

Source

pub fn is_named(&self) -> bool

Check if this is a named/proper mention.

Returns true for MentionType::Proper. This is an alias using NER terminology for code that prefers “named” over “proper”.

Source

pub fn classify(mention: &str) -> MentionType

Classify a mention string by its type.

Uses heuristics based on:

  • Pronoun list matching
  • Capitalization patterns
  • Article presence
§Examples
use anno_core::types::MentionType;

assert_eq!(MentionType::classify("Barack Obama"), MentionType::Proper);
assert_eq!(MentionType::classify("the former president"), MentionType::Nominal);
assert_eq!(MentionType::classify("he"), MentionType::Pronominal);
Source

pub fn salience_weight(&self) -> f64

Get the typical salience weight for this mention type.

Proper nouns are most salient, pronouns and zeros least (they depend on context). Used in mention ranking algorithms.

Source

pub fn can_introduce_entity(&self) -> bool

Check if this mention type typically introduces new entities.

Proper nouns often introduce entities; pronouns and zeros almost never do.

Source

pub fn requires_antecedent(&self) -> bool

Check if this mention type requires an antecedent.

Source

pub fn has_surface_form(&self) -> bool

Check if this mention type has a surface form in the text.

Returns false for zero pronouns (pro-drop).

Source

pub fn is_zero(&self) -> bool

Check if this is a zero mention (pro-drop).

Source

pub fn as_label(&self) -> &'static str

Get a string label for this mention type.

Returns a lowercase string suitable for use as a classification label.

Trait Implementations§

Source§

impl Clone for MentionType

Source§

fn clone(&self) -> MentionType

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for MentionType

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
Source§

impl Default for MentionType

Source§

fn default() -> MentionType

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for MentionType

Source§

fn deserialize<__D>( __deserializer: __D, ) -> Result<MentionType, <__D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Display for MentionType

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter. Read more
Source§

impl FromStr for MentionType

Source§

type Err = String

The associated error which can be returned from parsing.
Source§

fn from_str(s: &str) -> Result<MentionType, <MentionType as FromStr>::Err>

Parses a string s to return a value of this type. Read more
Source§

impl Hash for MentionType

Source§

fn hash<__H>(&self, state: &mut __H)
where __H: Hasher,

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl Ord for MentionType

Source§

fn cmp(&self, other: &MentionType) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl PartialEq for MentionType

Source§

fn eq(&self, other: &MentionType) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl PartialOrd for MentionType

Ordering for MentionType based on canonical selection priority.

Order: Zero < Pronominal < Unknown < Nominal < Proper

This ordering is useful for canonical mention selection: when choosing a representative mention from a cluster, higher-ranked types are preferred. Proper nouns are most informative, zeros are least.

Source§

fn partial_cmp(&self, other: &MentionType) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl Serialize for MentionType

Source§

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl Copy for MentionType

Source§

impl Eq for MentionType

Source§

impl StructuralPartialEq for MentionType

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToCompactString for T
where T: Display,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T> ToStringFallible for T
where T: Display,

Source§

fn try_to_string(&self) -> Result<String, TryReserveError>

ToString::to_string, but without panic on OOM.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,