Struct InfotheoryCtx 

pub struct InfotheoryCtx {
    pub rate_backend: CompiledRateBackend,
    pub compression_backend: CompiledCompressionBackend,
}

Reusable execution context holding default rate and compression backends.

Fields

rate_backend: CompiledRateBackend

Default rate backend for entropy/rate metrics.

compression_backend: CompiledCompressionBackend

Default compression backend for NCD/compression primitives.

Implementations

impl InfotheoryCtx

pub fn try_default() -> InfotheoryResult<Self>

Create the current build’s implicit default context.

pub fn new( rate_backend: CompiledRateBackend, compression_backend: CompiledCompressionBackend, ) -> Self

Create a context from explicit rate and compression backends.

pub fn from_specs( rate_backend: RateBackend, compression_backend: CompressionBackend, ) -> InfotheoryResult<Self>

Create a context from wrapper backend specs.

pub fn try_with_zpaq( method: impl Into<ZpaqMethodSpec>, ) -> InfotheoryResult<Self>

Create a context with adaptive ROSA+ rate backend and ZPAQ compression backend.

pub fn try_compress_size(&self, data: &[u8]) -> InfotheoryResult<u64>

Compressed length of one byte slice under this context’s compressor.

pub fn try_compress_size_chain(&self, parts: &[&[u8]]) -> InfotheoryResult<u64>

Compressed length of chained slices under one stream.

pub fn rate_backend_session( &self, total_symbols: Option<u64>, ) -> InfotheoryResult<RateBackendSession>

Create a stateful session for the active rate backend.

pub fn rate_backend_bit_session( &self, total_bits: Option<u64>, semantics: BitStreamSemantics, ) -> InfotheoryResult<RateBackendBitSession>

Create a stateful bit-level session for the active rate backend.

pub fn try_entropy_rate_bytes(&self, data: &[u8]) -> InfotheoryResult<f64>

Fallible entropy-rate estimate for data under this context’s rate backend.

pub fn try_biased_entropy_rate_bytes( &self, data: &[u8], ) -> InfotheoryResult<f64>

Fallible biased entropy-rate estimate (plugin variant) for data.

pub fn try_cross_entropy_rate_bytes( &self, test_data: &[u8], train_data: &[u8], ) -> InfotheoryResult<f64>

Fallible cross entropy of test_data under model trained on train_data.

pub fn try_cross_entropy_bytes( &self, test_data: &[u8], train_data: &[u8], ) -> InfotheoryResult<f64>

Cross entropy under the active rate backend.

pub fn try_joint_entropy_rate_bytes( &self, x: &[u8], y: &[u8], ) -> InfotheoryResult<f64>

Fallible joint entropy-rate estimate H(X,Y) under aligned-prefix semantics.

pub fn try_conditional_entropy_rate_bytes( &self, x: &[u8], y: &[u8], ) -> InfotheoryResult<f64>

Fallible conditional entropy-rate estimate H(X|Y).

pub fn try_cross_entropy_conditional_chain( &self, prefix_parts: &[&[u8]], data: &[u8], ) -> InfotheoryResult<f64>

Fallible H(data | prefix_parts) by conditioning the active rate backend on an explicit prefix chain.

pub fn try_generate_bytes( &self, prompt: &[u8], bytes: usize, ) -> InfotheoryResult<Vec<u8>>

Generate a continuation from prompt with GenerationConfig::default().

pub fn try_generate_bytes_with_config( &self, prompt: &[u8], bytes: usize, config: GenerationConfig, ) -> InfotheoryResult<Vec<u8>>

Fallible continuation generation from prompt using an explicit config.

pub fn try_generate_bytes_conditional_chain( &self, prefix_parts: &[&[u8]], bytes: usize, ) -> InfotheoryResult<Vec<u8>>

Generate a continuation after conditioning on an explicit chain of prefix parts.

pub fn try_generate_bytes_conditional_chain_with_config( &self, prefix_parts: &[&[u8]], bytes: usize, config: GenerationConfig, ) -> InfotheoryResult<Vec<u8>>

Fallible continuation generation after conditioning on an explicit chain of prefix parts.

pub fn try_ncd_bytes( &self, x: &[u8], y: &[u8], variant: NcdVariant, ) -> InfotheoryResult<f64>

NCD between byte slices using this context’s compression backend.

pub fn try_mutual_information_rate_bytes( &self, x: &[u8], y: &[u8], ) -> InfotheoryResult<f64>

Rate-backend mutual information estimate.

pub fn try_mutual_information_bytes( &self, x: &[u8], y: &[u8], ) -> InfotheoryResult<f64>

Mutual information under the active rate backend.

pub fn try_conditional_entropy_bytes( &self, x: &[u8], y: &[u8], ) -> InfotheoryResult<f64>

Conditional entropy H(X|Y) under the active rate backend.

pub fn try_ned_bytes(&self, x: &[u8], y: &[u8]) -> InfotheoryResult<f64>

Normalized entropy distance (NED) under this context’s rate backend.

pub fn try_ned_cons_bytes(&self, x: &[u8], y: &[u8]) -> InfotheoryResult<f64>

Conservative NED normalization variant under this context’s rate backend.

pub fn try_nte_bytes(&self, x: &[u8], y: &[u8]) -> InfotheoryResult<f64>

Normalized transform effort (NTE) under this context’s rate backend.

pub fn try_intrinsic_dependence_bytes( &self, data: &[u8], ) -> InfotheoryResult<f64>

Intrinsic dependence score in [0,1] driven by (H₀(X) - Ĥ(X)) / H₀(X), where H₀ is the order-0 / empirical entropy and Ĥ is the entropy rate produced by this context’s rate backend.

pub fn try_resistance_to_transformation_bytes( &self, x: &[u8], tx: &[u8], ) -> InfotheoryResult<f64>

Resistance-to-transformation ratio I(X;T(X))/H(X) in [0,1] under this context’s rate backend.

Trait Implementations

impl Clone for InfotheoryCtx

fn clone(&self) -> InfotheoryCtx

Returns a duplicate of the value.

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

Performs copy-assignment from source.