Skip to main content

A collection of end-to-end data analysis workflows executed using BrainGlobe tools.

Project description

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

BrainGlobe Workflows

brainglobe-workflows is a package that provides users with a number of out-of-the-box data analysis workflows employed in neuroscience, implemented using BrainGlobe tools.

These workflows represent the most common use-cases and are meant to be easy to reuse. They also serve as an example of how to combine several BrainGlobe tools (possibly together with other tools) to achieve a goal, such as whole brain cell detection and atlas registration.

You can view the full documentation for each workflow online. You can also find the documentation for the backend BrainGlobe tools these workflows use on our website.

At present, the package offers the following workflows to users:

  • brainmapper: A command-line tool for whole-brain detection, registration, and analysis.

Additionally, this repository provides functionalities to support code developers. See the developer documentation for further details.

User documentation

Installation

At the moment, users can install all available workflows by running pip install in your desired environment:

pip install brainglobe-workflows

brainglobe-workflows is built using BrainGlobe tools, and it will automatically fetch the tools that it needs and install them into your environment. Once BrainGlobe version 1 is available, this package will fetch all BrainGlobe tools and handle their install into your environment, to prevent potential conflicts from partial installs.

See the sections below for more information about the workflows and command-line tools provided.

brainmapper Command Line Interface (CLI)

Whole-brain cell detection, registration and analysis.

If you want to just use the cell detection part of brainmapper, please see the standalone cellfinder package and its napari plugin.

brainmapper is a workflow 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 the cellfinder backend package),
  • Atlas registration (using brainreg),
  • Analysis of cell positions in a common space.

Basic usage:

brainmapper -s signal_images -b background_images -o output_dir --metadata metadata

Full documentation can be found here.

NOTE: The brainmapper workflow previously used the name "cellfinder", but this has been discontinued following the release of the unified cellfinder backend package to avoid conflation of terms. See our blog post from the release for more information.

Developer documentation

This repository also includes workflow scripts that are benchmarked to support code development. These benchmarks are run regularly to ensure performance is stable, as the tools are developed and extended.

  • Developers can install these benchmarks locally via pip install .[dev]. By executing asv run, the benchmarks will run with default parameters on a small dataset that is downloaded from GIN. See the asv docs for further details on how to run benchmarks.
  • Developers can also run these benchmarks on data they have stored locally, by specifying the relevant paths in an input (JSON) file.
  • We also maintain an internal runner that benchmarks the workflows over a large, exemplar dataset, of the scale we expect users to be handling. The result of these benchmarks are made publicly available.

Contributions to BrainGlobe are more than welcome. Please see the developer guide.

Citing brainglobe-workflows

If you use any tools in the brainglobe suite, please let us know, and we'd be happy to promote your paper/talk etc.

If you find brainmapper 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 brainmapper, please also cite brainreg.

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

brainglobe_workflows-1.1.5.tar.gz (30.3 kB view details)

Uploaded Source

Built Distribution

brainglobe_workflows-1.1.5-py3-none-any.whl (23.4 kB view details)

Uploaded Python 3

File details

Details for the file brainglobe_workflows-1.1.5.tar.gz.

File metadata

  • Download URL: brainglobe_workflows-1.1.5.tar.gz
  • Upload date:
  • Size: 30.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.9

File hashes

Hashes for brainglobe_workflows-1.1.5.tar.gz
Algorithm Hash digest
SHA256 7d8f132bc2fcecbbcdff09df1e0efc01353bb8f45187ed48229b9e23734176db
MD5 09de3b0a5e67c90b12b0a35df5a1d122
BLAKE2b-256 d98fec82f41a099d5a50a5b917e0b4a087b195b1ade5a250500fe17428bfb2cf

See more details on using hashes here.

File details

Details for the file brainglobe_workflows-1.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for brainglobe_workflows-1.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 8043b88a00c9b0053756b0f3c56b87b58411b47416a77be111dfa3c713e24fcc
MD5 485ce9debfc0c760a82d0583349895da
BLAKE2b-256 3c226b2ab55ee7005098e528e52079c950d14c2564b7f5a6718d4034974e93f8

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