AlardLuptonPreconvolveSubtractTask#

class lsst.ip.diffim.AlardLuptonPreconvolveSubtractTask(**kwargs)#

Bases: AlardLuptonSubtractTask

Subtract a template from a science image, convolving the science image before computing the kernel, and also convolving the template before subtraction.

Methods Summary

`run`(template, science, sources[, visitSummary])	Preconvolve the science image with its own PSF, convolve the template image with a PSF-matching kernel and subtract from the preconvolved science image.
`runPreconvolve`(template, science, ...)	Convolve the science image with its own PSF, then convolve the template with a matching kernel and subtract to form the Score exposure.

Methods Documentation

run(template, science, sources, visitSummary=None)#

Preconvolve the science image with its own PSF, convolve the template image with a PSF-matching kernel and subtract from the preconvolved science image.

Parameters#

templatelsst.afw.image.ExposureF: The template image, which has previously been warped to the science image. The template bbox will be padded by a few pixels compared to the science bbox.
sciencelsst.afw.image.ExposureF: The science exposure.
sourceslsst.afw.table.SourceCatalog: Identified sources on the science exposure. This catalog is used to select sources in order to perform the AL PSF matching on stamp images around them.
visitSummarylsst.afw.table.ExposureCatalog, optional: Exposure catalog with complete external calibrations. Catalog uses the detector id for the catalog id, sorted on id for fast lookup.

Returns#

resultslsst.pipe.base.Struct

scoreExposurelsst.afw.image.ExposureF: Result of subtracting the convolved template and science images. Attached PSF is that of the original science image.
matchedTemplatelsst.afw.image.ExposureF: Warped and PSF-matched template exposure. Attached PSF is that of the original science image.
matchedSciencelsst.afw.image.ExposureF: The science exposure after convolving with its own PSF. Attached PSF is that of the original science image.
backgroundModellsst.afw.math.Function2D: Background model that was fit while solving for the PSF-matching kernel
psfMatchingKernellsst.afw.math.Kernel: Final kernel used to PSF-match the template to the science image.

runPreconvolve(template, science, matchedScience, kernelSources, preConvKernel)#

Convolve the science image with its own PSF, then convolve the template with a matching kernel and subtract to form the Score exposure.

Parameters#

templatelsst.afw.image.ExposureF: Template exposure, warped to match the science exposure.
sciencelsst.afw.image.ExposureF: Science exposure to subtract from the template.
matchedSciencelsst.afw.image.ExposureF: The science exposure, convolved with the reflection of its own PSF.
kernelSourceslsst.afw.table.SourceCatalog: Identified sources on the science exposure. This catalog is used to select sources in order to perform the AL PSF matching on stamp images around them.
preConvKernellsst.afw.math.Kernel: The reflection of the kernel that was used to preconvolve the science exposure. Must be normalized to sum to 1.

Returns#

results : lsst.pipe.base.Struct

scoreExposurelsst.afw.image.ExposureF
Result of subtracting the convolved template and science images. Attached PSF is that of the original science image.

matchedTemplatelsst.afw.image.ExposureF
Warped and PSF-matched template exposure. Attached PSF is that of the original science image.

matchedSciencelsst.afw.image.ExposureF
The science exposure after convolving with its own PSF. Attached PSF is that of the original science image.

backgroundModellsst.afw.math.Function2D
Background model that was fit while solving for the PSF-matching kernel

psfMatchingKernellsst.afw.math.Kernel
Final kernel used to PSF-match the template to the science image.