Package: abba-python
ABBA PythonAligning Big Brains and Atlases, controlled from Python.Free software: GNU General Public License v3Documentation:https://biop.github.io/ijp-imagetoatlas/ABBA in briefAligning Big Brains & Atlases, abbreviated as ABBA, allows you to register thin serial sections to multiple atlases in coronal, sagittal, and horizontal orientations. It is mainly a Java application, but this repo makes all of its API accessible in Python.With ABBA Python, you can control ABBA API from python, and get some additional perks. In particular you get access to allBrainGlobe atlases.[!WARNING]
Due to some threading issues, the GUI does not work with MacOSXGetting startedInstallminicondaorminiforge.Create a conda environment with Python 3.8, pyimagej, OpenJDK 8 and maven and activate itInstall abba_pythonmamba create -c conda-forge -n abba-env python=3.8 openjdk=8 pip maven pyimagej

conda activate abba-env

pip install abba_pythonTo begin using ABBA with a graphical user interface (GUI):In the created environment, launch Python and run the following commands:from abba_python import abba
abba.start_imagej()You can then use ABBA within Fiji; for more details, visithttps://biop.github.io/ijp-imagetoatlas/.
ABBA is typically used in conjunction withQuPath: a QuPath project can serve as input for ABBA, and the registration results can be imported back into QuPath for further processing.To begin with ABBA with jupyter labIn the created environment, installjupyterlabandipywidgets:pip install jupyterlab
pip install ipywidgetsYou can now runjupyter laband start using notebooks, like the ones provided in examples in the github repo.Installing extra modulesElastix/TransformixABBA's automated in-plane registration relies onelastix 5.0.1. To utilize all of ABBA's functionalities, you need to separately install elastix and transformix on your operating system. During the initial run of ABBA, you will be prompted to specify their executable locations. Alternatively, you can set their paths using the API (refer to thefirst example notebook).DeepSliceABBA can leverage the deep-learning registration toolDeepSlice, either through the web interface (in the GUI) or by running it locally. To use DeepSlice locally, you must install it in a separate conda environment and specify its path to ABBA, either through the GUI or the API (as explained in thefirst example notebook).Note that DeepSlice can also be used locally with the pure Java version thanks to this (new) design.To install DeepSlice, please refer to the documentation.In Sept 2023, this was working:conda create -n deepslice python=3.7
conda activate deepslice
conda install pip
pip install DeepSlice==1.1.5
pip install urllib3==1.26.6 # see https://github.com/PolarBean/DeepSlice/issues/46You also need to make conda available at the system level:
You need to follow this two steps procedure to enable Windows to use conda from cmd.exe:Into the environment variable, edit PATH, add path to your ..\Anaconda3\condabin default would be C:\ProgramData\Anaconda3\condabinOpen a new PowerShell (and/or PowerShell (x86) ), run the following command once to initialize conda:conda initNote on versionsOpenJDK versions above 8 can work, but they have been less tested, so there may be unexpected bugs. To avoidcertificate issues, it is recommended to have openjdk installed from conda-forge.CreditsThis package was created with Cookiecutter and theaudreyr/cookiecutter-pypackageproject template.Cookiecutteraudreyr/cookiecutter-pypackage