Struct Candidate 

pub struct Candidate {

    pub kb_id: String,
    pub source: CandidateSource,
    pub label: String,
    pub aliases: Vec<String>,
    pub description: Option<String>,
    pub kb_type: Option<String>,
    pub sitelinks: Option<u32>,
    pub prior: f64,
    pub string_sim: f64,
    pub type_score: f64,
    pub score: f64,
    pub valid_from: Option<String>,
    pub valid_until: Option<String>,
}

A candidate KB entry for a mention.

Fields

kb_id: String

KB identifier (e.g., “Q937” for Wikidata)

source: CandidateSource

Source knowledge base

label: String

Canonical name/label

aliases: Vec<String>

Aliases/alternate names

description: Option<String>

Description/gloss

kb_type: Option<String>

Entity type from KB (e.g., “human”, “organization”)

sitelinks: Option<u32>

Wikipedia sitelink count (popularity proxy)

prior: f64

Prior probability (if known)

string_sim: f64

String similarity to mention

type_score: f64

Type compatibility score

score: f64

Overall candidate score (for ranking)

valid_from: Option<String>

Temporal validity start (ISO 8601 date string).

For people: birth date. For organizations: founding date. Critical for historical document disambiguation where “President Bush” could refer to different people depending on the document date (Arora et al. 2024).

valid_until: Option<String>

Temporal validity end (ISO 8601 date string).

For people: death date. For organizations: dissolution date.

Implementations

impl Candidate

pub fn new(kb_id: &str, source: CandidateSource, label: &str) -> Self

Create a new candidate.

pub fn with_valid_from(self, date: &str) -> Self

Set temporal validity start.

pub fn with_valid_until(self, date: &str) -> Self

Set temporal validity end.

pub fn with_alias(self, alias: &str) -> Self

Add an alias.

pub fn with_description(self, desc: &str) -> Self

Set description.

pub fn with_kb_type(self, kb_type: &str) -> Self

Set KB type.

pub fn with_prior(self, prior: f64) -> Self

Set prior.

pub fn compute_score(&mut self)

Compute overall score.

pub fn compute_score_with_temporal(&mut self, document_date: Option<&str>)

Compute score with temporal context.

For historical documents, temporal compatibility is critical for disambiguation. “President Bush” in 1990 refers to George H.W. Bush, while in 2005 it refers to George W. Bush.

Arguments

• document_date - ISO 8601 date string (e.g., “1990-01-15”)

pub fn temporal_compatibility(&self, document_date: &str) -> f64

Check temporal compatibility with a document date.

Returns 1.0 if the candidate is valid at the document date, 0.0 if clearly invalid, and intermediate values for uncertainty.

pub fn to_iri(&self) -> String

Get IRI/URI for this candidate.

pub fn to_curie(&self) -> String

Get CURIE (Compact URI) for this candidate.

Trait Implementations

impl Clone for Candidate

fn clone(&self) -> Candidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Candidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Candidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Candidate> for CandidateSummary

fn from(c: &Candidate) -> Self

Converts to this type from the input type.

impl Serialize for Candidate

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

where __S: Serializer,

Serialize this value into the given Serde serializer.