Struct EventMention 

pub struct EventMention {
    pub trigger: String,
    pub trigger_start: usize,
    pub trigger_end: usize,
    pub trigger_type: Option<String>,
    pub arguments: Vec<(String, String)>,
    pub confidence: Confidence,
    pub polarity: EventPolarity,
    pub tense: Option<EventTense>,
}

An event mention extracted from text.

Events are a key type of abstract antecedent. They have:

• A trigger word/phrase (usually a verb or event noun)
• Arguments (agent, patient, location, time, etc.)
• Type classification (attack, movement, creation, etc.)

Research Background

Event extraction is a well-studied task (ACE, TAC-KBP, etc.). We use a simplified model focused on what’s needed for anaphora resolution.

Example

Text: “Russia invaded Ukraine in February 2022”

use anno::discourse::EventMention;

let event = EventMention::new("invaded", 7, 14)
    .with_trigger_type("attack")
    .with_arguments(vec![
        ("Agent", "Russia"),
        ("Patient", "Ukraine"),
        ("Time", "February 2022"),
    ]);

assert_eq!(event.trigger, "invaded");
assert_eq!(event.trigger_type.as_deref(), Some("attack"));

Fields

trigger: String

The trigger word/phrase (e.g., “invaded”, “announced”)

trigger_start: usize

Start character offset of trigger

trigger_end: usize

End character offset of trigger

trigger_type: Option<String>

Event type (e.g., “attack”, “movement”, “communication”)

arguments: Vec<(String, String)>

Event arguments (role -> entity text) Common roles: Agent, Patient, Location, Time, Instrument

confidence: Confidence

Confidence score for this event extraction

polarity: EventPolarity

Event polarity (positive, negative, uncertain)

tense: Option<EventTense>

Event tense/aspect

Implementations

impl EventMention

pub fn new(trigger: impl Into<String>, start: usize, end: usize) -> EventMention

Create a new event mention.

pub fn with_trigger_type(self, trigger_type: impl Into<String>) -> EventMention

Set the trigger type (event classification).

pub fn with_arguments<S>(self, args: Vec<(&str, S)>) -> EventMention

where S: Into<String>,

Add arguments to this event.

pub fn with_confidence(self, confidence: f64) -> EventMention

Set confidence score.

pub fn with_polarity(self, polarity: EventPolarity) -> EventMention

Set polarity.

pub fn with_tense(self, tense: EventTense) -> EventMention

Set tense.

pub fn get_argument(&self, role: &str) -> Option<&str>

Get argument by role.

Trait Implementations

impl Clone for EventMention

fn clone(&self) -> EventMention

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventMention

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EventMention

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventMention

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.