Installation¶
With conda
¶
To install the latest stable version with conda
, use the conda-forge
channel with:
conda install -c conda-forge astro-gala
With pip
¶
To install the latest stable version using pip
, use:
pip install gala
To install the development version:
pip install git+https://github.com/adrn/gala
Cloning, Building, Installing¶
The latest development version of gala can be cloned from
GitHub using git
:
git clone git://github.com/adrn/gala.git
To build the project (from the root of the source tree, e.g., inside
the cloned gala
directory):
python setup.py build
To install the project:
python setup.py install
Installing on Windows¶
We have successfully installed Gala on Windows within an Anaconda installation,
which installs and uses GCC to compile C code. Unfortunately, Gala will not work
with Microsoft Visual Studio’s C compiler because it is not C99 compliant. With Anaconda, you can install gsl
(see below) and then install Gala with pip
:
pip install gala
GSL support¶
Some functionality in Gala depends on the GNU Scientific Library (GSL), a C library for numerical and mathematical programming. By default, Gala will determine whether to install with or without GSL support depending on whether it can find a GSL installation on your machine. If you are not sure whether you have GSL installed or not, try running:
gsl-config –version
in your terminal. If that returns a version number, you likely have GSL installed. If it errors, you will need to install it. Additionally, if your version of GSL is <1.14, we recommend updating to a newer version, as Gala has only been tested with GSL >= 1.14.
Installing with conda
¶
If you use a Mac computer, we recommend installing GSL using the anaconda Python package manager. Using conda
,
you can install GSL with:
conda install -c conda-forge gsl
Installing with apt
¶
If you use Linux, you can install GSL with anaconda (see directions above), or
with apt
. To install with apt, make sure to install both gsl-bin
and
libgsl0-dev
:
apt-get install gsl-bin libgsl0-dev
Forcing gala to install without GSL support¶
You can force Gala to build without GSL support using the --nogsl
flag
passed to setup.py. To use this flag, you must install Gala from source by
cloning the repository (see above) and running:
python setup.py build –nogsl python setup.py install
Python Dependencies¶
This packages has the following dependencies (note that the version requirements below indicate the versions for which Gala is tested with and should work with):
You can use pip
or conda
to install these automatically.