Installation

The latest version (17/04/2026) of astromorphlib is [1.0.13].

The repository of astromorphlib is at Gitlab.

The easiest way to install this package is via an Environment manager:

  • Python version: 3.13 or later

  • Operating system: Linux or macOS

  • Environment manager: conda (Anaconda or Miniconda)

  • Environment name (suggested): astromorphlib

It is highly recommended to create an isolated Conda environment before installing astromorphlib. This ensures all dependencies are handled cleanly and avoids conflicts with other Python installations.

Creating the Environment

  1. Create a new Conda environment with Python 3.13:

    conda create -n astromorphlib python=3.13.1

  2. Activate the environment:

    conda activate astromorphlib

  3. Install the required dependencies:

    You can install them directly via pip inside the environment:

    pip install statmorph==0.6.1 splusdata astro-datalab astroplotlib \
            astropy astroquery photutils==1.5.0 numpy matplotlib \
            scipy pyvo wget colorama

  4. Finally, you can install astromorphlib:

    pip install astromorphlib

  5. Additionally, you can either install Jupyterlab or Jupyter interactive notebook, for example installing Jupyterlab:

    pip install jupyterlab

Resolving Compatibility Issues with photutils (==1.5.0) and Newer Versions of numpy (>= 2.0)

When using photutils with numpy version 2.0 or higher, you may encounter a compatibility issue. This occurs due to changes in how the index_exp function is imported. To resolve this, you need to update the import statement in the background_2d.py file.

Steps to Fix

  1. Locate the `background_2d.py` file: - This file is typically located in a path like:

home/user_name/anaconda3/envs/astromorphlib/lib/python3.13/site-packages/photutils/background/

  1. Open the file and find the following line of code:

    from numpy.lib.index_tricks import index_exp

  2. Replace it with this updated import statement:

    from numpy.lib._index_tricks_impl import index_exp

  3. Save the file.

  4. Re-test your setup to ensure `photutils` works correctly with `numpy` version 2.0 and above.

—

By following these steps, you can resolve the issue and ensure compatibility with the latest numpy versions.

Requirements

This is the list of all modules that astromorphlib requires to run:

  • statmorph (0.6.1)**

  • splusdata

  • astro-datalab

  • astroplotlib

  • astropy

  • astroquery

  • pyvo

  • photutils (1.5.0 <)**

  • numpy

  • scipy

  • matplotlib

  • wget

  • colorama

** To install these specific versions of these packages, for example for photutils, you can try:

pip install photutils==1.5.0

Uninstallation

In order to uninstall astromorphlib just type on the terminal:

pip uninstall astromorphlib