Crate neuropool 

neuropool

Biological neuron pool substrate for neuromorphic computing.

Provides LIF (Leaky Integrate-and-Fire) neurons with CSR-format synaptic connections, eligibility traces for STDP, three-factor plasticity gated by neuromodulators, and a thermal maturity lifecycle for synapses.

This crate replaces both the SNN dynamics engine and the thermogram weight store with a single unified substrate where neurons spike AND persist, and synapses conduct AND have thermal lifecycle.

Two Neuron Systems

Voxel Neurons (Legacy SNN)

The original tick-based system using NeuronType enum:

• pool::NeuronPool — synchronous tick() execution
• neuron::NeuronArrays — SoA storage with type flags
• synapse::SynapseStore — CSR format with i8 weights

Spatial Neurons (Biological)

The new event-driven system with real anatomy:

• spatial::SpatialNeuron — soma, dendrite, axon, nuclei
• spatial::Nuclei — capability machines, not enum categories
• spatial::SpatialSynapse — ternary signals (polarity × magnitude)
• cascade::CascadePool — event-driven execution

See spatial module for the biological neuron architecture.

Re-exports

pub use binding::BindingConfig;

pub use binding::BindingTable;

pub use cascade::CascadeConfig;

pub use cascade::CascadePool;

pub use cascade::SpikeArrival;

pub use density::Conductivity;

pub use density::DensityField;

pub use density::TissueType;

pub use io::NeuronIO;

pub use io::NullIO;

pub use neuron::NeuronArrays;

pub use neuron::NeuronProfile;

pub use neuron::NeuronType;

pub use plasticity::GrowthResult;

pub use pool::BindingSpec;

pub use pool::EvolutionConfig;

pub use pool::EvolutionResult;

pub use pool::FitnessInput;

pub use pool::GrowthConfig;

pub use pool::MutationEntry;

pub use pool::MutationJournal;

pub use pool::MutationType;

pub use pool::NeuronPool;

pub use pool::PoolCheckpoint;

pub use pool::PoolConfig;

pub use pool::SpatialDims;

pub use pool::TypeDistributionSpec;

pub use stats::PoolStats;

pub use stats::ThermalDistribution;

pub use stats::TypeDistribution;

pub use synapse::Synapse;

pub use synapse::SynapseStore;

pub use synapse::ThermalState;

pub use template::SignalType;

pub use template::TemplateType;

pub use template::TemplateRequest;

pub use template::TemplateInstance;

pub use template::TemplateRegistry;

pub use template::SpatialArrangement;

pub use spatial::Axon;

pub use spatial::Dendrite;

pub use spatial::EnergyGates;

pub use spatial::Interface;

pub use spatial::InterfaceAction;

pub use spatial::MasteryConfig;

pub use spatial::MasteryState;

pub use spatial::Nuclei;

pub use spatial::PolarityChange;

pub use spatial::SpatialNeuron;

pub use spatial::SpatialSynapse;

pub use spatial::Soma;

pub use spatial::SpatialRuntime;

pub use spatial::SpatialRuntimeConfig;

pub use spatial::WiringConfig;

pub use spatial::wire_by_proximity;

Modules

binding

Binding configuration for specialized neurons.

cascade

Event-driven cascade execution model.

codec

Binary .pool persistence format.

density

Density Field — grid-based soma density for spatial queries.

io

External I/O trait for specialized neurons.

neuron

Neuron data structures — SoA (Structure of Arrays) layout for cache performance.

plasticity

Three-factor plasticity — the core credit assignment mechanism.

pool

NeuronPool — the top-level container and tick loop.

spatial

Spatial Neurons — Biologically Accurate Point-Cloud Neurons

stats

Pool inspection and diagnostics.

synapse

Synapse data structures — 8-byte compact synapses with CSR storage.

template

Computational Templates (Circuit Motifs)

Structs

Signal

Signal: polarity + magnitude (s = p × m)

Enums

Polarity

Polarity of a neural signal — strictly {-1, 0, +1}