CatalogCalculationPlugin¶
- class lsst.meas.base.CatalogCalculationPlugin(config, name, schema, metadata)¶
Bases:
BasePlugin
Base class for catalog calculation plugins.
- Parameters:
- config
CatalogCalculationPlugin.ConfigClass
Plugin configuration.
- name
str
The string the plugin was registered with.
- schema
lsst.afw.table.Schema
The source schema, New fields should be added here to hold output produced by this plugin.
- metadata
lsst.daf.base.PropertySet
Plugin metadata that will be attached to the output catalog
- config
Attributes Summary
Order for algorithms which require shape, centroid and flux (
float
).Order for algorithms which require only Footprint and Peaks (
float
).Order for catalog calculation plugins.
Order for algorithms which require a shape and a centroid (
float
).Order for algorithms which require a centroid (
float
).Does the plugin operate on a single source or the whole catalog (
str
)?List of available plugins (
lsst.meas.base.PluginRegistry
).Methods Summary
calculate
(cat, **kwargs)Perform the calculation specified by this plugin.
fail
(measRecord[, error])Record a failure of the
measure
ormeasureN
method.Used to set the relative order of plugin execution.
Get the measurement transformation appropriate to this plugin.
Attributes Documentation
- APCORR_ORDER = 3.0¶
Order for algorithms which require shape, centroid and flux (
float
).Notes
These algorithms may assume that
getCentroid
andgetShape
will return good values, that flux has been measured, and that and that a Footprint and its Peaks are available.
- CENTROID_ORDER = 0.0¶
Order for algorithms which require only Footprint and Peaks (
float
).Notes
Algorithms with this execution order include centroids.
- DEFAULT_CATALOGCALCULATION = 4.0¶
Order for catalog calculation plugins.
Notes
These plugins only operate on catalogs; they may not access pixel values.
- FLUX_ORDER = 2.0¶
Order for algorithms which require a shape and a centroid (
float
).Notes
These algorithms may assume that both
getCentroid
andgetShape
will return good values, and that a Footprint and its Peaks are available.
- SHAPE_ORDER = 1.0¶
Order for algorithms which require a centroid (
float
).Notes
These algorithms may refer assume that
getCentroid
will return a good centroid, and that a Footprint and its Peaks are available.
- plugType = 'single'¶
Does the plugin operate on a single source or the whole catalog (
str
)?If the plugin operates on a single source at a time, this should be set to
"single"
; if it expects the whoe catalog, to"multi"
. If the plugin is of type"multi"
, thefail
method must be implemented to accept the whole catalog. If the plugin is of type"single"
,fail
should accept a single source record.
- registry = <lsst.meas.base.pluginRegistry.PluginRegistry object>¶
List of available plugins (
lsst.meas.base.PluginRegistry
).
Methods Documentation
- calculate(cat, **kwargs)¶
Perform the calculation specified by this plugin.
This method can either be used to operate on a single catalog record or a whole catalog, populating it with the output defined by this plugin.
Note that results may be added to catalog records as new columns, or may result in changes to existing values.
- Parameters:
- cat
lsst.afw.table.SourceCatalog
orlsst.afw.table.SourceRecord
May either be a
SourceCatalog
or a singleSourceRecord
, depending on the plugin type. Will be updated in place to contain the results of plugin execution.- **kwargs
Any additional keyword arguments that may be passed to the plugin.
- cat
- fail(measRecord, error=None)¶
Record a failure of the
measure
ormeasureN
method.- Parameters:
- measRecord
lsst.afw.table.SourceRecord
Table record describing the source being measured.
- error
MeasurementError
, optional Only provided if the measurement failed due to a
MeasurementError
being raised; otherwise, will beNone
.
- measRecord
Notes
When the plugin raises an exception, framework will call
BasePlugin.fail
to allow the plugin to set its failure flag field(s). WhenBasePlugin.measureN
raises an exception,BasePlugin.fail
will be called repeatedly with all the records that were being measured.If the exception is an
MeasurementError
, it will be passed as the error argument; in all other cases the error argument will beNone
, and the failure will be logged by the measurement framework as a warning.
- classmethod getExecutionOrder()¶
Used to set the relative order of plugin execution.
The values returned by
getExecutionOrder
are compared across all plugins, and smaller numbers run first.Notes
CatalogCalculationPlugin
s must run withBasePlugin.DEFAULT_CATALOGCALCULATION
or higher.All plugins must implement this method with an appropriate run level
- getLogName()¶
- static getTransformClass()¶
Get the measurement transformation appropriate to this plugin.
This returns a subclass of
transforms.MeasurementTransform
, which may be instantiated with details of the algorithm configuration and then called with information about calibration and WCS to convert from raw measurement quantities to calibrated units. Calibrated data is then provided in a separate output table.Notes
By default, we copy everything from the input to the output without transformation.