Ubuntu / Debian Installation¶
The following are the basic steps to compile and install NEST from source code:
- For most users, the following additional packages will likely be needed (see also the Dependencies section)
sudo apt-get install -y build-essential cmake libltdl7-dev libreadline6-dev \ libncurses5-dev libgsl0-dev python-all-dev python-numpy python-scipy \ python-matplotlib ipython openmpi-bin libopenmpi-dev python-nose
- Unpack the tarball
tar -xzvf nest-simulator-x.y.z.tar.gz
- Create a build directory:
- Change to the build directory:
- Configure NEST:
cmake -DCMAKE_INSTALL_PREFIX:PATH=</install/path> </path/to/NEST/src>
/install/path should be an absolute path
You may need additional
cmake options and you can find the configuration options here
- Compile and install NEST:
make make install make installcheck
NEST should now be successfully installed on your system. You should now be able to
import nest from a python or ipython shell.
If your operating system does not find the
nest executable or if Python does not find the
nest module, your path variables may not be set correctly. This may also be the case if Python cannot load the
nest module due to missing or incompatible libraries. In this case, please run:
to set the necessary environment variables. You may want to include this line in your
.bashrc file, so that the environment variables are set automatically.
See the Getting started pages to find out how to get going with NEST or check out our example networks.
NEST requires at least version v2.8.12 of cmake, but we recommend v3.4 or later. You can type
cmake --version on the commandline to check your current version.
The GNU readline library is recommended if you use NEST interactively without Python. Although most Linux distributions have GNU readline installed, you still need to install its development package if want to use GNU readline with NEST. GNU readline itself depends on libncurses (or libtermcap on older systems). Again, the development packages are needed to compile NEST.
The GNU Scientific Library is needed by several neuron models, in particular those with conductance based synapses. If you want these models, please install the GNU Scientific Library along with its development packages.
If you want to use PyNEST, we recommend to install the following along with their development packages:
What gets installed where¶
By default, everything will be installed to the subdirectories
/install/path is the install path given to
- Dynamic libraries
- SLI libraries
- PyNEST examples
If you want to run the
nest executable or use the
nest Python module without providing explicit paths, you have to add the installation directory to your search paths. For example, if you are using bash:
export PATH=$PATH:/install/path/bin export PYTHONPATH=/install/path/lib/pythonX.Y/site-packages:$PYTHONPATH
/install/path/bin/nest_vars.sh can be sourced in
.bashrc and will set these paths for you. This also allows to switch between NEST installations in a convenient manner.