brainglobe
Search…
Installation with docker

Prerequisites

Setup

Install NVIDIA Container Toolkit
Full instructions are here, but e.g. for Ubuntu:
Setup repository and GPG key:
1
distribution=$(. /etc/os-release;echo $ID$VERSION_ID) \
2
&& curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add - \
3
&& curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
4
Copied!
Install NVIDIA docker package:
1
sudo apt-get update
2
sudo apt-get install -y nvidia-docker2
Copied!
Restart docker daemon:
1
sudo systemctl restart docker
Copied!

Running cellfinder

To run with GPU support, and mount the current working directory at /data:
1
docker container run --mount type=bind,source=${PWD},target=/data --gpus all -it ghcr.io/brainglobe/cellfinder
Copied!
This will open up a bash prompt, and you can use cellfinder (or brainreg etc.) to analyse your data (mounted at /data) as normal, e.g.:
1
cellfinder -s /data/brain1/channel0 -b /data/brain1/channel1 -v 5 2 2 --orientation psl -o /data/analysis/brain1 --trained-model /data/models/retrained.h5
Copied!
To leave the docker container when done, just exit.The data will be saved onto the host system, at your current working directory (you can mount different directories, or multiple directories, see the docker documentation).