Welcome to the NESTML documentation

NESTML is a domain-specific language that supports the specification of neuron models in a precise and concise syntax. It was developed to address the maintainability issues that follow from an increasing number of models, model variants, and an increased model complexity in computational neuroscience. Our aim is to ease the modelling process for neuroscientists both with and without prior training in computer science. This is achieved without compromising on performance by automatic source-code generation, allowing the same model file to target different hardware or software platforms by changing only a command-line parameter. While originally developed in the context of NEST Simulator, the language itself as well as the associated toolchain are lightweight, modular and extensible, by virtue of using a parser generator and internal abstract syntax tree (AST) representation, which can be operated on using well-known patterns such as visitors and rewriting. Model equations can either be given as a simple string of mathematical notation or as an algorithm written in the built-in procedural language. The equations are analyzed by the associated toolchain ODE-toolbox, to compute an exact solution if possible or to invoke an appropriate numeric solver otherwise.

Model development with NESTML

Summary of language features and syntax

The NESTML language

Models library

Out of the box, use any of over 20 models that come packaged with NESTML, from standard integrate-and-fire varieties to a family of biophysical, Hodgkin-Huxley type neurons.

Tutorials

NESTML language and toolchain development

PyNESTML is the Python-based toolchain for the NESTML language: it parses the model, invokes ODE-toolbox and performs code generation. Modify PyNESTML to add language elements such as new predefined functions, or to add new target platforms.

API documentation is automatically generated from source code: pynestml module index

Internally, the ODE-toolbox Python package is used for the processing of differential equations.

Getting help

Report bugs and request features

NEST draws its strength from the many people that use and improve it. We are happy to consider your contributions (e.g., new models, bug or documentation fixes) for addition to the official version of NEST.

If you find an error in the code or documentation or want to suggest a feature, submit an issue on GitHub at https://github.com/nest/nestml.

Make sure to check that your issue has not already been reported there before creating a new one.

Mailing list

The NEST users mailing list is intended to be a forum for questions on the usage of NEST, the exchange of code and general discussions about NEST. The philosophy is that all users profit by sharing their experience. All NEST core developers are subscribed to this list and will participate in the discussions as far as time allows.

By subscribing to the mailing list you will also get notified of all NEST related events!

Before submitting a question, please take a look at our guidelines for the NEST mailing list.