lsst.meas.base

lsst.meas.base provides core astronomical measurement algorithms and base classes.

Using lsst.meas.base

• Overview of the measurement framework
• Measurement tasks and algorithm plugins
• Investigating LSST Measurements

Contributing

lsst.meas.base is developed at https://github.com/lsst/meas_base. You can find Jira issues for this module under the meas_base component.

Task reference

Command-line tasks

No topics.

Tasks

ApplyApCorrTask

Apply aperture corrections.

BaseMeasurementTask

Ultimate base class for all measurement tasks.

BaseReferencesTask

Base class for forced photometry subtask that fetches reference sources.

CatalogCalculationTask

Run plugins which operate on a catalog of sources.

CoaddSrcReferencesTask

Select reference sources by loading the “coadd source” dataset directly.

ForcedMeasurementTask

Measure sources on an image, constrained by a reference catalog.

MultiBandReferencesTask

Loads references from the multi-band processing scheme.

SingleFrameMeasurementTask

A subtask for measuring the properties of sources on a single exposure.

Configs

BaseMeasurementPluginConfig

Base config class for all measurement plugins.

BasePluginConfig

Base class measurement plugin config classes.

CatalogCalculationClassificationConfig

Configuration for catalog classification plugin.

CatalogCalculationFootprintAreaConfig

Configuration for footprint area catalog calculation plugin.

CatalogCalculationPluginConfig

Default configuration class for catalog calcuation plugins.

ForcedPluginConfig

Base class for configs of forced measurement plugins.

NoiseReplacerConfig

Noise replacement configuration.

SingleFramePluginConfig

Base class for single-frame plugin configuration classes.

SourceSlotConfig

Assign named plugins to measurement slots.

Python API reference

lsst.meas.base Package

Functions

addApCorrName(name)	Register an instrumental flux field name prefix for aperture correction.
generateAlgorithmName(AlgClass)	Generate a name for an algorithm.
getApCorrNameSet()	Get a copy of the field name prefixes which will be aperture corrected.
imageOverlapsTract(tract, imageWcs, imageBox)	Return whether the given bounding box overlaps the tract given a WCS.
makeShapeTransformMatrix(xform)
register(name[, shouldApCorr, apCorrList])	A decorator to register a plugin class in its base class’s registry.
wrapAlgorithm(Base, AlgClass, factory, …)	Wrap a C++ algorithm class to create a measurement plugin.
wrapAlgorithmControl(Base, Control[, …])	Wrap a C++ algorithm’s control class into a Python config class.
wrapForcedAlgorithm(AlgClass, executionOrder)	Expose a C++ ForcedAlgorithm class as a measurement plugin.
wrapSimpleAlgorithm(AlgClass, executionOrder)	Expose a C++ SimpleAlgorithm class as a measurement plugin.
wrapSingleFrameAlgorithm(AlgClass, …[, …])	Expose a C++ SingleFrameAlgorithm class as a measurement plugin.
wrapTransform(transformClass[, hasLogName])	Modify a C++ transform to accept either a Config or a Control.

Classes

ApertureFluxAlgorithm
ApertureFluxControl
ApertureFluxResult
ApertureFluxTransform(ctrl, name, mapper[, …])
ApplyApCorrConfig(*args, **kw)	Aperture correction configuration.
ApplyApCorrTask(schema, **kwds)	Apply aperture corrections.
BaseAlgorithm
BaseMeasurementConfig(*args, **kw)	Base configuration for all measurement driver tasks.
BaseMeasurementPlugin(config, name[, logName])	Base class for all measurement plugins.
BaseMeasurementPluginConfig(*args, **kw)	Base config class for all measurement plugins.
BaseMeasurementTask([algMetadata])	Ultimate base class for all measurement tasks.
BasePlugin(config, name[, logName])	Base class for measurement plugins.
BasePluginConfig(*args, **kw)	Base class measurement plugin config classes.
BaseReferencesTask([butler, schema])	Base class for forced photometry subtask that fetches reference sources.
BaseTransform
BlendednessAlgorithm
BlendednessControl
CatalogCalculationClassificationConfig(…)	Configuration for catalog classification plugin.
CatalogCalculationClassificationPlugin(…)	Plugin which calculates a binary measure of source extendedness.
CatalogCalculationConfig(*args, **kw)	Config class for the catalog calculation driver task.
CatalogCalculationFootprintAreaConfig(*args, …)	Configuration for footprint area catalog calculation plugin.
CatalogCalculationFootprintAreaPlugin(…)	Catalog calculation plugin to record the area of a source’s footprint.
CatalogCalculationPlugin(config, name, …)	Base class for catalog calculation plugins.
CatalogCalculationPluginConfig(*args, **kw)	Default configuration class for catalog calcuation plugins.
CatalogCalculationTask(schema[, plugMetadata])	Run plugins which operate on a catalog of sources.
CentroidChecker
CentroidResult
CentroidResultKey
CentroidTransform
CircularApertureFluxAlgorithm
CoaddSrcReferencesTask([butler, schema])	Select reference sources by loading the “coadd source” dataset directly.
DummyNoiseReplacer()	A noise replacer which does nothing.
EvaluateLocalPhotoCalibPlugin(config, name, …)	Evaluate the local value of the Photometric Calibration in the exposure.
EvaluateLocalPhotoCalibPluginConfig(*args, **kw)	Configuration for the variance calculation plugin.
EvaluateLocalWcsPlugin(config, name, schema, …)	Evaluate the local, linear approximation of the Wcs.
EvaluateLocalWcsPluginConfig(*args, **kw)	Configuration for the variance calculation plugin.
FlagDefinition
FlagDefinitionList
FlagHandler
FluxResult
FluxResultKey
ForcedInputCountPlugin	alias of lsst.meas.base.wrappers.GenericPlugin.makeForcedPlugin.<locals>.ForcedFromGenericPlugin
ForcedMeasurementConfig(*args, **kw)	Config class for forced measurement driver task.
ForcedMeasurementTask(refSchema[, algMetadata])	Measure sources on an image, constrained by a reference catalog.
ForcedPeakCentroidConfig(*args, **kw)	Configuration for the forced peak centroid algorithm.
ForcedPeakCentroidPlugin(config, name, …)	Record the highest peak in a source footprint as its centroid.
ForcedPhotCcdConfig(*args, **kw)	Config class for forced measurement driver task.
ForcedPhotCcdTask([butler, refSchema, …])	A command-line driver for performing forced measurement on CCD images.
ForcedPhotCoaddConfig(*args, **kw)
ForcedPhotCoaddTask([butler, refSchema, …])	A command-line driver for performing forced measurement on coadd images.
ForcedPlugin(config, name, schemaMapper, …)	Base class for forced measurement plugins.
ForcedPluginConfig(*args, **kw)	Base class for configs of forced measurement plugins.
ForcedTransformedCentroidConfig(*args, **kw)	Configuration for the forced transformed centroid algorithm.
ForcedTransformedCentroidPlugin(config, …)	Record the transformation of the reference catalog centroid.
ForcedTransformedShapeConfig(*args, **kw)	Configuration for the forced transformed shape algorithm.
ForcedTransformedShapePlugin(config, name, …)	Record the transformation of the reference catalog shape.
ForcedVariancePlugin	alias of lsst.meas.base.wrappers.GenericPlugin.makeForcedPlugin.<locals>.ForcedFromGenericPlugin
GaussianFluxAlgorithm
GaussianFluxControl
GaussianFluxTransform(ctrl, name, mapper[, …])
GenericPlugin(config, name, schema, metadata)	Abstract base class for a generic plugin.
InputCountConfig(*args, **kw)	Configuration for the input image counting plugin.
LocalBackgroundAlgorithm
LocalBackgroundControl
LocalBackgroundTransform(ctrl, name, mapper)
MagResult
MagResultKey
MeasurementTransform(config, name, mapper)	Base class for measurement transformations.
NaiveCentroidAlgorithm
NaiveCentroidControl
NaiveCentroidTransform(ctrl, name, mapper[, …])
NoiseReplacer(config, exposure, footprints)	Replace sources with noise during measurement.
NoiseReplacerConfig(*args, **kw)	Noise replacement configuration.
NullTransform(config, name, mapper)	Null transform which transfers no data from input to output.
PassThroughTransform(config, name, mapper)	Copy fields from input to output without transformation.
PeakLikelihoodFluxAlgorithm
PeakLikelihoodFluxControl
PeakLikelihoodFluxTransform(ctrl, name, mapper)
PerTractCcdDataIdContainer([level])	A data ID container which combines raw data IDs with a tract.
PixelFlagsAlgorithm
PixelFlagsControl
PluginMap	Map of plugins to be run for a given task.
PluginRegistry([configBaseType])	Base class for plugin registries.
PsfFluxAlgorithm
PsfFluxControl
PsfFluxTransform(ctrl, name, mapper[, logName])
SafeCentroidExtractor
ScaledApertureFluxAlgorithm
ScaledApertureFluxControl
ScaledApertureFluxTransform(ctrl, name, mapper)
SdssCentroidAlgorithm
SdssCentroidControl
SdssCentroidTransform(ctrl, name, mapper[, …])
SdssShapeAlgorithm
SdssShapeControl
SdssShapeResult
SdssShapeResultKey
SdssShapeTransform(ctrl, name, mapper[, logName])
ShapeResult
ShapeResultKey
SimpleAlgorithm
SimpleCentroidTransform(config, name, mapper)	Transform pixel centroid, without uncertainty, to celestial coordinates.
SincCoeffsD
SincCoeffsF
SingleFrameAlgorithm
SingleFrameFPPositionConfig(*args, **kw)	Configuration for the focal plane position measurment algorithm.
SingleFrameFPPositionPlugin(config, name, …)	Algorithm to calculate the position of a centroid on the focal plane.
SingleFrameInputCountPlugin	alias of lsst.meas.base.wrappers.GenericPlugin.makeSingleFramePlugin.<locals>.SingleFrameFromGenericPlugin
SingleFrameJacobianConfig(*args, **kw)	Configuration for the Jacobian calculation plugin.
SingleFrameJacobianPlugin(config, name, …)	Compute the Jacobian and its ratio with a nominal pixel area.
SingleFrameMeasurementConfig(*args, **kw)	Config class for single frame measurement driver task.
SingleFrameMeasurementTask(schema[, algMetadata])	A subtask for measuring the properties of sources on a single exposure.
SingleFramePeakCentroidConfig(*args, **kw)	Configuration for the single frame peak centroiding algorithm.
SingleFramePeakCentroidPlugin(config, name, …)	Record the highest peak in a source footprint as its centroid.
SingleFramePlugin(config, name, schema, metadata)	Base class for single-frame measurement plugin.
SingleFramePluginConfig(*args, **kw)	Base class for single-frame plugin configuration classes.
SingleFrameSkyCoordConfig(*args, **kw)	Configuration for the sky coordinates algorithm.
SingleFrameSkyCoordPlugin(config, name, …)	Record the sky position of an object based on its centroid slot and WCS.
SingleFrameVariancePlugin	alias of lsst.meas.base.wrappers.GenericPlugin.makeSingleFramePlugin.<locals>.SingleFrameFromGenericPlugin
UncertaintyEnum	Members:
VarianceConfig(*args, **kw)	Configuration for the variance calculation plugin.

Class Inheritance Diagram