EvaluateLocalWcsPlugin¶
- class lsst.meas.base.EvaluateLocalWcsPlugin(config, name, schema, metadata)¶
Bases:
GenericPlugin
Evaluate the local, linear approximation of the Wcs.
The aim is to store the local calib value within the catalog for later use in the Science Data Model functors.
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
).Methods Summary
fail
(measRecord[, error])Record a measurement failure.
Get the relative execution order of this plugin.
Get the measurement transformation appropriate to this plugin.
makeForcedPlugin
(name)Produce a ForcedPlugin subclass from this GenericPlugin class.
makeLocalTransformMatrix
(wcs, center)Create a local, linear approximation of the wcs transformation matrix.
makeSingleFramePlugin
(name)Produce a SingleFramePlugin subclass from this GenericPlugin class.
measure
(measRecord, exposure, center)Measure a single source.
measureN
(measCat, exposure, refCat, refWcs)Measure multiple sources.
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.
Methods Documentation
- fail(measRecord, error=None)¶
Record a measurement failure.
This default implementation simply records the failure in the source record.
- Parameters:
- measRecord
lsst.afw.table.SourceRecord
Catalog record for the source being measured.
- error
Exception
Error causing failure, or
None
.
- measRecord
- classmethod getExecutionOrder()¶
Get the relative execution order of this plugin.
Must be reimplemented as a class method by concrete derived classes.
- 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.
- classmethod makeForcedPlugin(name)¶
Produce a ForcedPlugin subclass from this GenericPlugin class.
The class is also registered.
- Parameters:
- name
str
Name of plugin to register.
- name
- makeLocalTransformMatrix(wcs, center)¶
Create a local, linear approximation of the wcs transformation matrix.
The approximation is created as if the center is at RA=0, DEC=0. All comparing x,y coordinate are relative to the position of center. Matrix is initially calculated with units arcseconds and then converted to radians. This yields higher precision results due to quirks in AST.
- Parameters:
- wcs
lsst.afw.geom.SkyWcs
Wcs to approximate
- center
lsst.geom.Point2D
Point at which to evaluate the LocalWcs.
- wcs
- Returns:
- localMatrix
numpy.ndarray
Matrix representation the local wcs approximation with units radians.
- localMatrix
- classmethod makeSingleFramePlugin(name)¶
Produce a SingleFramePlugin subclass from this GenericPlugin class.
The class is also registered.
- Parameters:
- name
str
Name of plugin to register.
- name
- measure(measRecord, exposure, center)¶
Measure a single source.
It is the responsibility of this method to perform the desired measurement and record the result in the
measRecord
.- Parameters:
- measRecord
lsst.afw.table.SourceRecord
Catalog record for the source being measured.
- exposure
lsst.afw.image.Exposure
Exposure on which the source is being measured.
- center
lsst.geom.Point2D
Pixel coordinates of the object.
- measRecord
- Raises:
- MeasurementError
Raised if the measurement fails for a known/justifiable reason.
- measureN(measCat, exposure, refCat, refWcs)¶
Measure multiple sources.
It is the responsibility of this method to perform the desired measurement and record the result in the
measCat
.- Parameters:
- measCat
lsst.afw.table.SourceCatalog
Catalog for the sources being measured.
- exposure
lsst.afw.image.Exposure
Exposure on which the source is being measured.
- refCat
lsst.afw.table.SourceCatalog
Reference catalog.
- refWcs
lsst.afw.image.Wcs
Astrometric solution for the reference image.
- measCat
- Raises:
- MeasurementError
Raised if the measurement fails for a known/justifiable reason.