Struct TemporalBox 

pub struct TemporalBox {
    pub base: BoxEmbedding,
    pub velocity: BoxVelocity,
    pub time_range: (f64, f64),
}

A temporal box embedding that evolves over time.

Based on BoxTE (Messner et al., 2022), this models entities that change over time. For example, “The President” refers to Obama in 2012 but Trump in 2017 - they should not corefer despite the same surface form.

Example

use anno::backends::box_embeddings::{BoxEmbedding, TemporalBox, BoxVelocity};

// "The President" in 2012 (Obama)
let base = BoxEmbedding::new(vec![0.0, 0.0], vec![1.0, 1.0]);
let velocity = BoxVelocity::new(vec![0.0, 0.0], vec![0.0, 0.0]); // Static
let obama_presidency = TemporalBox::new(base, velocity, (2012.0, 2016.0));

// "The President" in 2017 (Trump)
let trump_base = BoxEmbedding::new(vec![5.0, 5.0], vec![6.0, 6.0]);
let trump_presidency = TemporalBox::new(trump_base, velocity, (2017.0, 2021.0));

// Should not corefer (different time ranges)
assert_eq!(obama_presidency.coreference_at_time(&trump_presidency, 2015.0), 0.0);

Fields

base: BoxEmbedding

Base box at time t=0 (or reference time)

velocity: BoxVelocity

Velocity: how box moves/resizes per time unit

time_range: (f64, f64)

Time range where this box is valid [start, end)

Implementations

impl TemporalBox

pub fn new( base: BoxEmbedding, velocity: BoxVelocity, time_range: (f64, f64), ) -> TemporalBox

Create a new temporal box.

Arguments

• base - Base box at reference time
• velocity - How box evolves per time unit
• time_range - (start, end) time range where box is valid

pub fn at_time(&self, time: f64) -> Option<BoxEmbedding>

Get the box at a specific time.

Returns None if time is outside the valid range.

pub fn coreference_at_time(&self, other: &TemporalBox, time: f64) -> f32

Compute coreference score at a specific time.

Returns 0.0 if either box is invalid at the given time.

pub fn is_valid_at(&self, time: f64) -> bool

Check if this temporal box is valid at the given time.

Trait Implementations

impl Clone for TemporalBox

fn clone(&self) -> TemporalBox

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalBox

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

Formats the value using the given formatter.

impl PartialEq for TemporalBox

fn eq(&self, other: &TemporalBox) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TemporalBox