|logo|
Gala is a Python package for Galactic and gravitational dynamics.
|Affiliated package| |Coverage Status| |Build status| |CodSpeed| |SPEC 0|
Documentation
|Documentation Status|
The documentation for Gala is hosted on Read the docs <http://gala.adrian.pw>__.
Installation and Dependencies
|PyPI|
The easiest way to get Gala is to install with pip or uv.
Gala can be installed with pip (with uv or standalone)::
pip install gala
You can also add gala as a dependency to your environment with::
uv add gala
See the installation instructions <http://gala.adrian.pw/en/latest/install.html>_ in the
documentation <http://gala.adrian.pw>__ for more information.
Gala follows SPEC 0 <https://scientific-python.org/specs/spec-0000/>_ for its
minimum supported versions of Python and core dependencies (e.g., numpy, scipy):
support for a Python version is dropped 3 years after its initial release, and
support for a core dependency version is dropped 2 years after its initial release.
Attribution
|JOSS| |DOI|
If you make use of this code, please cite the JOSS <http://joss.theoj.org>_
paper::
@article{gala,
doi = {10.21105/joss.00388},
url = {https://doi.org/10.21105%2Fjoss.00388},
year = 2017,
month = {oct},
publisher = {The Open Journal},
volume = {2},
number = {18},
author = {Adrian M. Price-Whelan},
title = {Gala: A Python package for galactic dynamics},
journal = {The Journal of Open Source Software}
}
Please also cite the Zenodo DOI |DOI| as a software citation - see the
documentation <http://gala.adrian.pw/en/latest/index.html#citation-and-attribution>_ for up
to date citation information.
License
|License|
Copyright 2013-2026 Adrian Price-Whelan and contributors.
Gala is free software made available under the MIT License. For details see
the LICENSE <https://github.com/adrn/gala/blob/main/LICENSE>_ file.
.. |Coverage Status| image:: https://codecov.io/gh/adrn/gala/branch/main/graph/badge.svg
:target: https://codecov.io/gh/adrn/gala
.. |Build status| image:: https://github.com/adrn/gala/actions/workflows/tests.yml/badge.svg
:target: https://github.com/adrn/gala/actions/workflows/tests.yml
.. |CodSpeed| image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json
:target: https://codspeed.io/adrn/gala
.. |License| image:: http://img.shields.io/badge/license-MIT-blue.svg?style=flat
:target: https://github.com/adrn/gala/blob/main/LICENSE
.. |PyPI| image:: https://badge.fury.io/py/gala.svg
:target: https://badge.fury.io/py/gala
.. |conda| image:: https://anaconda.org/conda-forge/gala/badges/version.svg
:target: https://anaconda.org/conda-forge/gala
.. |Documentation Status| image:: https://readthedocs.org/projects/gala-astro/badge/?version=latest
:target: http://gala-astro.readthedocs.io/en/latest/?badge=latest
.. |Affiliated package| image::
:target:
.. |JOSS| image::
:target:
.. |DOI| image::
:target:
.. |SPEC 0| image::
:target:
.. |ASCL| image::
:target:
.. |logo| image::
:target:
:width: 400
Contributors
See the AUTHORS.rst <https://github.com/adrn/gala/blob/main/AUTHORS.rst>_
file for a complete list of contributors to the project.
