Struct TemporalEdgeLayer

pub struct TemporalEdgeLayer {
    successors: Vec<Option<u32>>,
    predecessors: Vec<Option<u32>>,
}

Temporal edge layer tracking successor/predecessor relationships.

Node IDs must be registered sequentially (0, 1, 2, …).

Fields

successors: Vec<Option<u32>>

node_id → temporal successor (next point for same entity, or None).

predecessors: Vec<Option<u32>>

node_id → temporal predecessor (previous point for same entity, or None).

Implementations

impl TemporalEdgeLayer

pub fn new() -> Self

Create a new empty temporal edge layer.

pub fn with_capacity(capacity: usize) -> Self

Create with pre-allocated capacity.

pub fn register(&mut self, node_id: u32, entity_last_node: Option<u32>)

Register a new node and link it to the entity’s previous latest node.

entity_last_node should be the node_id of the entity’s most recent point before this insert (None if this is the entity’s first point).

Panics

Panics if node_id != self.len() (nodes must be registered sequentially).

pub fn successor(&self, node_id: u32) -> Option<u32>

Get the temporal successor of a node (next point for same entity).

pub fn predecessor(&self, node_id: u32) -> Option<u32>

Get the temporal predecessor of a node (previous point for same entity).

pub fn temporal_neighbors(&self, node_id: u32) -> impl Iterator<Item = u32> + '_

Iterate temporal neighbors (predecessor and/or successor).

pub fn walk_forward(&self, start: u32, max_steps: usize) -> Vec<u32>

Walk forward in time from a node, returning up to max_steps successors.

pub fn walk_backward(&self, start: u32, max_steps: usize) -> Vec<u32>

Walk backward in time from a node, returning up to max_steps predecessors.

pub fn len(&self) -> usize

Number of registered nodes.

pub fn is_empty(&self) -> bool

Whether no nodes have been registered.

pub fn memory_bytes(&self) -> usize

Approximate memory usage in bytes.

Trait Implementations

impl Clone for TemporalEdgeLayer

fn clone(&self) -> TemporalEdgeLayer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalEdgeLayer

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

Formats the value using the given formatter.

impl Default for TemporalEdgeLayer

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TemporalEdgeLayer

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TemporalEdgeLayer

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

where __S: Serializer,

Serialize this value into the given Serde serializer.