cellfinder-napari have merged#
BrainGlobe version 1 is almost ready, and the next stage of its release journey is the merging of the “backend”
cellfinder-napari packages into one.
We had previously migrated the
cellfinder data analysis workflow into the new
brainglobe-workflows package, as part of our efforts to separate “backend” BrainGlobe tools from common analysis pipelines.
This means that there is no longer any need to keep the “backend” package (
cellfinder-core) and nor the visualisation plugin (
cellfinder-napari) stored in separate, lower-level packages.
A package called
cellfinderwill become available as a replacement for this functionality. Note that this will reuse the old “cellfinder” name that the command-line-interface had, prior to its migration.
cellfinder-napariplugin is now simply called “cellfinder” internally, and when loaded up in napari.
The “cellfinder” name for the whole-brain registration and analysis workflow provided by
brainglobe-workflowswill be deprecated to avoid confusion. This workflow will now be available as “
From a user perspective, this is just a restructuring and reorganisation of existing functionality, and the renaming of the cellfinder command-line tool to
If you were using the
cellfinder-core backend, or the
cellfinder-napari plugins, you’ll need to uninstall those packages and install version
1.0.0 (or later) of the
By merging two packages together, we hope to reduce the complexity of a BrainGlobe install and make the API to the tools more intuitive.
For developers, this merge again reduces the number of repositories that we have to maintain.
It also ensures we continue to distinguish between BrainGlobe tools and workflows.
And finally, we also address a long-standing historical naming issue with the old “cellfinder” (now
brainmapper) workflow being confused with the corresponding backend packages.
What do I need to do?#
If you were previously using
cellfinder-core in your scripts, you will need to uninstall it and install
1.0.0 or greater.
Once you’ve done this, it should just be a case of changing each of your
from cellfinder_core import X statements to
from cellfinder.core import X.
If you were previously using
cellfinder-napari, you’ll need to uninstall it and install
cellfinder[napari], which will fetch
cellfinder and its optional napari dependency.
Any references you have made to the
cellfinder_napari plugin in your analysis will need to change to the “
cellfinder plugin” instead.
If you were using the cellfinder command-line tool that was provided by
brainglobe-workflows, you will need to update your version of
If you were still using the cellfinder command-line tool provided by the
cellfinder package, with version less than
1.0.0, you will need to take slightly more involved action - we recommend you look at the instructions on the full changelog for details.
You can take a look at the instructions in the full changelog for more details about updating to the new package.
You can find the full changelog on the releases page.