Metadata-Version: 2.1
Name: simsnn
Version: 1.0.1
Summary: Radboud Spiking Neural Network Simulator
Project-URL: Homepage, https://gitlab.socsci.ru.nl/snnsimulator/simsnn
Project-URL: Bug Tracker, https://gitlab.socsci.ru.nl/snnsimulator/simsnn/-/issues
Author-email: Arne Diehl <arne.diehl@donders.ru.nl>
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# SimSNN

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT) 
[![Python 3.6+](https://img.shields.io/badge/python-3.6-blue.svg)](https://www.python.org/downloads/release/python-360/)

A spiking neural network simulator developed and maintained by Radboud University staff and students.

## Requirements
To run the program, make sure you have installed the dependencies listed in environment.yml. 
We recommend creating a conda environment for every project. You can do this with the following command:
`conda env create --file environment.yml`

## Usage

### On Google Colab

Click on the badge to open the notebook in google colab. Then run every cell to see the example output. [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adiehl96/SNN-computing/blob/master/example.ipynb)


### Locally using jupyter notebooks
Clone this repository or download the zipped version. Unzip and open a terminal in the project directory. From there you can install the conda requirements, as mentioned before. You can also run the notebook by running 

`jupyter lab ./example.ipynb` 


### Locally from the command line
To run the example network, located in the examples directory, open up a terminal in the project directory and run the following command: 

`python -m simsnn`

You should be presented with a read out from the connected measuring tools like this:

![Default Readout](defaultreadout.png)
(see [homepage](https://gitlab.socsci.ru.nl/neuromorphiccomputing/simsnn) if the image doesn't render correctly.)
