ruvector-consciousness 2.1.0

SOTA consciousness metrics: IIT Φ computation, causal emergence, effective information with SIMD acceleration and sublinear approximations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

//! Error types for consciousness computation.

use std::time::Duration;

/// Primary error type for consciousness computations.
#[derive(Debug, thiserror::Error)]
pub enum ConsciousnessError {
    /// Φ computation did not converge within budget.
    #[error("phi did not converge after {iterations} iterations (current={current:.6}, delta={delta:.2e})")]
    PhiNonConvergence {
        iterations: usize,
        current: f64,
        delta: f64,
    },

    /// Numerical instability (NaN/Inf in matrix operations).
    #[error("numerical instability at partition {partition}: {detail}")]
    NumericalInstability { partition: usize, detail: String },

    /// Compute budget exhausted.
    #[error("budget exhausted: {reason}")]
    BudgetExhausted { reason: String, elapsed: Duration },

    /// Invalid input.
    #[error("invalid input: {0}")]
    InvalidInput(#[from] ValidationError),

    /// System too large for exact computation.
    #[error("system size {n} exceeds exact limit {max} — use approximate mode")]
    SystemTooLarge { n: usize, max: usize },
}

/// Validation errors raised before computation.
#[derive(Debug, thiserror::Error)]
pub enum ValidationError {
    #[error("dimension mismatch: {0}")]
    DimensionMismatch(String),

    #[error("non-finite value at element ({row}, {col})")]
    NonFiniteValue { row: usize, col: usize },

    #[error("TPM rows must sum to 1.0 (row {row} sums to {sum:.6})")]
    InvalidTPM { row: usize, sum: f64 },

    #[error("parameter out of range: {name} = {value} (expected {expected})")]
    ParameterOutOfRange {
        name: String,
        value: String,
        expected: String,
    },

    #[error("empty system: need at least 2 elements")]
    EmptySystem,
}

pub type Result<T> = std::result::Result<T, ConsciousnessError>;