SkyRectangularAperture#

class photutils.aperture.SkyRectangularAperture(positions, w, h, theta=<Quantity 0. deg>)[source]#

Bases: SkyAperture

A rectangular aperture defined in sky coordinates.

The aperture has a single fixed size/shape, but it can have multiple positions (see the positions input).

Parameters:

positionsSkyCoord: The celestial coordinates of the aperture center(s). This can be either scalar coordinates or an array of coordinates.
wscalar Quantity: The full width of the rectangle in angular units. For theta=0 the width side is along the North-South axis.
hscalar Quantity: The full height of the rectangle in angular units. For theta=0 the height side is along the East-West axis.
thetascalar Quantity, optional: The position angle (in angular units) of the rectangle “width” side. For a right-handed world coordinate system, the position angle increases counterclockwise from North (PA=0).

Examples

>>> from astropy.coordinates import SkyCoord
>>> import astropy.units as u
>>> from photutils.aperture import SkyRectangularAperture
>>> positions = SkyCoord(ra=[10.0, 20.0], dec=[30.0, 40.0], unit='deg')
>>> aper = SkyRectangularAperture(positions, 1.0*u.arcsec, 0.5*u.arcsec)

Attributes Summary

`h`	The full height in angular units.
`isscalar`	Whether the instance is scalar (i.e., a single position).
`positions`	The center position(s) in sky coordinates.
`shape`	The shape of the instance.
`theta`	The position angle (in angular units) of the rectangle "width" side.
`w`	The full width in angular units.

Methods Summary

`copy`()	Make an deep copy of this object.
`to_pixel`(wcs)	Convert the aperture to a `RectangularAperture` object defined in pixel coordinates.

Attributes Documentation

h#: The full height in angular units.

isscalar#: Whether the instance is scalar (i.e., a single position).

positions#: The center position(s) in sky coordinates.

shape#: The shape of the instance.

theta#: The position angle (in angular units) of the rectangle “width” side.

w#: The full width in angular units.

Methods Documentation

copy()#

Make an deep copy of this object.

Returns:

resultAperture: A deep copy of the Aperture object.

to_pixel(wcs)[source]#

Convert the aperture to a RectangularAperture object defined in pixel coordinates.

Parameters:

wcsWCS object: A world coordinate system (WCS) transformation that supports the astropy shared interface for WCS (e.g., astropy.wcs.WCS, gwcs.wcs.WCS).

Returns:

apertureRectangularAperture object: A RectangularAperture object.