Neural Stack API
Warning
This API is deprecated since v1.5.2, users are advised to use the new Tensorflow API.
Summary
In v1.4.2, the neural stack API was introduced. It defines some primitives for modular construction of neural networks. The main idioms will be computational layers & stacks.
The neural stack API extends these abstract skeletons by defining two kinds of primitives.
 Computational layers: Defining how inputs are propagated forward;
NeuralLayer
 Activation functions:
Activation[I]
 Computational stacks: composed of a number of layers;
GenericNeuralStack
Note
The classes NeuralLayer
and GenericNeuralStack
define layers and stacks in an abstract manner, meaning that the parameters could be in principle of any type.
The key point to understand is that once a layer or stack is defined, it is immutable i.e. the parameters defining its forward computation can't be changed.
The API rather provides factory objects which can spawn a particular layer or stack with any parameter assignments.
Activation Functions¶
Activation functions are implemented using the Activation[I]
object, its apply
method requires two
arguments.
 Implementation of the activation
 Implementation of the derivative of the activation.
1 2 3 4 5 6  //Define forward mapping val actFunc: (I) => I = _ //Define derivative of forward mapping val gradAct: (I) => I = _ val act = Activation(actFunc, gradAct) 
The dynaml.models.neuralnets
package also contains implementation of the following activations.

Sigmoid g(x) = \frac{1}{1 + exp(x)}
val act = VectorSigmoid

Tanh g(x) = tanh(x)
val act = VectorTansig

Linear g(x) = x
val act = VectorLinear

Rectified Linear g(x) = \begin{cases} x & x \geq 0\\0 & else\end{cases}
val act = VectorRecLin
Computational Layers¶
Computational layers are the most basic unit of neural networks. They define transformations of their inputs and with that define the forward data flow.
Every computational layer generally has a set of parameters describing how this transformation is going to be calculated given the inputs.
In DynaML, the central component of the NeuralLayer[Params, Input, Output]
trait is a MetaPipe[Params, Input, Output]
(higher order pipe) instance.
Creating Layers.¶
Creating an immutable computational layer can be done using the NeuralLayer
object.
1 2 3 4 5 6 7 8 9 10 11  import scala.math._ val compute = MetaPipe( (params: Double) => (x: Double) => 2d*Pi*params*x ) val act = Activation( (x: Double) => tanh(x), (x: Double) => tanh(x)/(sinh(x)*cosh(x))) val layer = NeuralLayer(compute, act)(0.5) 
Vector feed forward layers
A common layer is the feed forward vector to vector layer which is given by. $$ \mathbf{h} = \sigma(\mathbf{W} \mathbf{x} + \mathbf{b}) $$
Layer Factories.¶
Since the computation and activation are the only two relevant inputs required to spawn any computational layer, the NeuralLayerFactory[Params, Input, Output]
class is the factory for creating layers on the fly. Layer factories are data pipes which take the layer parameters as input and create computational layers on demand.
A layer factory can be created as follows.
1 2 3  val fact = NeuralLayerFactory(compute, act) val layer1 = fact(0.25) 
Vector layer factory
Vector layers can be created using the Vec2VecLayerFactory
1 2  val layerFactory = new Vec2VecLayerFactory(VectorTansig)(inDim = 4, outDim = 5) 
Neural Stacks¶
A neural stack is a sequence of computational layers. Every layer represents some computation, so the neural stack is nothing but a sequence of computations or forward data flow. The top level class for neural stacks is GenericNeuralStack
. Extending the base class there are two stack implementations.

Eagerly evaluated stack: Layers are spawned as soon as the stack is created.
1 2 3 4 5 6
val layers: Seq[NeuralLayer[P, I, I]] = _ //Variable argument apply function //so the elements of the sequence //must be enumerated. val stack = NeuralStack(layers:_*)

Lazy stack: Layers are spawned only as needed, but once created they are memoized.
1 2 3
val layers_func: (Int) => NeuralLayer[P, I, I] = _ val stack = LazyNeuralStack(layers_func, num_layers = 4)
Stack Factories¶
Stack factories like layer factories are pipe lines, which take as input a sequence of layer parameters and return a neural stack of the spawned layers.
1 2 3 4 5 6 7 8 9 10 11 12  val layerFactories: Seq[NeuralLayerFactory[P, I, I]] = _ //Create a stack factory from a sequence of layer factories val stackFactory = NeuralStackFactory(layerFactories:_*) //Create a stack factory that creates //feed forward neural stacks that take as inputs //breeze vectors. //Input, Hidden, Output val num_units_by_layer = Seq(5, 8, 3) val acts = Seq(VectorSigmoid, VectorTansig) val breezeStackFactory = NeuralStackFactory(num_units_by_layer)(acts) 