Python 2.7 and 3.4+ are supported.

pyregion has the following required dependencies:

  • Astropy version 1.0 or later (which requires Numpy)
  • pyparsing version 2.0 or later for parsing the DS9 region files

pyregion has the following optional dependencies for plotting:

If you are using Astropy version 1.3 or later, then you have astropy.visualization.wcsaxes. For older versions of Astropy, you have to install the separate package: wcsaxes

To work with the development version, you’ll need Cython and a C compiler, because the code to generate masks from regions is written in Cython.

Stable version

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

Using pip

To install pyregion with pip from PyPI simply run:

pip install --no-deps pyregion


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 simply run:

conda install -c astropy pyregion

Testing installation

To check if your install is OK, run the tests:

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

Development version

Install the latest development version from :

git clone
cd pyregion
python install
python test
python build_docs