Neurokernel is a Python framework for developing models of the fruit fly brain and executing them on multiple NVIDIA GPUs.
Neurokernel requires Python 2.7, at least one NVIDIA GPU, NVIDIA's GPU drivers, and CUDA 5.0 or later.
Make sure you have pip installed (preferably in a virtualenv); once you do, install the following dependencies as follows:
pip install numpy pip install cython pip install numexpr pip install tables pip install pycuda
If installation of PyCUDA fails because some of the CUDA development files or
libraries are not found, you may need to specify where they are explicitly. For
example, if CUDA is installed in /usr/local/cuda/
, try installing PyCUDA as
follows:
CUDA_ROOT=/usr/local/cuda/ CFLAGS=-I${CUDA_ROOT}/include \ LDFLAGS=-L${CUDA_ROOT}/lib64 pip install pycuda
Replace ${CUDA_ROOT}/lib
with ${CUDA_ROOT}/lib64
if your system is
running 64-bit
Linux. If you continue to encounter installation problems, see the PyCUDA Wiki for more information.
You will also need to have ffmpeg or libav installed to generate some of the demo visualizations.
Run the following to install the remaining dependencies and the latest Neurokernel code:
git clone https://github.com/neurokernel/neurokernel.git pip install -e git+./neurokernel#egg=neurokernel
If you have all of the requirements listed in INSTALL.rst
installed,
you can also install the downloaded code using:
cd neurokernel/ python setup.py install
or (if you want to tinker with the code without having to repeatedly reinstall it):
cd neurokernel/ python setup.py develop
Check out the demos in neurokernel/examples
subdirectory and
their corresponding IPython notebooks
in neurokernel/notebooks
.
Neurokernel has been tested and installed on Linux. It may run on other platforms too; if you encounter problems, submit a bug report on GitHub.
More information about Neurokernel can be obtained from the project website at https://neurokernel.github.io.
Neurokernel's documentation is available at http://neurokernel.rtfd.org.
See the included AUTHORS file for more information.
This software is licensed under the BSD License. See the included LICENSE file for more information.