Installation#

To install neurocaps, follow the instructions below using your preferred terminal.

Standard Installation from PyPi#

pip install neurocaps

Windows Users

To avoid installation errors related to long paths not being enabled, pybids will not be installed by default. Refer to official Microsoft documentation to enable long paths.

To include pybids in your installation, use:

pip install neurocaps[windows]

Alternatively, you can install pybids separately:

pip install pybids

Installation from Source (Development Version)#

To install the latest development version from the source, there are two options:

  1. Install directly via pip:

pip install git+https://github.com/donishadsmith/neurocaps.git

  1. Clone the repository and install locally:

git clone https://github.com/donishadsmith/neurocaps/
cd neurocaps
pip install -e .

Windows Users

To include pybids when installing the development version on Windows, use:

git clone https://github.com/donishadsmith/neurocaps/
cd neurocaps
pip install -e .[windows]

Docker#

If Docker is available on your system, you can use the neurocaps Docker image, which includes the demos and configures a headless display for VTK.

To pull the Docker image:

docker pull donishadsmith/neurocaps && docker tag donishadsmith/neurocaps neurocaps

The image can be run as:

  1. An interactive bash session (default):

docker run -it neurocaps

  1. A Jupyter Notebook with port forwarding:

docker run -it -p 9999:9999 neurocaps notebook