Struct Context 

pub struct Context { /* private fields */ }

The shared context between emitter and receiver

Implementations

impl Context

pub fn new() -> Self

Create a new empty context

pub fn with_config(config: ContextConfig) -> Self

Create context with custom configuration

pub fn with_evolution(evolution_config: EvolutionConfig) -> Self

Create context with evolution configuration

pub fn observation_count(&self) -> u64

Get observation count

pub fn version(&self) -> u32

Get current version

pub fn scale_factor(&self) -> u32

Get scale factor

pub fn hash(&self) -> u64

Calculate hash of the entire context for sync verification

pub fn pattern_count(&self) -> usize

Get number of patterns in dictionary

pub fn source_count(&self) -> usize

Get number of tracked sources

pub fn memory_usage(&self) -> usize

Estimate memory usage in bytes

pub fn estimated_memory(&self) -> usize

Alias for memory_usage (for metrics compatibility)

pub fn evolve(&mut self)

Run context evolution (pruning + reordering)

pub fn observe(&mut self, data: &RawData)

Observe a new data point (update statistics and trigger evolution)

pub fn predict(&self, source_id: u32) -> Option<Prediction>

Get prediction for a source

pub fn last_value(&self, source_id: u32) -> Option<f64>

Get last observed value for a source

pub fn moving_average(&self, source_id: u32, window: usize) -> Option<f64>

Get moving average for a source

pub fn register_pattern(&mut self, pattern: Pattern) -> Result<u32>

Register a new pattern in the dictionary

pub fn get_pattern(&self, code: u32) -> Option<&Pattern>

Get pattern by code

pub fn find_pattern(&self, data: &[u8]) -> Option<u32>

Find pattern code by data

pub fn remove_pattern(&mut self, id: u32)

Remove a pattern by ID

pub fn set_pattern(&mut self, id: u32, pattern: Pattern)

Set a pattern at a specific ID (for sync)

pub fn has_pattern(&self, id: u32) -> bool

Check if a pattern exists by ID

pub fn patterns_iter(&self) -> impl Iterator<Item = (&u32, &Pattern)>

Iterate over patterns (id, pattern)

pub fn pattern_ids(&self) -> impl Iterator<Item = u32> + '_

Get all pattern IDs

pub fn set_version(&mut self, version: u32)

Set version directly (for sync)

pub fn pattern_hashes(&self) -> impl Iterator<Item = u64> + '_

Get iterator over pattern hashes (for fleet sync)

pub fn export_full(&self) -> Vec<u8>

Export full context for synchronization

pub fn export_diff(&self, _from_version: u32) -> Vec<u8>

Export diff since a given version

pub fn import_full(&mut self, data: &[u8]) -> Result<()>

Import full context

pub fn reset(&mut self)

Reset context to initial state

pub fn verify(&self, expected_hash: u64) -> bool

Verify hash matches

pub fn model_type(&self) -> PredictionModel

Get the type of prediction model being used

pub fn save_to_file(&self, path: &Path, sensor_type: &str) -> Result<()>

Save current context state to a preload file

This allows the context to be loaded later for instant optimal compression.

Arguments

• path - Path to save the preload file
• sensor_type - Identifier for the sensor type (e.g., “temperature”, “humidity”)

Example

use alec::context::Context;
use std::path::Path;

let mut ctx = Context::new();
// ... train the context with data ...
ctx.save_to_file(Path::new("temperature.alec-context"), "temperature").unwrap();

pub fn load_from_file(path: &Path) -> Result<Self>

Load a preload file and initialize context

This allows achieving optimal compression from the first byte by loading a pre-trained context.

Arguments

• path - Path to the preload file

Returns

A new Context initialized with the preload data

Example

use alec::context::Context;
use std::path::Path;

let ctx = Context::load_from_file(Path::new("temperature.alec-context")).unwrap();
assert!(ctx.pattern_count() > 0);

pub fn context_version(&self) -> u32

Get context version for sync checking

This version should be included in message headers to allow the decoder to verify it has the correct context.

pub fn check_version(&self, message_version: u32) -> VersionCheckResult

Check if context version matches expected version

Returns a VersionCheckResult indicating whether versions match or providing details about the mismatch.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Context

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

Formats the value using the given formatter.

impl Default for Context

fn default() -> Self

Returns the “default value” for a type.

impl HealthCheckable for Context

Available on crate feature std only.

fn health_check(&self) -> HealthCheck

Perform health check