Skip to main content

Efficient cell detection in large images

Project description

This package has moved

cellfinder-napari has merged with it's backend code and is now available as a single package called cellfinder. We recommend you uninstall cellfinder-napari and instead use the functionality provided in the cellfinder package.

These changes are part of our wider restructuring of the BrainGlobe suite of tools and analysis pipelines, which you can keep up to date with on our blog.


cellfinder-napari

License PyPI Python Version tests codecov Downloads Wheel Development Status Code style: black Imports: isort pre-commit Contributions Website Twitter

Efficient cell detection in large images (e.g. whole mouse brain images)

cellfinder-napari is a front-end to cellfinder-core to allow ease of use within the napari multidimensional image viewer. For more details on this approach, please see Tyson, Rousseau & Niedworok et al. (2021). This algorithm can also be used within the original cellfinder software for whole-brain microscopy analysis.

cellfinder-napari, cellfinder and cellfinder-core were developed by Charly Rousseau and Adam Tyson in the Margrie Lab, based on previous work by Christian Niedworok, generously supported by the Sainsbury Wellcome Centre.


raw

Visualising detected cells in the cellfinder napari plugin


Instructions

Installation

Once you have installed napari. You can install napari either through the napari plugin installation tool, or directly from PyPI with:

pip install cellfinder-napari

Usage

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 questions or issues, please get in touch on the forum or by raising an issue.


Illustration

Introduction

cellfinder takes a stitched, but otherwise raw dataset with at least two channels:

  • Background channel (i.e. autofluorescence)
  • Signal channel, the one with the cells to be detected:

raw 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):

raw Candidate cells (including many artefacts)

Cell candidate classification

A deep-learning network (ResNet) is used to classify cell candidates as true cells or artefacts:

raw Cassified cell candidates. Yellow - cells, Blue - artefacts

Contributing

Contributions to cellfinder-napari are more than welcome. Please see the developers guide.

Citing cellfinder

If you find this plugin 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 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cellfinder-napari-1.0.2.tar.gz (50.0 kB view details)

Uploaded Source

Built Distribution

cellfinder_napari-1.0.2-py3-none-any.whl (49.0 kB view details)

Uploaded Python 3

File details

Details for the file cellfinder-napari-1.0.2.tar.gz.

File metadata

  • Download URL: cellfinder-napari-1.0.2.tar.gz
  • Upload date:
  • Size: 50.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.18

File hashes

Hashes for cellfinder-napari-1.0.2.tar.gz
Algorithm Hash digest
SHA256 e87cb277520a35e60edfe692b908a48666f390136777ef9b482fcc6e604595e8
MD5 39c6e0708edabb2b4b4ae3878f9cee97
BLAKE2b-256 9bb36753552b628fc0e5e8267862a24a47d8a65e060f82b6e89b56dd26409bb3

See more details on using hashes here.

File details

Details for the file cellfinder_napari-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for cellfinder_napari-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 43e7a3b18a707cd774bf346570d3f176dc7fa1be62f9e515ca6c9ffcd7fda646
MD5 eec9d111a5426ca6a7a544e3396ead80
BLAKE2b-256 826e8fa377cd7a03b644b930b3ea6cca7bb92b91f68eff54ab6c8e10be923a26

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page