Skip to main content

Automated 3D cell detection and registration of whole-brain images

Project description

Python Version PyPI Wheel Development Status Travis Coverage Status Dependabot Status Code style: black Gitter DOI Generic badge

Cellfinder

Whole-brain cell detection, registration and analysis.


Cellfinder is a collection of tools from the Margrie Lab and others at the Sainsbury Wellcome Centre 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).
  • Atlas registration (using amap)
  • 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 questions or issues, please get in touch by email, gitter 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 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

Registration and segmentation (amap)

Using amap, 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.

raw 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.

brainrender

Data courtesy of Sepiedeh Keshavarzi and Chryssanthi Tsitoura. Details here

Additional tools

cellfinder is packaged with neuro which provides additional tools for the analysis of visualisation of whole-brain imaging data.

Heatmaps of detected cells:

heatmap

Mapping non-cellular volumes in standard space:

injection Virus injection site within the superior colliculus. (Data courtesy of @FedeClaudi and brainrender)

Citing cellfinder

If you find cellfinder useful, and use it in your research, please cite this repository:

Adam L. Tyson, Charly V. Rousseau, Christian J. Niedworok and Troy W. Margrie (2020). cellfinder: automated 3D cell detection and registration of whole-brain images. doi:10.5281/zenodo.3665329

If you use any of the image registration functions in cellfinder, please also cite amap.

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

cellfinder-0.3.12rc6.tar.gz (611.2 kB view details)

Uploaded Source

Built Distributions

cellfinder-0.3.12rc6-cp37-cp37m-win_amd64.whl (382.2 kB view details)

Uploaded CPython 3.7m Windows x86-64

cellfinder-0.3.12rc6-cp37-cp37m-manylinux2010_x86_64.whl (2.3 MB view details)

Uploaded CPython 3.7m manylinux: glibc 2.12+ x86-64

cellfinder-0.3.12rc6-cp37-cp37m-manylinux1_x86_64.whl (2.3 MB view details)

Uploaded CPython 3.7m

cellfinder-0.3.12rc6-cp36-cp36m-win_amd64.whl (382.1 kB view details)

Uploaded CPython 3.6m Windows x86-64

cellfinder-0.3.12rc6-cp36-cp36m-manylinux2010_x86_64.whl (2.3 MB view details)

Uploaded CPython 3.6m manylinux: glibc 2.12+ x86-64

cellfinder-0.3.12rc6-cp36-cp36m-manylinux1_x86_64.whl (2.3 MB view details)

Uploaded CPython 3.6m

File details

Details for the file cellfinder-0.3.12rc6.tar.gz.

File metadata

  • Download URL: cellfinder-0.3.12rc6.tar.gz
  • Upload date:
  • Size: 611.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.7

File hashes

Hashes for cellfinder-0.3.12rc6.tar.gz
Algorithm Hash digest
SHA256 5240c6b9bca4eca199feb1aec1629b9251d457facdee461b4e65210bf55d52fb
MD5 81354c4e45ab082cb3f13d91dd945bf3
BLAKE2b-256 a9c462a7fa3f5b716f5ddf4e3605392ae80b9175b4fbfa63659c052545fd5ec5

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp37-cp37m-win_amd64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp37-cp37m-win_amd64.whl
  • Upload date:
  • Size: 382.2 kB
  • Tags: CPython 3.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3.post20200330 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.7

File hashes

Hashes for cellfinder-0.3.12rc6-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 75586306e62f4737843bbbc4d30101eccb877f6b2780204933ddae4e7b89a240
MD5 3ffa5497fe30ee5af25a9e695a53ff81
BLAKE2b-256 81e867170a148f5ad6a193af3a2007d5b19d78dd28f80054ed9b55fed4ad082b

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp37-cp37m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp37-cp37m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: CPython 3.7m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.7

File hashes

Hashes for cellfinder-0.3.12rc6-cp37-cp37m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 2b7d00a486b3824e58e4bea6c5f8b5b8ea436e6fbcb05fafef170a6aae924edf
MD5 5baae997668281a0f238d8cb02d99a4b
BLAKE2b-256 a52e97481d781166a3aeb192d073e4a64b8a9a99f10e693bbebaa6a6e9898080

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp37-cp37m-manylinux1_x86_64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp37-cp37m-manylinux1_x86_64.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: CPython 3.7m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.7

File hashes

Hashes for cellfinder-0.3.12rc6-cp37-cp37m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 8c734032a12970db3abc4d2a75ef1f42aaf33deb3be575ca9f5d30436a1d12a1
MD5 313a4c9a8b5c6a2051881066b16e8feb
BLAKE2b-256 d542cec7f4b495e9d66a2bb04cd50a3f5db3d69907c701fb0834afedd05da530

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp36-cp36m-win_amd64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp36-cp36m-win_amd64.whl
  • Upload date:
  • Size: 382.1 kB
  • Tags: CPython 3.6m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3.post20200330 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.10

File hashes

Hashes for cellfinder-0.3.12rc6-cp36-cp36m-win_amd64.whl
Algorithm Hash digest
SHA256 a7c1afe26aad06ace8e3fe934db419bd532bdf4affa9113154e1cc89709232e3
MD5 15c3552270ff28ac07b8475b7210888d
BLAKE2b-256 d56ff2d8901256ec2194f958e0bb6006db32e4b2fe47cfda65cfe113b553326e

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp36-cp36m-manylinux2010_x86_64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp36-cp36m-manylinux2010_x86_64.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: CPython 3.6m, manylinux: glibc 2.12+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.7

File hashes

Hashes for cellfinder-0.3.12rc6-cp36-cp36m-manylinux2010_x86_64.whl
Algorithm Hash digest
SHA256 fbad179fa48e72267503728815033198986c0cb602cb3b871e619c7a42150762
MD5 8a82bb0cb4202b1880ad35d1dcebba0b
BLAKE2b-256 31f08dda1c0bd955e57270f427583ce41d0ccf0513b23a10242a6e855c905ab5

See more details on using hashes here.

File details

Details for the file cellfinder-0.3.12rc6-cp36-cp36m-manylinux1_x86_64.whl.

File metadata

  • Download URL: cellfinder-0.3.12rc6-cp36-cp36m-manylinux1_x86_64.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: CPython 3.6m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.6.7

File hashes

Hashes for cellfinder-0.3.12rc6-cp36-cp36m-manylinux1_x86_64.whl
Algorithm Hash digest
SHA256 f316f562641da9e004bf8b85303629cf1e916ad177a44ae7177f2da536d37912
MD5 3ada7ad6619076645a410dd44207a32e
BLAKE2b-256 49a871da952ca3a456de9642f155e8751db57bf5a9f0bfc6cd7bcdeaeceab3e5

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