EvaluateLocalWcsPlugin

class lsst.meas.base.EvaluateLocalWcsPlugin(config, name, schema, metadata)

Bases: lsst.meas.base.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

APCORR_ORDER
CENTROID_ORDER
DEFAULT_CATALOGCALCULATION
FLUX_ORDER
SHAPE_ORDER

Methods Summary

fail(measRecord[, error]) Record a measurement failure.
getExecutionOrder() Get the relative execution order of this plugin.
getLogName()
getTransformClass() 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
CENTROID_ORDER = 0.0
DEFAULT_CATALOGCALCULATION = 4.0
FLUX_ORDER = 2.0
SHAPE_ORDER = 1.0

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.

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.

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.

Returns:
localMatrix : numpy.ndarray

Matrix representation the local wcs approximation with units radians.

classmethod makeSingleFramePlugin(name)

Produce a SingleFramePlugin subclass from this GenericPlugin class.

The class is also registered.

Parameters:
name : str

Name of plugin to register.

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.

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.

Raises:
MeasurementError

Raised if the measurement fails for a known/justifiable reason.