Skip to content
self-organizing map (SOM) / Kohonen network
Branch: master
Clone or download
Latest commit bacabf6 Nov 23, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
test use ml-euclidean-distance Jul 11, 2015
.gitignore update project structure Feb 13, 2015
.npmignore update project structure Feb 13, 2015
.travis.yml Update .travis.yml Nov 23, 2016 update project structure Feb 13, 2015
LICENSE doc: fields syntax (#7) Sep 18, 2016


NPM version build status David deps npm download

self-organizing map (SOM) / Kohonen network


$ npm install ml-som


new SOM(x, y, [options])

Creates a new SOM instance with x * y dimensions.


  • x - Dimension of the x axis
  • y - Dimension of the y axis
  • options - Object with options for the algorithm


  • fields - Either a number (size of input vectors) or a map of field descriptions (to convert them to vectors)
  • iterations - Number of iterations over the training set for the training phase (default: 10). The total number of training steps will be iterations * trainingSet.length
  • learningRate - Multiplication coefficient for the learning algorithm (default: 0.1)
  • method - Iteration method of the learning algorithm (default: random)
  • random - Pick an object of the training set randomly
  • traverse - Go sequentially through the training set
  • randomizer - Function that must give numbers between 0 and 1 (default: Math.random)
  • distance - Function that computes the distance between two vectors of the same length (default: squared Euclidean distance)
  • gridType - Shape of the grid (default: rect)
  • rect - Rectangular grid
  • hexa - Hexagonal grid
  • torus - Boolean indicating if the grid should be considered a torus for the selection of the neighbors (default: true)


var SOM = require('ml-som');
var options = {
  fields: [
    { name: 'r', range: [0, 255] },
    { name: 'g', range: [0, 255] },
    { name: 'b', range: [0, 255] }

var som = new SOM(20, 20, options);


Train the SOM with the provided trainingSet.


  • trainingSet - Array of training elements. If the fields was a number, each array element must be a normalized vector. If it was an object, each array element must be an object with at least the described properties, within the described ranges


var trainingSet = [
  { r: 0, g: 0, b: 0 },
  { r: 255, g: 0, b: 0 },
  { r: 0, g: 255, b: 0 },
  { r: 0, g: 0, b: 255 },
  { r: 255, g: 255, b: 255 }



Returns a 2D array containing the nodes of the grid, in the structure described by the fields option.


Set the training set for use with the next method


Executes the next training iteration and returns true. Returns false if the training is over. Useful to draw the grid or compute some things after each learning step.


while(som.trainOne()) {
  var nodes = som.getConvertedNodes();
  // do something with the nodes

predict([data], [computePosition])

Returns for each data point the coordinates of the corresponding best matching unit (BMU) on the grid


  • data - Data point or array of data points (default: training set).
  • computePosition - True if you want to compute the position of the point in the cell, using the direct neighbors (default: false). This option is currently only implemented for rectangular grids.


// create and train the som
var result1 = som.predict({ r: 45, g: 209, b: 100 });
// result1 = [ 2, 26 ]
var result2 = som.predict([{ r: 45, g: 209, b: 100 }, { r: 155, g: 22, b: 12 }], true);
// result2 = [ [ 2, 26, [ 0.236, 0.694 ] ], [ 33, 12, [ 0.354, 0.152 ] ] ]


Returns an array of fit values which are the square root of the distance between the input vector and its corresponding BMU.


  • dataset - Array of vectors to for which to calculate fit values. Defaults to the training set.


Returns the mean of the fit values for the training set. This number can be used to compare several runs of the same SOM.


Returns a 2D array representing the grid. Each value is the mean of the distances between the corresponding node and its direct neighbors. Currently only available for square nodes


Exports the model to a JSON object that can be written to disk and reloaded

SOM.load(model, [distanceFunction])

Returns a new SOM instance based on the model. If the model was created with a custom distance function, the distance argument should be this function.


  • model - JSON object generated with som.export()
  • distanceFunction - Optionally provide the distance function used to create the model.



You can’t perform that action at this time.