Struct EventCluster 

pub struct EventCluster {
    pub mentions: Vec<EventMention>,
    pub id: u64,
    pub event_type: Option<String>,
    pub confidence: Confidence,
}

A cluster of coreferent event mentions.

Research Background

Event coreference (Ahmed & Martin, 2021) links mentions of the same real-world event across a document. Unlike entity coreference, event coreference must consider:

• Trigger words (verbs, nominalizations)
• Arguments (who did what to whom)
• Temporal/spatial constraints
• Event subtypes (attacks, meetings, etc.)

Example

use anno::discourse::{EventMention, EventCluster};

let mentions = vec![
    EventMention::new("invasion", 10, 18)
        .with_trigger_type("attack"),
    EventMention::new("invaded", 50, 57)
        .with_trigger_type("attack"),
    EventMention::new("attack", 100, 106)
        .with_trigger_type("attack"),
];

let cluster = EventCluster::new(mentions);
assert_eq!(cluster.len(), 3);
assert_eq!(cluster.canonical_trigger(), "invasion");

Fields

mentions: Vec<EventMention>

All event mentions in this cluster

id: u64

Cluster ID

event_type: Option<String>

Canonical event type (e.g., “attack”)

confidence: Confidence

Confidence in this clustering

Implementations

impl EventCluster

pub fn new(mentions: Vec<EventMention>) -> EventCluster

Create a new event cluster.

pub fn len(&self) -> usize

Number of mentions.

pub fn is_empty(&self) -> bool

Is the cluster empty?

pub fn canonical_trigger(&self) -> &str

Get the canonical trigger (first mention’s trigger).

pub fn with_id(self, id: u64) -> EventCluster

Set cluster ID.

pub fn add(&mut self, mention: EventMention)

Add a mention to the cluster.

Trait Implementations

impl Clone for EventCluster

fn clone(&self) -> EventCluster

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EventCluster

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

Formats the value using the given formatter.

impl Default for EventCluster

fn default() -> EventCluster

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EventCluster

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EventCluster

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.