What’s New in Photutils 1.1?#
Overview#
Photutils 1.1 is a major release that adds new functionality since the 1.0 release. Here we highlight some of the major changes. Please see the Changelog for the complete list of changes.
New SourceCatalog class#
A new, significantly faster, SourceCatalog
class was implemented. This new class simplifies the API and takes the
place of the source_properties function and the SourceProperties
LegacySourceCatalog classes. The source_properties function
and SourceProperties class are now deprecated and will eventually
be removed. The source_properties function now returns
LegacySourceCatalog class (deprecated) to distinguish it from the
new SourceCatalog.
Optional keyword arguments in SourceCatalog
can not be input as positional arguments. Please see the
SourceCatalog documentation for the keywords
inputs and their allowed values.
Renamed properties#
Note that many of the source properties have been slightly renamed
in the new SourceCatalog class, e.g.,
‘id’ -> ‘label’
‘background_at_centroid’ -> ‘background_centroid’
‘background_cutout’ -> ‘background’
‘background_cutout_ma’ -> ‘background_ma’
‘data_cutout’ -> ‘data’
‘data_cutout_ma’ -> ‘data_ma’
‘error_cutout’ -> ‘error’
‘error_cutout_ma’ -> ‘error_ma’
‘filtered_data_cutout_ma’ -> ‘convdata_ma’
‘minval_pos’ -> ‘minval_index’
‘minval_xpos’ -> ‘minval_xindex’
‘minval_ypos’ -> ‘minval_yindex’
‘maxval_pos’ -> ‘maxval_index’
‘maxval_xpos’ -> ‘maxval_xindex’
‘maxval_ypos’ -> ‘maxval_yindex’
‘semimajor_axis_sigma’ -> ‘semimajor_sigma’
‘semiminor_axis_sigma’ -> ‘semiminor_sigma’
‘source_sum’ -> ‘segment_flux’
‘source_sum_err’ -> ‘segment_fluxerr’
Also, the ‘centroid’ and ‘cutout_centroid’ properties now return
centroids in (x, y) order to be consistent with the tools in
photutils.centroid.
New methods and attributes#
The new SourceCatalog class has the following
new methods:
circular_photometryfluxfrac_radiusget_labelget_labels
and new attributes:
fwhm(full width at half maximum)segmentsegment_ma