The astropy-healpix package works with Python 3.6 and later (on Linux, MacOS and Windows), and requires the following dependencies:
Installing the latest stable version is possible either using pip or conda.
pip install --no-deps astropy-healpix
--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.
conda install -c conda-forge astropy-healpix
To check that you have this package installed and which version you’re using, start Python and execute the following code:
$ python Python 3.6.2 |Continuum Analytics, Inc.| (default, Jul 20 2017, 13:14:59) [GCC 4.2.1 Compatible Apple LLVM 6.0 (clang-600.0.57)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import astropy_healpix >>> astropy_healpix.__version__ 0.1
To make sure that all functionality is working OK on your system, you can
run the automated tests of this package by executing the
python -c 'import astropy_healpix; astropy_healpix.test()'
Install the latest development version from https://github.com/astropy/astropy-healpix :
git clone https://github.com/astropy/astropy-healpix cd astropy-healpix pip install .
This section contains some tips how to hack on astropy-healpix.
One quick way to get a Python environment with everything needed to
astropy-healpix (code, run tests, build docs) is like this:
git clone https://github.com/astropy/astropy-healpix cd astropy-healpix conda env create -f environment-dev.yml conda activate astropy-healpix
Run this command to do an in-place build and put this local version on
python setup.py develop
To run the tests, use
python -m pytest -v astropy_healpix
To build the docs, use this command:
python setup.py build_docs open docs/_build/html/index.html
If you have any questions, just open an issue on Github and we’ll help.