Automated 3D cell detection and registration of whole-brain images
Project description
Cellfinder
Whole-brain cell detection, registration and analysis.
N.B. If you want to just use the cell detection part of cellfinder, please see the standalone cellfinder-core package, or the cellfinder plugin for napari.
cellfinder
is a collection of tools developed by Adam Tyson, Charly Rousseau and Christian Niedworok in the Margrie Lab, generously supported by the Sainsbury Wellcome Centre.
cellfinder
is a designed for the analysis of whole-brain imaging data such as
serial-section imaging
and lightsheet imaging in cleared tissue. The aim is to provide a single solution for:
- Cell detection (initial cell candidate detection and refinement using deep learning) (using cellfinder-core)
- Atlas registration (using brainreg)
- Analysis of cell positions in a common space
Installation is with
pip install cellfinder
Basic usage:
cellfinder -s signal_images -b background_images -o output_dir --metadata metadata
Full documentation can be found here.
This software is at a very early stage, and was written with our data in mind. Over time we hope to support other data types/formats. If you have any issues, please get in touch on the forum or by raising an issue.
Illustration
Introduction
cellfinder takes a stitched, but otherwise raw whole-brain dataset with at least two channels:
- Background channel (i.e. autofluorescence)
- Signal channel, the one with the cells to be detected:
Raw coronal serial two-photon mouse brain image showing labelled cells
Cell candidate detection
Classical image analysis (e.g. filters, thresholding) is used to find cell-like objects (with false positives):
Candidate cells (including many artefacts)
Cell candidate classification
A deep-learning network (ResNet) is used to classify cell candidates as true cells or artefacts:
Cassified cell candidates. Yellow - cells, Blue - artefacts
Registration and segmentation (brainreg)
Using brainreg, cellfinder aligns a template brain and atlas annotations (e.g. the Allen Reference Atlas, ARA) to the sample allowing detected cells to be assigned a brain region.
This transformation can be inverted, allowing detected cells to be transformed to a standard anatomical space.
ARA overlaid on sample image
Analysis of cell positions in a common anatomical space
Registration to a template allows for powerful group-level analysis of cellular disributions. (Example to come)
Examples
(more to come)
Tracing of inputs to retrosplenial cortex (RSP)
Input cell somas detected by cellfinder, aligned to the Allen Reference Atlas, and visualised in brainrender along with RSP.
Data courtesy of Sepiedeh Keshavarzi and Chryssanthi Tsitoura. Details here
Visualisation
cellfinder comes with a plugin (brainglobe-napari-io) for napari to view your data
Usage
- Open napari (however you normally do it, but typically just type
napari
into your terminal, or click on your desktop icon)
Load cellfinder XML file
- Load your raw data (drag and drop the data directories into napari, one at a time)
- Drag and drop your cellfinder XML file (e.g.
cell_classification.xml
) into napari.
Load cellfinder directory
- Load your raw data (drag and drop the data directories into napari, one at a time)
- Drag and drop your cellfinder output directory into napari.
The plugin will then load your detected cells (in yellow) and the rejected cell candidates (in blue). If you carried out registration, then these results will be overlaid (similarly to the loading brainreg data, but transformed to the coordinate space of your raw data).
Loading raw data
Loading cellfinder results
Contributing
Contributions to cellfinder are more than welcome. Please see the developers guide.
Citing cellfinder
If you find cellfinder useful, and use it in your research, please cite the paper outlining the cell detection algorithm:
Tyson, A. L., Rousseau, C. V., Niedworok, C. J., Keshavarzi, S., Tsitoura, C., Cossell, L., Strom, M. and Margrie, T. W. (2021) “A deep learning algorithm for 3D cell detection in whole mouse brain image datasets’ PLOS Computational Biology, 17(5), e1009074 https://doi.org/10.1371/journal.pcbi.1009074
If you use any of the image registration functions in cellfinder, please also cite brainreg.
If you use this, or any other tools in the brainglobe suite, please let us know, and we'd be happy to promote your paper/talk etc.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for cellfinder-0.8.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 36c7e39e7df1fdaea6abc7618c2d07bba44e684c7387838532aff18d3a536fe7 |
|
MD5 | 533dd5738c051357d0b5698bf91c977e |
|
BLAKE2b-256 | 6c924d0a71a546313cf781770f91de8401018c092dea2d50349433a9f8e91fbc |