qualia_core_db/modalities/
diffusion.rs1use crate::NQuin;
2
3pub fn trigger_diffusion(graph_id: &str) -> bool {
7 !graph_id.is_empty()
8}
9
10#[cfg(feature = "gpu-runtime")]
11pub async fn execute_diffusion_pass(graph: &mut [NQuin]) -> Result<(), String> {
13 etalon_wgsl_forge::numerical::compute_passes::storage::execute_storage_pass(
14 bytemuck::cast_slice_mut(graph),
15 include_str!("../shaders/diffusion.wgsl"),
16 )
17 .await
18}
19
20#[cfg(not(feature = "gpu-runtime"))]
21pub async fn execute_diffusion_pass(_graph: &mut [NQuin]) -> Result<(), String> {
23 Ok(())
24}
25
26pub fn diffuse_step(beliefs: &[f32], edges: &[(usize, usize)], rate: f32, out: &mut [f32]) -> bool {
37 let n = beliefs.len();
38 if out.len() < n {
39 return false;
40 }
41 for i in 0..n {
42 let mut sum = 0.0f32;
43 let mut deg = 0u32;
44 for &(a, b) in edges {
45 if a == i {
46 sum += beliefs[b];
47 deg += 1;
48 } else if b == i {
49 sum += beliefs[a];
50 deg += 1;
51 }
52 }
53 out[i] = if deg == 0 {
54 beliefs[i]
55 } else {
56 let avg = sum / deg as f32;
57 beliefs[i] + rate * (avg - beliefs[i])
58 };
59 }
60 true
61}
62
63#[inline]
66pub fn inject_energy(belief: f32, energy: f32) -> f32 {
67 (belief + energy).clamp(0.0, 1.0)
68}
69
70pub fn anneal_accept(delta: f32, temperature: f32, rand01: f32) -> bool {
73 if delta <= 0.0 {
74 return true;
75 }
76 if temperature <= 0.0 {
77 return false;
78 }
79 rand01 < (-delta / temperature).exp()
80}
81
82#[inline]
84pub fn cool(temperature: f32, cooling_rate: f32) -> f32 {
85 temperature * cooling_rate
86}
87
88#[cfg(test)]
89mod tests {
90 use super::*;
91 use crate::NQuin;
92
93 #[test]
94 fn cpu_belief_diffusion_moves_toward_neighbours() {
95 let beliefs = [1.0f32, 0.0, 0.0];
97 let edges = [(0usize, 1usize), (1, 2)];
98 let mut out = [0.0f32; 3];
99 assert!(diffuse_step(&beliefs, &edges, 0.5, &mut out));
100 assert!((out[0] - 0.5).abs() < 1e-6);
102 assert!((out[1] - 0.25).abs() < 1e-6);
104 assert!((out[2] - 0.0).abs() < 1e-6);
106 }
107
108 #[test]
109 fn energy_injection_and_annealing() {
110 assert!((inject_energy(0.6, 0.5) - 1.0).abs() < 1e-6, "clamps to 1");
111 assert!((inject_energy(0.2, 0.3) - 0.5).abs() < 1e-6);
112 assert!(anneal_accept(-1.0, 1.0, 0.99));
114 assert!(
115 anneal_accept(1.0, 10.0, 0.5),
116 "hot → likely accept an uphill move"
117 );
118 assert!(
119 !anneal_accept(5.0, 0.01, 0.5),
120 "cold → reject an uphill move"
121 );
122 assert!(
123 !anneal_accept(1.0, 0.0, 0.0),
124 "zero temperature → no uphill moves"
125 );
126 assert!((cool(10.0, 0.9) - 9.0).abs() < 1e-6);
128 }
129
130 #[test]
131 fn test_execute_diffusion_pass() {
132 let mut graph = vec![NQuin::default(); 10];
133
134 graph[0].subject = 2; graph[1].subject = 3; let res = pollster::block_on(async { execute_diffusion_pass(&mut graph).await });
141 assert!(res.is_ok());
142
143 #[cfg(feature = "gpu-runtime")]
144 {
145 assert_eq!(graph[0].subject, 4294967299);
147 assert_eq!(graph[1].subject, 4294967299);
149 }
150 #[cfg(not(feature = "gpu-runtime"))]
151 {
152 assert_eq!(graph[0].subject, 2);
153 assert_eq!(graph[1].subject, 3);
154 }
155 }
156}