measure_ee

poppy.measure_ee(HDUlist_or_filename=None, ext=0, center=None, binsize=None, normalize='None')

measure encircled energy vs radius and return as an interpolator

Returns a function object which when called returns the Encircled Energy inside a given radius, for any arbitrary desired radius smaller than the image size.

HDUlist_or_filename : string

Either a fits.HDUList object or a filename of a FITS file on disk

ext : int

Extension in that FITS file

center : tuple of floats

Coordinates (x,y) of PSF center. Default is image center.

binsize:

size of step for profile. Default is pixel size.

normalize : string

set to ‘peak’ to normalize peak intensity =1, or to ‘total’ to normalize total flux=1. Default is no normalization (i.e. retain whatever normalization was used in computing the PSF itself)

encircled_energy: function

A function which will return the encircled energy interpolated to any desired radius.

>>> ee = measure_ee("someimage.fits")
>>> print "The EE at 0.5 arcsec is ", ee(0.5)