lsst.meas.base

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

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

ForcedPhotCcdTask
A command-line driver for performing forced measurement on CCD images.
ForcedPhotCoaddTask
A command-line driver for performing forced measurement on coadd images.
ForcedPhotImageTask
A base class for command-line forced measurement drivers.

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 Aperture correction configuration.
ApplyApCorrTask(schema, **kwds) Apply aperture corrections.
BaseAlgorithm
BaseMeasurementConfig Base configuration for all measurement driver tasks.
BaseMeasurementPlugin(config, name[, logName]) Base class for all measurement plugins.
BaseMeasurementPluginConfig 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 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 Config class for the catalog calculation driver task.
CatalogCalculationFootprintAreaConfig 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 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.
FlagDefinition
FlagDefinitionList
FlagHandler
FluxResult
FluxResultKey
ForcedInputCountPlugin alias of lsst.meas.base.wrappers.GenericPlugin.makeForcedPlugin.<locals>.ForcedFromGenericPlugin
ForcedMeasurementConfig Config class for forced measurement driver task.
ForcedMeasurementTask(refSchema[, algMetadata]) Measure sources on an image, constrained by a reference catalog.
ForcedPeakCentroidConfig Configuration for the forced peak centroid algorithm.
ForcedPeakCentroidPlugin(config, name, …) Record the highest peak in a source footprint as its centroid.
ForcedPhotCcdConfig
ForcedPhotCcdTask([butler, refSchema]) A command-line driver for performing forced measurement on CCD images.
ForcedPhotCoaddConfig
ForcedPhotCoaddTask([butler, refSchema]) A command-line driver for performing forced measurement on coadd images.
ForcedPhotImageConfig Config class for forced measurement driver task.
ForcedPhotImageTask([butler, refSchema]) A base class for command-line forced measurement drivers.
ForcedPlugin(config, name, schemaMapper, …) Base class for forced measurement plugins.
ForcedPluginConfig Base class for configs of forced measurement plugins.
ForcedTransformedCentroidConfig Configuration for the forced transformed centroid algorithm.
ForcedTransformedCentroidPlugin(config, …) Record the transformation of the reference catalog centroid.
ForcedTransformedShapeConfig 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 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 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 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 Configuration for the Jacobian calculation plugin.
SingleFrameJacobianPlugin(config, name, …) Compute the Jacobian and its ratio with a nominal pixel area.
SingleFrameMeasurementConfig Config class for single frame measurement driver task.
SingleFrameMeasurementTask(schema[, algMetadata]) A subtask for measuring the properties of sources on a single exposure.
SingleFramePeakCentroidConfig 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 Base class for single-frame plugin configuration classes.
SingleFrameSkyCoordConfig 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
VarianceConfig Configuration for the variance calculation plugin.

Class Inheritance Diagram

Inheritance diagram of lsst.meas.base.apertureFlux.ApertureFluxAlgorithm, lsst.meas.base.apertureFlux.ApertureFluxControl, lsst.meas.base.apertureFlux.ApertureFluxResult, lsst.meas.base.apertureFlux.ApertureFluxTransform, lsst.meas.base.applyApCorr.ApplyApCorrConfig, lsst.meas.base.applyApCorr.ApplyApCorrTask, lsst.meas.base.algorithm.BaseAlgorithm, lsst.meas.base.baseMeasurement.BaseMeasurementConfig, lsst.meas.base.baseMeasurement.BaseMeasurementPlugin, lsst.meas.base.baseMeasurement.BaseMeasurementPluginConfig, lsst.meas.base.baseMeasurement.BaseMeasurementTask, lsst.meas.base.pluginsBase.BasePlugin, lsst.meas.base.pluginsBase.BasePluginConfig, lsst.meas.base.references.BaseReferencesTask, lsst.meas.base.transform.BaseTransform, lsst.meas.base.blendedness.BlendednessAlgorithm, lsst.meas.base.blendedness.BlendednessControl, lsst.meas.base.classification.CatalogCalculationClassificationConfig, lsst.meas.base.classification.CatalogCalculationClassificationPlugin, lsst.meas.base.catalogCalculation.CatalogCalculationConfig, lsst.meas.base.footprintArea.CatalogCalculationFootprintAreaConfig, lsst.meas.base.footprintArea.CatalogCalculationFootprintAreaPlugin, lsst.meas.base.catalogCalculation.CatalogCalculationPlugin, lsst.meas.base.catalogCalculation.CatalogCalculationPluginConfig, lsst.meas.base.catalogCalculation.CatalogCalculationTask, lsst.meas.base.centroidUtilities.CentroidChecker, lsst.meas.base.centroidUtilities.CentroidResult, lsst.meas.base.centroidUtilities.CentroidResultKey, lsst.meas.base.centroidUtilities.CentroidTransform, lsst.meas.base.circularApertureFlux.CircularApertureFluxAlgorithm, lsst.meas.base.references.CoaddSrcReferencesTask, lsst.meas.base.noiseReplacer.DummyNoiseReplacer, lsst.meas.base.flagHandler.FlagDefinition, lsst.meas.base.flagHandler.FlagDefinitionList, lsst.meas.base.flagHandler.FlagHandler, lsst.meas.base.fluxUtilities.FluxResult, lsst.meas.base.fluxUtilities.FluxResultKey, lsst.meas.base.forcedMeasurement.ForcedMeasurementConfig, lsst.meas.base.forcedMeasurement.ForcedMeasurementTask, lsst.meas.base.plugins.ForcedPeakCentroidConfig, lsst.meas.base.plugins.ForcedPeakCentroidPlugin, lsst.meas.base.forcedPhotCcd.ForcedPhotCcdConfig, lsst.meas.base.forcedPhotCcd.ForcedPhotCcdTask, lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddConfig, lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask, lsst.meas.base.forcedPhotImage.ForcedPhotImageConfig, lsst.meas.base.forcedPhotImage.ForcedPhotImageTask, lsst.meas.base.forcedMeasurement.ForcedPlugin, lsst.meas.base.forcedMeasurement.ForcedPluginConfig, lsst.meas.base.plugins.ForcedTransformedCentroidConfig, lsst.meas.base.plugins.ForcedTransformedCentroidPlugin, lsst.meas.base.plugins.ForcedTransformedShapeConfig, lsst.meas.base.plugins.ForcedTransformedShapePlugin, lsst.meas.base.gaussianFlux.GaussianFluxAlgorithm, lsst.meas.base.gaussianFlux.GaussianFluxControl, lsst.meas.base.gaussianFlux.GaussianFluxTransform, lsst.meas.base.wrappers.GenericPlugin, lsst.meas.base.plugins.InputCountConfig, lsst.meas.base.localBackground.LocalBackgroundAlgorithm, lsst.meas.base.localBackground.LocalBackgroundControl, lsst.meas.base.localBackground.LocalBackgroundTransform, lsst.meas.base.fluxUtilities.MagResult, lsst.meas.base.fluxUtilities.MagResultKey, lsst.meas.base.transforms.MeasurementTransform, lsst.meas.base.naiveCentroid.NaiveCentroidAlgorithm, lsst.meas.base.naiveCentroid.NaiveCentroidControl, lsst.meas.base.naiveCentroid.NaiveCentroidTransform, lsst.meas.base.noiseReplacer.NoiseReplacer, lsst.meas.base.noiseReplacer.NoiseReplacerConfig, lsst.meas.base.transforms.NullTransform, lsst.meas.base.transforms.PassThroughTransform, lsst.meas.base.peakLikelihoodFlux.PeakLikelihoodFluxAlgorithm, lsst.meas.base.peakLikelihoodFlux.PeakLikelihoodFluxControl, lsst.meas.base.peakLikelihoodFlux.PeakLikelihoodFluxTransform, lsst.meas.base.forcedPhotCcd.PerTractCcdDataIdContainer, lsst.meas.base.pixelFlags.PixelFlagsAlgorithm, lsst.meas.base.pixelFlags.PixelFlagsControl, lsst.meas.base.pluginRegistry.PluginMap, lsst.meas.base.pluginRegistry.PluginRegistry, lsst.meas.base.psfFlux.PsfFluxAlgorithm, lsst.meas.base.psfFlux.PsfFluxControl, lsst.meas.base.psfFlux.PsfFluxTransform, lsst.meas.base.inputUtilities.SafeCentroidExtractor, lsst.meas.base.scaledApertureFlux.ScaledApertureFluxAlgorithm, lsst.meas.base.scaledApertureFlux.ScaledApertureFluxControl, lsst.meas.base.scaledApertureFlux.ScaledApertureFluxTransform, lsst.meas.base.sdssCentroid.SdssCentroidAlgorithm, lsst.meas.base.sdssCentroid.SdssCentroidControl, lsst.meas.base.sdssCentroid.SdssCentroidTransform, lsst.meas.base.sdssShape.SdssShapeAlgorithm, lsst.meas.base.sdssShape.SdssShapeControl, lsst.meas.base.sdssShape.SdssShapeResult, lsst.meas.base.sdssShape.SdssShapeResultKey, lsst.meas.base.sdssShape.SdssShapeTransform, lsst.meas.base.shapeUtilities.ShapeResult, lsst.meas.base.shapeUtilities.ShapeResultKey, lsst.meas.base.algorithm.SimpleAlgorithm, lsst.meas.base.transforms.SimpleCentroidTransform, lsst.meas.base.sincCoeffs.SincCoeffsD, lsst.meas.base.sincCoeffs.SincCoeffsF, lsst.meas.base.algorithm.SingleFrameAlgorithm, lsst.meas.base.plugins.SingleFrameFPPositionConfig, lsst.meas.base.plugins.SingleFrameFPPositionPlugin, lsst.meas.base.plugins.SingleFrameJacobianConfig, lsst.meas.base.plugins.SingleFrameJacobianPlugin, lsst.meas.base.sfm.SingleFrameMeasurementConfig, lsst.meas.base.sfm.SingleFrameMeasurementTask, lsst.meas.base.plugins.SingleFramePeakCentroidConfig, lsst.meas.base.plugins.SingleFramePeakCentroidPlugin, lsst.meas.base.sfm.SingleFramePlugin, lsst.meas.base.sfm.SingleFramePluginConfig, lsst.meas.base.plugins.SingleFrameSkyCoordConfig, lsst.meas.base.plugins.SingleFrameSkyCoordPlugin, lsst.meas.base.plugins.VarianceConfig