ruvector_consciousness/lib.rs
1#![allow(
2 clippy::needless_borrow,
3 clippy::needless_range_loop,
4 clippy::manual_memcpy,
5 clippy::never_loop,
6 clippy::mutable_key_type,
7 clippy::mut_from_ref,
8 dead_code,
9 unused_variables
10)]
11//! # ruvector-consciousness — SOTA Consciousness Metrics
12//!
13//! Ultra-optimized Rust implementation of consciousness computation:
14//!
15//! | Module | Algorithm | Complexity |
16//! |--------|-----------|-----------|
17//! | [`phi`] | IIT Φ (exact) | O(2^n · n²) |
18//! | [`phi`] | IIT Φ (spectral) | O(n² log n) |
19//! | [`phi`] | IIT Φ (stochastic) | O(k · n²) |
20//! | [`emergence`] | Causal emergence / EI | O(n³) |
21//! | [`collapse`] | Quantum-inspired MIP search | O(√N · n²) |
22//!
23//! # Features
24//!
25//! - **SIMD-accelerated** KL-divergence, entropy, dense matvec (AVX2)
26//! - **Zero-alloc** hot paths via bump arena
27//! - **Sublinear** partition search via spectral and quantum-collapse methods
28//! - **Auto-selecting** algorithm based on system size
29//!
30//! # Example
31//!
32//! ```rust
33//! use ruvector_consciousness::types::{TransitionMatrix, ComputeBudget};
34//! use ruvector_consciousness::phi::auto_compute_phi;
35//!
36//! // 4-state system (2 binary elements)
37//! let tpm = TransitionMatrix::new(4, vec![
38//! 0.5, 0.25, 0.25, 0.0,
39//! 0.5, 0.25, 0.25, 0.0,
40//! 0.5, 0.25, 0.25, 0.0,
41//! 0.0, 0.0, 0.0, 1.0,
42//! ]);
43//!
44//! let result = auto_compute_phi(&tpm, Some(0), &ComputeBudget::exact()).unwrap();
45//! println!("Φ = {:.6}, algorithm = {}", result.phi, result.algorithm);
46//! ```
47
48pub mod arena;
49pub mod error;
50pub mod simd;
51pub mod traits;
52pub mod types;
53
54#[cfg(feature = "phi")]
55pub mod phi;
56
57#[cfg(feature = "phi")]
58pub mod geomip;
59
60#[cfg(feature = "emergence")]
61pub mod emergence;
62
63#[cfg(feature = "emergence")]
64pub mod rsvd_emergence;
65
66#[cfg(feature = "collapse")]
67pub mod collapse;
68
69#[cfg(feature = "parallel")]
70pub mod parallel;
71
72#[cfg(feature = "solver-accel")]
73pub mod sparse_accel;
74
75#[cfg(feature = "mincut-accel")]
76pub mod mincut_phi;
77
78#[cfg(feature = "math-accel")]
79pub mod chebyshev_phi;
80
81#[cfg(feature = "coherence-accel")]
82pub mod coherence_phi;
83
84#[cfg(feature = "witness")]
85pub mod witness_phi;
86
87// IIT 4.0 / SOTA modules
88#[cfg(feature = "phi")]
89pub mod iit4;
90
91#[cfg(feature = "phi")]
92pub mod ces;
93
94#[cfg(feature = "phi")]
95pub mod phi_id;
96
97#[cfg(feature = "phi")]
98pub mod pid;
99
100#[cfg(feature = "phi")]
101pub mod streaming;
102
103#[cfg(feature = "phi")]
104pub mod bounds;