What’s New in Photutils 1.4?

New ApertureStats class

A new ApertureStats class was added. This class can be used to compute statistics of unmasked pixel within an aperture. It can be used to create a catalog of properties, including local-background subtracted aperture photometry with the “exact”, “center”, or “subpixel” method, for sources.

The ApertureStats class can calculate many properties, including statistics like min, max, mean, median, std, sum_aper_area, and sum. It also can be used to calculate morphological properties like centroid, fwhm, semimajor_sigma, semiminor_sigma, orientation, and eccentricity.

The properties can be accessed using ApertureStats attributes or output to an Astropy QTable using the to_table() method.

Please see ApertureStats for the the complete list of properties that can be calculated and the Aperture Statistics documentation for examples.

New clip keyword in BkgZoomInterpolator

A clip keyword was added to the BkgZoomInterpolator class, which is used by Background2D.

By default, BkgZoomInterpolator sets clip=True to prevent the interpolation from producing values outside the given input range. If backwards-compatiblity is needed with older Photutils versions, set clip=False.

Segmentation Performance Improvements

A convolved_data keyword was added to the SourceCatalog class that allows the convolved image to be directly input instead of using the kernel keyword. Convolved data can also be directly input to the detect_sources and deblend_sources functions (using the data parameter) instead of using the kernel keyword. For performance, it is strongly recommended that the user first convolve their data, if desired, and then input the convolved data to each of these segmentation functions. Doing so improves the overall performance by omitting extra convolution steps within each function or class.

Significant improvements were also made to the performance of the SegmentationImage and SourceCatalog classes in the case of large data arrays.

Other changes

Please see the Changelog for the complete list of changes.