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.

• Code : GitHub repository

• Contributors : https://github.com/astropy/regions/graphs/contributors

Getting Started

• Installation
• Getting Started
• Reporting Issues and Contributing
• License
• Full Changelog

User Documentation

Defining Regions

• Region Shapes
• Region Metadata

Using Regions

• Checking for Points Inside Regions
• Combining Regions
• Computing Overlap Masks
• Coordinate Frame Transformation of Spherical Regions
• Bounding Regions for On-Sky Spatial Searches
• Plotting Regions with Matplotlib

I/O & Reference

• Reading/Writing Region Files
• Converting Regions to Shapely Objects
• Reference/API

Examples

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)

The next example demonstrates how to plot spherical regions (e.g., a circle and a longitude/latitude “range”) on a full sky image (seen in the visualization demo here) using Matplotlib.

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