Installation¶
The hips package works with Python 3.6 or later, on Linux, MacOS and Windows.
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
- astropy-healpix 0.2 or later
- 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.
- tqdm. Used for showing progress bar either on terminal or in Jupyter notebook.
- aiohttp. Used for fetching HiPS tiles.
We have some info at Why only Python 3? on why we don’t support legacy Python (Python 2).