Astropy Regions

regions is an in-development coordinated package of Astropy for region handling.

To get an overview of available features, see Getting Started.

The eventual goal is to merge this package into the Astropy core package.


This regions package is still in an early stage of development. It is not yet feature complete but API should be stable enough by now. That said, please have a look and try to use it for your applications. Feedback and contributions are welcome!

Getting Started

User Documentation


The following example shows how to read a DS9 region file and plot the regions on an image using Matplotlib.

(Source code, png, hires.png, pdf, svg)