Struct FacContextTree 

pub struct FacContextTree { /* private fields */ }

Factorized Action-Conditional Context Tree Weighting.

Implementations

impl FacContextTree

pub fn new(base_depth: usize, num_percept_bits: usize) -> Self

Create a factorized CTW stack over num_percept_bits bit positions.

Tree i uses depth base_depth + i, matching FAC-CTW’s increasing context.

pub fn reserve_for_symbols(&mut self, total_symbols: usize)

Reserve history/tree capacity for approximately total_symbols updates.

pub fn num_bits(&self) -> usize

Number of bit positions currently modeled per symbol.

pub fn base_depth(&self) -> usize

Base depth used to construct the first factorized tree.

pub fn update(&mut self, sym: bool, bit_index: usize)

Update one bit position with a binary symbol.

pub fn update_byte_msb(&mut self, byte: u8)

Update all bit positions from one byte, most-significant bit first.

pub fn update_byte_lsb(&mut self, byte: u8)

Update all active bit positions from one byte, least-significant bit first.

pub fn update_predicted(&mut self, sym: bool, bit_index: usize)

Commit an update using the fast-path prepared by a prior prediction call.

pub fn predict(&mut self, sym: bool, bit_index: usize) -> f64

Predict a single bit probability for bit_index.

pub fn revert(&mut self, bit_index: usize)

Revert the most recent bit update for bit_index.

pub fn update_history(&mut self, symbols: &[bool])

Append raw shared-history symbols without model updates.

pub fn revert_history(&mut self, count: usize)

Drop the last count symbols from shared history.

pub fn reset_history_only(&mut self)

Clear shared history while preserving learned tree parameters.

pub fn get_log_block_probability(&self) -> f64

Sum of per-tree log block probabilities.

pub fn clear(&mut self)

Clear all trees and shared history.

pub fn memory_usage(&self) -> usize

Approximate heap memory usage in bytes.

Trait Implementations

impl Clone for FacContextTree

fn clone(&self) -> FacContextTree

Returns a duplicate of the value.

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

Performs copy-assignment from source.