Installation

Installing the latest stable version is possible either using pip or conda.

How to install the latest development version is desribed on the Develop page.

Using pip

To install hips with pip from PyPI, run:

pip install hips --no-deps

Note

The --no-deps flag is optional, but highly recommended if you already have Numpy installed, since otherwise pip will sometimes try to “help” you by upgrading your Numpy installation, which may not always be desired.

Using conda

To install hips with Anaconda from the conda-forge channel on anaconda.org simply run:

conda install -c conda-forge hips

Check installation

To check if you have hips installed, where it was installed and which version you have:

$ python
>>> import hips  # doctest: +SKIP
>>> hips.__version__  # doctest: +SKIP
# -> prints which version you have
>>> hips  # doctest: +SKIP
# -> prints where hips is installed

To see if you have the latest stable, released version of hips, you can find that version here:

Next you could try running the examples at Getting started and see if you get the expected output.

It’s usually not necessary, but if you find that your hips installation gives errors or unexpected results for examples that should work, you can run the hips automated tests via:

python -c 'import hips; hips.test()'

For more information on automated tests, see the Develop page.

Dependencies

The hips package has the following requirements:

  • Python 3.6 or later!
  • Numpy 1.11 or later
  • Astropy 1.2 or later
  • Healpy 1.9 or later. (Older versions could work, but aren’t tested.)
  • scikit-image 0.12 or later. (Older versions could work, but aren’t tested.)
  • Pillow 4.0 or later. (Older versions could work, but aren’t tested.) Pillow is the friendly Python Imaging Library (PIL) fork, for JPEG and PNG tile I/O.

In addition, the following packages are needed for optional functionality:

  • Matplotlib 2.0 or later. Used for plotting in examples.

We have some info at Why only Python 3? on why we don’t support legacy Python (Python 2).