Skip to content

MagellanMapper is a graphical interface for 3D bioimage annotation, atlas registration, and regional quantification

License

Notifications You must be signed in to change notification settings

sanderslab/magellanmapper

Repository files navigation

MagellanMapper

MagellanMapper is a graphical imaging informatics suite for 3D reconstruction and automated analysis of whole specimens and atlases. Its design philosophy is to make the raw 3D images as accessible as possible, simplify annotation from nuclei to atlases, and scale from the laptop or desktop to the cloud in cross-platform environments.

ROI Editor and Atlas Editor screenshots

Quick Reference

Quick Install

Install MagellanMapper with its graphical interface and registration tools:

pip install "magellanmapper[gui,itk]"

Then launch MagellanMapper:

mm

Full Install

Alternatively, Conda can be used to install MagellanMapper along with support for importing proprietary image file formats (note: not currently working on Apple Silicon (Mac M-chip) platforms):

conda env create -n mag -f https://raw.githubusercontent.com/sanderslab/magellanmapper/master/envs/environment_rel.yml

Then activate the environment (mag) and run MagellanMapper:

conda activate mag
mm

If you have Java, you can do the same through Pip:

pip install "magellanmapper[most]" --extra-index-url https://pypi.fury.io/dd8/

The extra index accesses a few customized dependencies for MagellanMapper.

For the latest updates and fixes, download from Git and install:

git clone https://github.com/sanderslab/magellanmapper.git
cd magellanmapper
conda env create -n mag -f environment.yml
python run.py

Or for Pip, replace the conda line with:

pip install -e ".[most]" --extra-index-url https://pypi.fury.io/dd8/

More ways to install and run

See the install docs for more details, including:

Using MagellanMapper

MagellanMapper consists of a graphical user interface (GUI), command-line interface (CLI), and application programming interface (API) for Python programmatic access. See the GUI docs for graphical usage and the CLI docs for scripting.

For automated tasks, see the sample_cmds_bash.ipynb Jupyter Notebook (or the older sample_cmds.sh script) that shows examples of running the CLI and exploring images in the GUI. See ReadTheDocs for more details, including viewer shortcuts and customizing settings for your image analysis.

Have a question? Found a bug? Want a feature? Please ask!

Image file import

Large images or proprietary microscopy formats such as CZI can be imported by MagellanMapper into NumPy format, which allows on-the-fly loading to reduce memory requirements and initial loading time. In the "Import" tab, you can select files, view and update metadata, and import the files.

Medical imaging formats such as .mha (or .mhd/.raw) and .nii (or .nii.gz) can be opened with the SimpleITK/SimpleElastix library and do not require separate import.

Sample 3D data

To try out functions with sample images, download any of these files:

Related publications and datasets

Licensed under the open-source BSD-3 license

Author: David Young, 2017, 2024, Stephan Sanders Lab