Struct SubstrateEngine 

pub struct SubstrateEngine { /* private fields */ }

The substrate engine: N atoms, a layout, and physics parameters. Single-owner — WASM is single-threaded so this is safe as a JS-side object.

Implementations

impl SubstrateEngine

pub fn new(n: usize, full_layout: bool, k_base: f32, gravity_scale: f32) -> Self

Create a new substrate with n atoms. full_layout: true = all 4 projections (1592 bytes/atom), false = minimal Splat+Kuramoto (1548 bytes/atom).

pub fn tick( &mut self, bass: f32, mid: f32, high: f32, entropy: f32, dt: f32, ) -> [f32; 4]

Run one physics step. Returns [R, entropy, converged (0.0/1.0), step].

pub fn phases(&self) -> Vec<f32>

Read all Kuramoto phases as a flat f32 array.

pub fn witness_array(&self) -> [f32; 4]

Current witness as [R, entropy, converged, step].

pub fn set_embedding(&mut self, index: usize, embedding: &[f32]) -> bool

Set the 384-dim embedding for atom at index. Returns false if index out of bounds or embedding wrong length.

pub fn set_phase(&mut self, index: usize, theta: f32, omega: f32) -> bool

Set Kuramoto phase and natural frequency for atom at index.

pub fn set_expert( &mut self, index: usize, intent: f32, activation: f32, gate: f32, ) -> bool

Set expert projection (intent routing) for atom at index.

pub fn set_neighbor( &mut self, index: usize, slot: usize, neighbor_index: u16, ) -> bool

Set graph neighbor at a slot for atom at index.

pub fn atom_count(&self) -> usize

Number of atoms.

pub fn step_count(&self) -> u32

Current step number.

pub fn stride(&self) -> usize

Stride in bytes per atom.

pub fn converged(&self) -> bool

Whether the substrate has converged (R >= 0.9).

pub fn order_parameter(&self) -> f32

Current order parameter R.

pub fn embeddings_flat(&self) -> Vec<f32>

All embeddings as a flat f32 array (n * 384 elements).

pub fn extract_sematon(&self, source: &str) -> String

Extract a sematon from the current substrate state. Payload = centroid embedding. Returns JSON string of FoldedSematon.

pub fn atom_shape_hash(&self, index: usize) -> Option<u32>

Read the shape hash for atom at index.

pub fn set_coupling_params(&mut self, k_base: f32, gravity_scale: f32)

Update coupling parameters (k_base, gravity_scale).