N2S3.md

 ### Description
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque eu lorem eu tellus tempor eleifend. Morbi suscipit eu neque sollicitudin posuere. Suspendisse vel imperdiet velit. Aliquam nibh lectus, viverra sagittis ullamcorper at, molestie a dui. Vestibulum nec nulla elit. Sed mollis lacinia bibendum. Aenean tortor odio, varius non placerat eu, sodales in ipsum. Praesent finibus nisl eget hendrerit euismod. Morbi sit amet libero eget ante blandit lobortis. Nullam porttitor ac quam sed mattis. Aliquam id varius nulla.
+N2S3 is an open-source neuromorphic hardware simulator with the following properties:
 
-Nam sagittis augue vel imperdiet rutrum. Ut ornare est quis feugiat placerat. Praesent lacus massa, posuere non diam accumsan, posuere sollicitudin purus. Fusce pharetra nunc quis dolor gravida, ut faucibus enim venenatis. Nam ultricies ex ac risus tincidunt pellentesque. Nam facilisis dui quis leo porta mollis. Curabitur a feugiat ipsum. Suspendisse potenti. Fusce suscipit sem nec placerat vehicula. Suspendisse mauris diam, imperdiet ac suscipit quis, semper ac sem. Vivamus porta, dolor vel mattis rutrum, nisi lorem sodales eros, id congue dolor erat sit amet lectus. Sed vitae quam eu magna aliquam iaculis sit amet et justo. Nam scelerisque laoreet justo, ac mattis est finibus sed.
+- **Event-Based**: Event based processing, in contrast to clock-based processing allows the local processing of each event, and high accuracy of timestamp.
+- **Scalable**: N2S3 uses the Akka project to enable massively concurrent programming. All simulator entities are (potentially) actors. This model fits well with the neural network processing paradigm. Thus a simulation is concurrent and can be distributed on a cluster.
+- **Extensible**: N2S3 is designed to easily integrate new models and tools.
+- **Portable**: N2S3 is written in the Scala programming language. It can thus run on any computer compatible with the Java Virtual Machine.
+- **Open-Source**: This project is under the CECILL-B licence.
 
-Aenean purus nunc, cursus nec purus sit amet, pharetra rhoncus ligula. Curabitur feugiat sed nulla eu semper. Nulla eget ipsum sit amet metus lacinia lacinia. Aenean imperdiet enim mauris, nec pellentesque mauris iaculis sed. Ut accumsan quam vel congue egestas. Nullam pretium diam vel sagittis maximus. Etiam vestibulum suscipit facilisis. Nulla id iaculis neque. Fusce leo elit, vulputate et risus et, consequat venenatis metus. Praesent ultrices ligula quis faucibus viverra. Duis pretium tellus metus, non egestas nulla condimentum ut. Cras tincidunt mauris eget aliquet faucibus. Duis at ex id ligula iaculis tristique et a nulla. Proin hendrerit pellentesque dolor, sit amet ultrices est venenatis nec. Duis vehicula ligula sit amet vehicula viverra. Sed facilisis tellus dolor, a molestie libero iaculis vel.
+### Different Network Topologies in N2S3
+Each application requires an adapted network topology. E.g.,
+- Feed Forward Neural Networks
+- Convolutional Neural Networks
+- Reservoir Computing (in progress)
 
+### Currently working Input Formats
+N2S3 is already integrated with the following input formats:
+
+- Address Event Representation (AER)
+- MNIST
+
+And can be easily extended to read new formats.
 ### Installation
+If this is your first N2S3 installation, you may need to set up you Scala environment. All this boils down to installing Java (which you probably have already installed) and then installing sbt. Sbt will manage the installation of the correct scala version for N2S3 and all its dependencies. Additionally, N2S3's code is stored in a git repository. You need to install git in your machine to be able to load the latest version, or to be able to contribute. Otherwise, you'll need to download a released version.
+
+Follow the up-to-date installation instructions of Java and sbt in your own platform.
+
+- [Install Java](https://www.java.com/en/download/help/download_options.html)
+- [Install sbt](https://www.scala-sbt.org/download.html)
+
+More details can be found in the repo:
+https://gitlab.univ-lille.fr/bioinsp/n2s3
 
 ## Useful Scripts
 
@@ -18,5 +42,9 @@ Aenean purus nunc, cursus nec purus sit amet, pharetra rhoncus ligula. Curabitur
 -->
 
 ## Official Documentation
+Neural Network Scalable Spiking Simulator Documentation: \
+https://sourcesup.renater.fr/wiki/n2s3/
+
+## References
 
-## References
\ No newline at end of file
+[^1]: Pierre Boulet, Philippe Devienne, Pierre Falez, Guillermo Polito, Mahyar Shahsavari, et al.. N2S3, an Open-Source Scalable Spiking Neuromorphic Hardware Simulator. [Research Report] Université de Lille 1, Sciences et Technologies; CRIStAL UMR 9189. 2017
\ No newline at end of file