Package: brainglobe-workflows
BrainGlobe Workflowsbrainglobe-workflowsis 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 thefull documentation for each workflowonline.
You can also find the documentation for the backend BrainGlobe tools these workflows useon 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 thedeveloper documentationfor further details.User documentationInstallationAt the moment, users can install all available workflows by runningpip installin your desired environment:pipinstallbrainglobe-workflowsbrainglobe-workflowsis 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.brainmapperCommand Line Interface (CLI)Whole-brain cell detection, registration and analysis.If you want to just use the cell detection part ofbrainmapper, please see the standalonecellfinderpackage and itsnapariplugin.brainmapperis a workflow designed for the analysis of whole-brain imaging data such asserial-section imagingand 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 thecellfinderbackend package),Atlas registration (usingbrainreg),Analysis of cell positions in a common space.Basic usage:brainmapper-ssignal_images-bbackground_images-ooutput_dir--metadatametadataFull documentation can be foundhere.NOTE: Thebrainmapperworkflow previously used the name "cellfinder", but this has been discontinued following the release of theunifiedcellfinderbackend package to avoid conflation of terms.
See ourblog postfrom the release for more information.Developer documentationThis 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 viapip install .[dev]. By executingasv run, the benchmarks will run with default parameters on a small dataset that is downloaded fromGIN. Seethe asv docsfor 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 thedeveloper guide.Citingbrainglobe-workflowsIf you use any tools in thebrainglobe suite, pleaselet us know, and we'd be happy to promote your paper/talk etc.If you findbrainmapperuseful, 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), e1009074https://doi.org/10.1371/journal.pcbi.1009074If you use any of the image registration functions inbrainmapper, please also citebrainreg.