Note

This documentation is for a development version. Click here for the latest stable release (v1.1.0).

AlgebrasΒΆ

NengoSPA uses elementwise addition for superposition and circular convolution for binding (CircularConvolutionAlgebra) by default. However, other choices are viable. In NengoSPA we call such a specific choice of such operators an algebra. It is easy to change the algebra that is used by NengoSPA as it is tied to the vocabulary. To use a different algebra, it suffices to manually create a vocabulary with the desired algebra and use this in your model:

import nengo
import nengo_spa as spa

vocab = spa.Vocabulary(64, algebra=spa.algebras.VtbAlgebra())

with spa.Network() as model:
    a = spa.State(vocab)
    b = spa.State(vocab)
    c = spa.State(vocab)
    a * b >> c

In this example the VtbAlgebra (vector-derived transformation binding, VTB) is used to bind a and b.

Note that circular convolution is commutative, i.e. \(a \circledast b = b \circledast a\), but this is not true for all algebras. In particular, the VTB is not commutative. That means you have to pay attention from which side vectors are bound and unbound. Moreover, when given \(\mathcal{B}(\mathcal{B}(a, b), c)\), it is not possible to directly unbind \(a\), but \(c\) has to be unbound first because VTB is not associative.

Custom algebras can be implemented by implementing the AbstractAlgebra interface. The process involves implementing math versions of the superposition and binding operator, functions for obtaining specific matrices (such as inverting a vector), functions for obtaining special elements like the identity vector, and functions to provide neural implementations of the superposition and binding. A partial implementation is possible, but will prevent the usage of certain parts of NengoSPA. For example, when not providing neural implementations, only non-neural math can be performed.