ImageDifferenceTask¶
Python API summary¶
from lsst.pipe.tasks.imageDifference import ImageDifferenceTask
-
class
ImageDifferenceTask Subtract an image from a template and measure the result
...
-
attribute
config Access configuration fields and retargetable subtasks.
-
method
run PSF matches, subtract two images and perform detection on the difference image
...
-
method
runDataRef Subtract an image from a template coadd and measure the result
...
See also
See the ImageDifferenceTask API reference for complete details.
Retargetable subtasks¶
applyApCorr¶
- Default
lsst.meas.base.applyApCorr.ApplyApCorrTask- Field type
ConfigurableField
Subtask to apply aperture corrections
astrometer¶
- Default
lsst.meas.astrom.astrometry.AstrometryTask- Field type
ConfigurableField
astrometry task; used to match sources to reference objects, but not to fit a WCS
decorrelate¶
- Default
lsst.ip.diffim.imageDecorrelation.DecorrelateALKernelSpatialTask- Field type
ConfigurableField
Decorrelate effects of A&L kernel convolution on image difference, only if doSubtract is True. If this option is enabled, then detection.thresholdValue should be set to 5.0 (rather than the default of 5.5).
detection¶
- Default
lsst.meas.algorithms.detection.SourceDetectionTask- Field type
ConfigurableField
Low-threshold detection for final measurement
forcedMeasurement¶
- Default
lsst.meas.base.forcedMeasurement.ForcedMeasurementTask- Field type
ConfigurableField
Subtask to force photometer PVI at diaSource location.
getTemplate¶
- Default
lsst.ip.diffim.getTemplate.GetCoaddAsTemplateTask- Field type
ConfigurableField
Subtask to retrieve template exposure and sources
measurement¶
- Default
lsst.ip.diffim.dipoleFitTask.DipoleFitTask- Field type
ConfigurableField
Enable updated dipole fitting method
refObjLoader¶
- Default
lsst.meas.algorithms.loadIndexedReferenceObjects.LoadIndexedReferenceObjectsTask- Field type
ConfigurableField
reference object loader
register¶
- Default
lsst.pipe.tasks.registerImage.RegisterTask- Field type
ConfigurableField
Task to enable image-to-image image registration (warping)
scaleVariance¶
- Default
lsst.pipe.tasks.scaleVariance.ScaleVarianceTask- Field type
ConfigurableField
Subtask to rescale the variance of the template to the statistically expected level
skySources¶
- Default
lsst.meas.algorithms.skyObjects.SkyObjectsTask- Field type
ConfigurableField
Generate sky sources
sourceSelector¶
- Default
lsst.meas.algorithms.objectSizeStarSelector.ObjectSizeStarSelectorTask- Field type
ConfigurableField
Source selection algorithm
subtract¶
- Default
'al'- Field type
- Single-selection
RegistryField - Choices
'al'lsst.ip.diffim.imagePsfMatch.ImagePsfMatchTask'zogy'lsst.ip.diffim.zogy.ZogyImagePsfMatchTask
Subtraction Algorithm
Configuration fields¶
coaddName¶
coadd name: typically one of deep, goodSeeing, or dcr
connections¶
- Data type
lsst.pipe.base.config.Connections- Field type
ConfigField
Configurations describing the connections of the PipelineTask to datatypes
controlStepSize¶
What step size (every Nth one) to select a control sample from the kernelSources
convolveTemplate¶
Which image gets convolved (default = template)
diaSourceMatchRadius¶
Match radius (in arcseconds) for DiaSource to Source association
doAddCalexpBackground¶
Add background to calexp before processing it. Useful as ipDiffim does background matching.
doAddMetrics¶
Add columns to the source table to hold analysis metrics?
doDecorrelation¶
Perform diffim decorrelation to undo pixel correlation due to A&L kernel convolution (AL only)? If True, also update the diffim PSF.
doForcedMeasurement¶
Force photometer diaSource locations on PVI?
doMatchSources¶
Match diaSources with input calexp sources and ref catalog sources
doMerge¶
Merge positive and negative diaSources with grow radius set by growFootprint
doPreConvolve¶
Not in use. Superseded by useScoreImageDetection. Deprecated: This option superseded by useScoreImageDetection. Will be removed after v22.
doScaleDiffimVariance¶
Scale variance of the diffim before PSF matching. You may do either this or template variance scaling, or neither. (Doing both is a waste of CPU.)
doScaleTemplateVariance¶
Scale variance of the template before PSF matching
doSelectDcrCatalog¶
Select stars of extreme color as part of the control sample (AL only)
doSelectSources¶
Select stars to use for kernel fitting (AL only)
doSelectVariableCatalog¶
Select stars that are variable to be part of the control sample (AL only)
doSpatiallyVarying¶
Perform A&L decorrelation on a grid across the image in order to allow for spatial variations. Zogy does not use this option.
doUseRegister¶
Re-compute astrometry on the template. Use image-to-image registration to align template with science image (AL only).
doWriteMatchedExp¶
Write warped and PSF-matched template coadd exposure?
growFootprint¶
Grow positive and negative footprints by this amount before merging
kernelSourcesFromRef¶
Select sources to measure kernel from reference catalog if True, template if false
requiredTemplateFraction¶
Do not attempt to run task if template covers less than this fraction of pixels.Setting to 0 will always attempt image subtraction
saveLogOutput¶
Flag to enable/disable saving of log output for a task, enabled by default.
saveMetadata¶
Flag to enable/disable metadata saving for a task, enabled by default.
templateSipOrder¶
Sip Order for fitting the Template Wcs (default is too high, overfitting)
useGaussianForPreConvolution¶
Use a simple gaussian PSF model for pre-convolution (oherwise use exposure PSF)? (AL and if useScoreImageDetection=True only)
Python API reference¶
lsst.pipe.tasks.imageDifference Module¶
Classes¶
ImageDifferenceConfig |
Config for ImageDifferenceTask |
ImageDifferenceTask([butler]) |
Subtract an image from a template and measure the result |