# Installation

## 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

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 conda-forge channel on anaconda.org simply run:

    conda install -c conda-forge 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 https://github.com/astropy/pyregion :

    git clone https://github.com/astropy/pyregion
    cd pyregion
    python setup.py install
    python setup.py test
    python setup.py build_docs

## Dependencies

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

    - Homepage

    - PyPI page

`pyregion` has the following optional dependencies for plotting:

- matplotlib

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.