Struct EntityCluster 

pub struct EntityCluster {
    pub id: IdentityId,
    pub canonical_name: String,
    pub entity_type: Option<TypeLabel>,
    pub mentions: Vec<EntityMention>,
    pub centroid: Option<Vec<f32>>,
    pub confidence: f32,
}

A cluster of entity mentions.

Fields

id: IdentityId

Cluster ID

canonical_name: String

Canonical name (best representative)

entity_type: Option<TypeLabel>

Entity type (consensus)

mentions: Vec<EntityMention>

All mentions in this cluster

centroid: Option<Vec<f32>>

Centroid embedding (if embeddings are available)

confidence: f32

Confidence score

Implementations

impl EntityCluster

pub fn document_ids(&self) -> Vec<&str>

Get all unique document IDs in this cluster.

pub fn has_temporal_bounds(&self) -> bool

Check if any mention in this cluster has temporal bounds.

pub fn temporal_bounds(&self) -> (Option<DateTime<Utc>>, Option<DateTime<Utc>>)

Get the aggregate temporal bounds for this cluster.

Returns the widest time span that includes all mentions:

• valid_from: Earliest valid_from among mentions
• valid_until: Latest valid_until among mentions

Returns (None, None) if no mentions have temporal bounds.

pub fn observation_times(&self) -> Vec<DateTime<Utc>>

Get all unique timestamps when mentions were observed.

Useful for tracking entity evolution over time.

pub fn observation_span(&self) -> Option<(DateTime<Utc>, DateTime<Utc>)>

Get the time span of observations for this cluster.

Returns (first_observation, last_observation) if any timestamps exist.

impl EntityCluster

pub fn to_identity(&self) -> Identity

Convert this cluster to an anno_core::Identity.

Creates a global Identity from the cluster’s contents. The source is set to CrossDocCoref with TrackRefs for all mentions that have track_id set.

Trait Implementations

impl Clone for EntityCluster

fn clone(&self) -> EntityCluster

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EntityCluster

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

Formats the value using the given formatter.