Skip to content

Commit

Permalink
Merge branch 'network-schema-io' into Develop
Browse files Browse the repository at this point in the history
  • Loading branch information
Mark Plagge committed Apr 13, 2017
2 parents ef50357 + 3cedd59 commit 587da75
Show file tree
Hide file tree
Showing 46 changed files with 7,930 additions and 304 deletions.
1 change: 1 addition & 0 deletions .gitignore
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ compile_commands.json

.idea/NeMo.iml


\.idea/

__pycache__/
Expand Down
6 changes: 6 additions & 0 deletions .gitmodules
View file
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
[submodule "ROSS"]
path = ROSS

url = https://github.com/carothersc/ROSS.git

[submodule "src/lib/c11t"]
path = src/lib/c11t
url = https://github.com/jtsiomb/c11threads.git

8 changes: 6 additions & 2 deletions CMakeLists.txt
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
cmake_minimum_required(VERSION 2.4)
cmake_minimum_required(VERSION 2.6)
project(SuperNeMo)
enable_testing()

Expand All @@ -7,12 +7,16 @@ set (ND "${CMAKE_CURRENT_SOURCE_DIR}/src/")

ADD_SUBDIRECTORY(${RD})
ADD_SUBDIRECTORY(${ND})
find_package(MPI REQUIRED)
include_directories(${MPI_INCLUDE_PATH})

SET(CMAKE_C_COMPILER mpicc)
SET(CMAKE_CXX_COMPILER mpicxx)
set_target_properties( NeMo
PROPERTIES
ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
LIBRARY_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib"
RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
)

configure_file("demo.csv" "${CMAKE_BINARY_DIR}/bin/demo.csv" COPYONLY)
#TODO: Add targets to the build-tree export set
1 change: 0 additions & 1 deletion README.md
View file
Original file line number Diff line number Diff line change
@@ -1,4 +1,3 @@
[![Stories in Ready](https://badge.waffle.io/markplagge/NeMo.png?label=ready&title=Ready)](https://waffle.io/markplagge/NeMo)
# *NeMo*: A Generic Neuromorphic Hardware Simulation Model built on top of ROSS

*NeMo* is a simulation model designed to allow experimentation with different neuromorphic hardware. Built on top of ROSS, *NeMo* features excellent scalability across HPC clusters. *NeMo* is targeted at current neuromorphic hardware designs, and as such currently simulates spiking neural networks in a grid layout, similar to the [IBM TrueNorth Processor](http://science.sciencemag.org/content/345/6197/668.short).
Expand Down
75 changes: 75 additions & 0 deletions api.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
#NeMo Data File Schema

**Network Design**

Network layout & design files allow the user to design a custom neuromorphic hardware
network. These files are plaintext files.

A file must have the following parameters:


* ns_cores: The total number of neurosynaptic cores contained within the simulation. *NeMo* simulates a
neuromorphic hardware processor, so this setting changes the number of cores contained within a single processor.
* neurons\_per\_core: The total number of neurons per neurosynaptic core.
The IBM TrueNorth processor, for example, contains 256 neurons per core.
If this value is set to 1, then NeMo will simulate a chip without a neurosynaptic core, though with some caveats.
**The number of neurons in the simulation is equal to neurons\_per\_core \* ns_cores.**
* neuron_weight_count: The number of weights each neuron can have. This value,
while able to be set to an arbitrary value, should generally be <= neurons\_per\_core,
unless the neurons per core value is 1.

After setting these values, the neuron layout can be defined. This layout consists of multiple lines of text, one per
user-defined neuron. Any neurons that exist in the simulation that do not have an explicitly configured line in this
file are set to a neuron with 0 weights - a disconnected neuron.

Any lines that begin with / are ignored.

The variables for this file are:

* neuron_type: the named type of the neuron. Currently supported are:

* "tn": the TrueNorth neuron
* "LIF": Standard leaky integrate and fire neuron

* neuron parameters: this is a comma separated list of the parameters needed to configure the specified neuron.
All parameters specified are required. For values specified here in the form of X<sub>j</sub><sup>G<sub>i</sub></sup>
must contain *neuron_weight_count* number of values. For example, if neuron_weight_count is 4, then
s<sub>j</sub><sup>Gi</sup> must have 4 parameters specified.
* As a note, all sign bits should be set to either -1 or 1. Zero will result in undefiend behavior.

| Parameter | Description |
|:-----------------: |:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
| coreID | The Neurosynaptic core the neuron is located in |
| neuronID | The local (core-wise) ID of the neuron. |
| [w<sub>i,j</sub>] | synapticConnectivity - A comma seperated list of Neuron _j_'s connectivity to synapse _i_. For example, a fully connected neuron would be: [1,1,1,1,1,1,1,1,1 ... 1,1]. |
| [G<sub>i</sub>] | A comma seperated list - the type of the _i_<sup> _th_</sup> axon. |
| [σ] | The sign modifier for the list of weights. W<sub>i</sub> = σ<sub>j</sub> * S<sub>j</sub> |
| [S] | The list of weights (default is four) |
| [b] | The weight mode selection parameters (default is four values). Selects stochastic weight mode. Binary value |
| ε | Monotonic / divergent / normal leak selection value |
| σ<sub>l</sub> | Sign modifier of the leak. Single value. |
| λ | Leak value. Must be positive if following TrueNorth specs. Leak = λ * σ<sub>l</sub> |
| c | |
| α<sub>j</sub> | The neuron's positive threshold |
| β<sub>jM</sub> | The neuron's negative threshold |
| TM | The threshold mask for stochastic modes |
| VR | The reset potential (encoded). Expands to σ<sup>VR</sup>(2<sup>VR</sup> -1) |
| σ VR | Reset potential sign bit |
| ɣ | Gamma value for neuron |
| ϰ | Kappa value for neuron |
| signal Delay | The TN signal delay. This is the number of TrueNorth ticks taken for this neuron's spike to be received |
| destCore | The neuron's destination neurosynaptic core. |
| destAxon | The neuron's destination axon. |

For the True North neuron, an example configuration line would be:
(given 256 neurons per core):
The file must start with the initial simulation parameters first, so first the simulation parameters are given, then a single TrueNorth neuron parameter is shown.

```
/Simulation parameter example;
1024
256
4
"tn",1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,3,4,4,2,3,1,4,0,4,3,3,0,4,1,1,0,3,0,4,3,0,4,4,1,4,3,4,0,3,4,3,1,4,2,2,2,3,3,2,3,4,4,2,1,0,4,4,2,3,3,2,4,4,4,2,0,0,4,1,1,1,3,0,3,3,3,3,4,0,4,0,0,3,3,2,1,1,2,3,0,0,2,2,2,3,0,0,1,0,0,1,0,4,0,2,4,1,2,2,2,3,0,0,3,0,2,2,4,1,4,1,4,1,2,2,4,4,0,2,4,3,3,1,4,4,3,0,3,4,0,4,1,1,4,3,1,1,2,3,3,1,1,2,3,0,0,1,3,4,0,3,4,3,0,1,1,3,3,3,0,2,4,0,0,0,1,3,1,2,0,4,1,1,1,2,4,0,2,1,4,1,4,1,2,0,4,1,2,3,1,3,2,4,4,1,3,1,0,0,3,2,3,0,2,3,2,0,1,4,0,0,4,2,3,4,4,4,2,1,3,1,4,3,0,1,0,2,1,1,3,4,3,1,3,0,0,4,4,2,0,2,3,2,2,0,0,3,1,4,4,1,1,0,0,4,4,1,-1,1,1,2,3,4,1,0,0,-10,10001,10001,0,0
```

Binary file added api_ref.xlsx
View file
Binary file not shown.
4 changes: 4 additions & 0 deletions csv_test.csv
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
"TN",0,0,1,2,4,5,1,-3
"TN",0,1,9,8,2,3,1,-1
"TN",1,0,1,2,3,4,5,60
"TN",1,5,0,0,0,0,0,99
Loading

0 comments on commit 587da75

Please sign in to comment.