Installation¶

The regions package requires the following packages:

Python 3.6 or later
Numpy 1.16 or later
Astropy 2.0 or later

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

Matplotlib 2.0 or later

Stable version¶

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

Using pip¶

To install regions with pip from PyPI, run:

pip install regions --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 regions with Anaconda from the astropy channel on anaconda.org simply run:

conda install -c astropy regions

Testing installation¶

To check if there are any issues with your installation, you can run the tests:

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

Development version¶

Install the latest development version from https://github.com/astropy/regions :

git clone https://github.com/astropy/regions
cd regions
python setup.py install

To run the tests, you will need to make sure the pytest-arraydiff package is installed (version v0.3 or newer). Then, run the tests with:

python setup.py test

To build the documentation, do:

python setup.py build_docs

Navigation