Struct SubstrateImpl 

pub struct SubstrateImpl { /* private fields */ }

In-memory substrate implementation.

The substrate is the extracellular matrix — the shared environment all agents sense and modify. It holds signals (for chemotaxis), a knowledge graph (for stigmergy and Hebbian wiring), and traces (for indirect coordination).

Implementations

impl SubstrateImpl

pub fn new() -> Self

pub fn get_document(&self, id: &DocumentId) -> Option<&Document>

Get a document by ID (convenience method bypassing trait).

pub fn all_documents(&self) -> Vec<&Document>

Get all documents (convenience method).

pub fn graph(&self) -> &PetTopologyGraph

Get a reference to the underlying topology graph.

pub fn graph_mut(&mut self) -> &mut PetTopologyGraph

Get a mutable reference to the underlying topology graph.

pub fn all_signals(&self) -> &[Signal]

Get all signals (for diagnostics/visualization).

pub fn total_trace_count(&self) -> usize

Total number of traces across all locations.

pub fn traces_near( &self, position: &Position, radius: f64, trace_type: &TraceType, ) -> Vec<&Trace>

Get all traces of a given type within a radius of a position.

Trait Implementations

impl Default for SubstrateImpl

fn default() -> Self

Returns the “default value” for a type.

impl Substrate for SubstrateImpl

fn signals_near(&self, position: &Position, radius: f64) -> Vec<&Signal>

Read all signals within a radius of a position.

fn emit_signal(&mut self, signal: Signal)

Emit a signal into the substrate.

fn decay_signals(&mut self, rate: f64, removal_threshold: f64)

Decay all signals by a rate (0.0-1.0). Signals below threshold are removed.

fn add_node(&mut self, data: NodeData) -> NodeId

Add a node to the knowledge graph.

fn get_node(&self, id: &NodeId) -> Option<&NodeData>

Get a node by ID.

fn set_edge(&mut self, from: NodeId, to: NodeId, data: EdgeData)

Add or update an edge between two nodes.

fn get_edge(&self, from: &NodeId, to: &NodeId) -> Option<&EdgeData>

Get edge data between two nodes.

fn neighbors(&self, node: &NodeId) -> Vec<(NodeId, &EdgeData)>

Get all neighbors of a node with their edge data.

fn remove_edge(&mut self, from: &NodeId, to: &NodeId)

Remove an edge.

fn all_nodes(&self) -> Vec<NodeId>

Get all node IDs.

fn all_edges(&self) -> Vec<(NodeId, NodeId, &EdgeData)>

Get all edges as (from, to, data) triples.

fn node_count(&self) -> usize

Number of nodes in the graph.

fn edge_count(&self) -> usize

Number of edges in the graph.

fn deposit_trace(&mut self, location: &SubstrateLocation, trace: Trace)

Deposit a trace at a location.

fn traces_at(&self, location: &SubstrateLocation) -> Vec<&Trace>

Read traces at a location.

fn decay_traces(&mut self, rate: f64, removal_threshold: f64)

Decay all traces by a rate. Traces below threshold are removed.

fn add_document(&mut self, doc: Document)

Place a document in the substrate.

fn get_document(&self, id: &DocumentId) -> Option<&Document>

Get a document by ID.

fn undigested_documents(&self) -> Vec<&Document>

Get all undigested documents.

fn consume_document(&mut self, id: &DocumentId) -> Option<String>

Mark a document as digested and return its content.

fn all_documents(&self) -> Vec<&Document>

Get all documents.

fn current_tick(&self) -> Tick

Current simulation tick.

fn advance_tick(&mut self)

Advance the tick counter.