Running cellfinder
How to set the analysis running
cellfinder runs with a single command, with various arguments that are detailed in Command line options. To analyse the example data, the flags we need are:
-s
The primary signal channel:test_brain/ch00
-b
The secondary autofluorescence channel (or background):test_brain/ch01
-o
The output directory :test_brain/output
--orientation
The data orientation:psl
-v
The voxel spacing in the same order as the data orientation (psl
):5 2 2
--atlas
The atlas we want to use:allen_mouse_10um
If your machine has less than 32GB of RAM, you should use the
allen_mouse_25um
atlas either way, as registration with the high-resolution atlas requires about 30GB for this image.Putting this all together into a single command gives:
cellfinder -s test_brain/ch00 -b test_brain/ch01 -o test_brain/output -v 5 2 2 --orientation psl --atlas allen_mouse_10um
This command will take quite a long time (anywhere from 2-10 hours) to run, depending on:
- The speed of the disk the data is stored on
- The CPU speed and number of cores
- The GPU you have
You'll know cellfinder has finished when you see something like this:
2020-10-14 00:07:20 AM - INFO - MainProcess main.py:86 - Finished. Total time taken: 3:22:42
If you just want to check that everything is working, we can speed everything up by:
- Only analysing part of the brain using the flags:
--start-plane 1500 --end-plane 1550
- Using a lower-resolution atlas, using the flag:
--atlas allen_mouse_25um
cellfinder -s test_brain/ch00 -b test_brain/ch01 -o test_brain/output -v 5 2 2 --orientation psl --atlas allen_mouse_25um --start-plane 1500 --end-plane 1550
If your machine has less than 32GB of RAM, you should use the
allen_mouse_25um
atlas either way, as registration with the high-resolution atlas requires about 30GB for this image.If the cell classification step takes a (very) long time, it may not be using the GPU. If you have an NVIDIA GPU, see Speeding up cellfinder to make sure that your GPU is set up properly.
Last modified 2yr ago