Struct CrossDocCluster 

pub struct CrossDocCluster {
    pub id: u64,
    pub canonical_name: String,
    pub entity_type: Option<EntityType>,
    pub documents: Vec<String>,
    pub mentions: Vec<(String, usize)>,
    pub kb_id: Option<String>,
    pub confidence: f64,
}

A cross-document entity cluster.

Groups mentions from multiple documents that refer to the same real-world entity.

Fields

id: u64

Cluster ID

canonical_name: String

Canonical name for the cluster (e.g., “Jensen Huang”)

entity_type: Option<EntityType>

Entity type for the cluster

documents: Vec<String>

Documents containing mentions of this entity

mentions: Vec<(String, usize)>

(doc_id, entity_idx) pairs for all mentions

kb_id: Option<String>

External knowledge base ID (if linked)

confidence: f64

Confidence in this clustering

Implementations

impl CrossDocCluster

pub fn new(id: impl Into<u64>, canonical_name: &str) -> Self

Create a new cluster.

pub fn len(&self) -> usize

Number of mentions.

pub fn mention_count(&self) -> usize

Alias for len().

pub fn is_empty(&self) -> bool

Check if cluster is empty.

pub fn doc_count(&self) -> usize

Number of unique documents.

pub fn add_mention(&mut self, doc_id: &str, entity_idx: usize)

Add a mention to the cluster.

pub fn with_type(self, entity_type: EntityType) -> Self

Set entity type.

Trait Implementations

impl Clone for CrossDocCluster

fn clone(&self) -> CrossDocCluster

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CrossDocCluster

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

Formats the value using the given formatter.

impl Default for CrossDocCluster

fn default() -> CrossDocCluster

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CrossDocCluster

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&CrossDocCluster> for Identity

Convert a CrossDocCluster to an Identity.

This converts from the evaluation/clustering result format to the core representation.

Note on TrackRefs

CDCR’s CrossDocCluster doesn’t contain track information (only entity indices), so we cannot create valid TrackRefs. The source is set to None to indicate this is a conversion from evaluation format. If you need proper TrackRefs, use Corpus::resolve_inter_doc_coref() instead.

Note on source: None

The source field is set to None because CrossDocCluster only contains (doc_id, entity_idx) pairs, not track_ids. Without track IDs, we cannot create valid TrackRefs that would be needed for IdentitySource::CrossDocCoref.

This is intentional: identities created from evaluation data don’t have the same provenance tracking as identities created through the normal corpus resolution pipeline.

fn from(cluster: &CrossDocCluster) -> Self

Converts to this type from the input type.

impl Serialize for CrossDocCluster

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

where __S: Serializer,

Serialize this value into the given Serde serializer.