Need private packages and team management tools?Check out npm Teams »

intuitive-neural-network

0.8.0 • Public • Published

Build Status

Intuitive Neural Network

When you would like to understand what's going on without the mathematics!

A JavaScript based, object-orientated approach to a Neural Network library.

The two aims behind creating this library are:

  1. Intuition - To create a neural network library that is intuitive, breaking away from the mathematical representations of neural networks, and allowing them to be represented as an actual 'network' of neurons firing down synapses and activating one-another.
  2. Built with JavaScript - More accessable. JavaScript copes well with running neural networks, even with a less mathematical, more object-orientated approach.

Run the XOR example with npm test


A Simple Implementation (XOR Problem)

// Build the network...
var network = new Network({
    layers: [2,2,1],
    bias: false
});

// Training data (x in, y out)
var data = [
    {x: [0,0], y: [0]},
    {x: [0,1], y: [1]},
    {x: [1,0], y: [1]},
    {x: [1,1], y: [0]}
];

// Training the network...
var epochs = 10000;
var learningRate = 0.01;

for (var h = 0; h < epochs; h++) {

    for (var i = 0; i < data.length; i++) {

        let index = Math.floor(Math.random() * data.length);
        
        network
            .fire(data[index].x)
            .backPropagate(data[index].y)
            .applyError(learningRate)
            .reset();

    }
}
// Done.

// Testing the trained network...
for(var i = 0; i < data.length; i++) {

    network.fire(data[i].x);

    var activation = network.layers[network.layers.length-1].neurons[0].activation;

    // expect Math.round(activation) to equal data[i].y[0]

    network.reset();

}
// Done.

Network

Kind: global class

new Network(settings)

Constructor for Network

Param Type
settings object

network.fire(signals) ⇒

Fire the input layer's Neurons with supplied array of floats

Kind: instance method of Network
Returns: Network (for chaining purposes)

Param Type
signals array

network.backPropagate(errors) ⇒

Initialise back propagation through network with supplied array of floats

Kind: instance method of Network
Returns: Network (for chaining purposes)

Param Type
errors array

network.applyError(learningRate) ⇒

Trigger each synapse to apply its error to its weight

Kind: instance method of Network
Returns: Network (for chaining purposes)

Param Type
learningRate float

network.reset() ⇒

Reset all the Neurons and Synapses back to their initial state

Kind: instance method of Network
Returns: Network (for chaining purposes)

Install

npm i intuitive-neural-network

DownloadsWeekly Downloads

1

Version

0.8.0

License

MIT

Unpacked Size

49.5 kB

Total Files

24

Last publish

Collaborators

  • avatar