Skip to content

ObservationalExpansions/Galaxy-Morphology

Repository files navigation

Galaxy-Morphology

FLEX-enabled Galaxy Inclination & Morphology Calculator

This repository contains tools and workflows to measure the inclination and other morphological parameters of disc galaxies from imaging data. The methods follow the Fourier–Laguerre (FLEX)–based description in Martinez et al. (2025), enabling a robust, model-based extraction of:

  • Inclination via a dimensionless metric $\eta$
  • Position angle
  • Scale Length

The code is designed to be used both as a Python package and through Jupyter notebooks for exploratory analysis and figure generation.

Applying the methods outlined in HowTo.ipynb and PaperPlots.ipynb, you can compare any .fits galaxy image and analyse its orientation visually producing a graph similar to the figure below. Applying galaxymorphology to a single file or a set of files reproduces a table of corresponding measurements.

Inclination comparison

The repository is sectioned as follows:

Notebooks folder contains ipynb files which were used in analysis during the project

SGA_catalogue folder contains intstructions and sample data for reproducible results comparible to those which are published

PlotsPaper folder contains the relevant plots for the paper

PaperPlots.ipynb file contains instructions on producing the small sample analysis and disc generation

src folder contains the galaxymorphology function


Features

  • Measurement of disc galaxy inclinations and position angles from imaging data by use of FLEX and a defined metric
  • Support for generating and regenerating publication-grade plots (e.g. inclination comparisons, error distributions)
  • Applying a DiscModel to simulate a disc galay of any inclination and position angle
  • FLEX / Fourier–Laguerre based fitting framework, following Martinez et al. (2025)
  • Notebooks including analysis on inclination inversion relations

Installation

Clone the repository and install package

git clone https://github.com/ObservationalExpansions/Galaxy-Morphology.git
cd Galaxy-Morphology
pip install .

About

Package to measure inclination of galaxy images and other morphological parameters, following descriptions in Martinez et al. (2025).

Topics

Resources

Stars

Watchers

Forks

Contributors