lsst.ip.diffim gfb11b3eabb+728cca2e53
Loading...
Searching...
No Matches
lsst.ip.diffim.subtractImages.AlardLuptonPreconvolveSubtractConfig Class Reference
Inheritance diagram for lsst.ip.diffim.subtractImages.AlardLuptonPreconvolveSubtractConfig:
lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig lsst.ip.diffim.subtractImages.AlardLuptonPreconvolveSubtractConnections lsst.ip.diffim.subtractImages.SubtractInputConnections lsst.ip.diffim.subtractImages.SubtractScoreOutputConnections

Public Member Functions

 setDefaults (self)
 validate (self)

Static Public Attributes

 makeKernel
 doDecorrelation
 decorrelate
 requiredTemplateFraction
 minTemplateFractionForExpectedSuccess
 doScaleVariance
 scaleVariance
 doSubtractBackground
 doApplyExternalCalibrations
 sourceSelector
 fallbackSourceSelector
 detectionThreshold
 detectionThresholdMax
 restrictKernelEdgeSources
 maxKernelSources
 minKernelSources
 excludeMaskPlanes
 badMaskPlanes
 preserveTemplateMask
 renameTemplateMask
 preserveMaskPlanes
 allowKernelSourceDetection
str image_type
 template
 science
 sources
 visitSummary
 scoreExposure
 psfMatchingKernel
 kernelSources

Detailed Description

Definition at line 1360 of file subtractImages.py.

Member Function Documentation

◆ setDefaults()

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.setDefaults ( self)
inherited

Definition at line 351 of file subtractImages.py.

◆ validate()

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.validate ( self)
inherited

Definition at line 382 of file subtractImages.py.

Member Data Documentation

◆ allowKernelSourceDetection

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.allowKernelSourceDetection
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=bool,
default=False,
doc="Re-run source detection for kernel candidates if an error is"
" encountered while calculating the matching kernel."
)

Definition at line 331 of file subtractImages.py.

◆ badMaskPlanes

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.badMaskPlanes
staticinherited
Initial value:
= lsst.pex.config.ListField(
dtype=str,
default=("NO_DATA", "BAD", "SAT", "EDGE"),
doc="Mask planes to interpolate over."
)

Definition at line 310 of file subtractImages.py.

◆ decorrelate

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.decorrelate
staticinherited
Initial value:
= lsst.pex.config.ConfigurableField(
target=DecorrelateALKernelTask,
doc="Task to decorrelate the image difference.",
)

Definition at line 221 of file subtractImages.py.

◆ detectionThreshold

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.detectionThreshold
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=float,
default=10,
doc="Minimum signal to noise ratio of detected sources "
"to use for calculating the PSF matching kernel.",
deprecated="No longer used. Will be removed after v30"
)

Definition at line 275 of file subtractImages.py.

◆ detectionThresholdMax

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.detectionThresholdMax
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=float,
default=500,
doc="Maximum signal to noise ratio of detected sources "
"to use for calculating the PSF matching kernel.",
deprecated="No longer used. Will be removed after v30"
)

Definition at line 282 of file subtractImages.py.

◆ doApplyExternalCalibrations

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.doApplyExternalCalibrations
staticinherited
Initial value:
= lsst.pex.config.Field(
doc=(
"Replace science Exposure's calibration objects with those"
" in visitSummary. Ignored if `doApplyFinalizedPsf is True."
),
dtype=bool,
default=False,
)

Definition at line 255 of file subtractImages.py.

◆ doDecorrelation

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.doDecorrelation
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=bool,
default=True,
doc="Perform diffim decorrelation to undo pixel correlation due to A&L "
"kernel convolution? If True, also update the diffim PSF."
)

Definition at line 215 of file subtractImages.py.

◆ doScaleVariance

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.doScaleVariance
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=bool,
default=True,
doc="Scale variance of the science image? Note that the template variance is NOT scaled"
" here. The template variance may be scaled independently in ``GetTemplateTask``."
)

Definition at line 238 of file subtractImages.py.

◆ doSubtractBackground

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.doSubtractBackground
staticinherited
Initial value:
= lsst.pex.config.Field(
doc="Subtract the background fit when solving the kernel? "
"It is generally better to instead subtract the background in detectAndMeasure.",
dtype=bool,
default=False,
deprecated="Subtract the background in detectAndMeasure instead. Will be removed after v31.",
)

Definition at line 248 of file subtractImages.py.

◆ excludeMaskPlanes

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.excludeMaskPlanes
staticinherited
Initial value:
= lsst.pex.config.ListField(
dtype=str,
default=("NO_DATA", "BAD", "SAT", "EDGE", "FAKE", "HIGH_VARIANCE"),
doc="Template mask planes to exclude when selecting sources for PSF matching.",
)

Definition at line 305 of file subtractImages.py.

◆ fallbackSourceSelector

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.fallbackSourceSelector
staticinherited
Initial value:
= lsst.pex.config.ConfigurableField(
target=ScienceSourceSelectorTask,
doc="Task to select sources to be used for PSF matching."
"Used only if the kernel calculation fails and"
"`allowKernelSourceDetection` is set. The fallback source detection"
" will not include all of the same plugins as the original source "
" detection, so not all of the same flags can be used.",
)

Definition at line 267 of file subtractImages.py.

◆ image_type

str lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.image_type
staticinherited
Initial value:
= lsst.pex.config.ChoiceField[str](
doc="Image type of the input template, the image outputs of this"
" task (difference and matchedTemplate, or scoreExposure), and the PSF"
" matching kernel.",
allowed={
"legacy": "Read and write lsst.afw.image.ExposureF and"
" lsst.afw.math.Kernel.",
"future": "Read and write lsst.images.DifferenceImage and"
" lsst.images.convolution_kernels.ConvolutionKernel.",
},
optional=False,
default="legacy",
)

Definition at line 337 of file subtractImages.py.

◆ kernelSources

lsst.ip.diffim.subtractImages.SubtractScoreOutputConnections.kernelSources
staticinherited
Initial value:
= connectionTypes.Output(
doc="Final selection of sources used for psf matching.",
dimensions=("instrument", "visit", "detector"),
storageClass="SourceCatalog",
name="{fakesType}{coaddName}Diff_psfScoreMatchSources"
)

Definition at line 170 of file subtractImages.py.

◆ makeKernel

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.makeKernel
staticinherited
Initial value:
= lsst.pex.config.ConfigurableField(
target=MakeKernelTask,
doc="Task to construct a matching kernel for convolution.",
)

Definition at line 211 of file subtractImages.py.

◆ maxKernelSources

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.maxKernelSources
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=int,
default=1000,
doc="Maximum number of sources to use for calculating the PSF matching kernel."
"Set to -1 to disable."
)

Definition at line 294 of file subtractImages.py.

◆ minKernelSources

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.minKernelSources
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=int,
default=3,
doc="Minimum number of sources needed for calculating the PSF matching kernel."
)

Definition at line 300 of file subtractImages.py.

◆ minTemplateFractionForExpectedSuccess

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.minTemplateFractionForExpectedSuccess
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=float,
default=0.2,
doc="Raise NoWorkFound if PSF-matching fails and template covers less than this fraction of pixels."
" If the fraction of pixels covered by the template is less than this value (and greater than"
" requiredTemplateFraction) this task is attempted but failure is anticipated and tolerated."
)

Definition at line 231 of file subtractImages.py.

◆ preserveMaskPlanes

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.preserveMaskPlanes
staticinherited
Initial value:
= lsst.pex.config.ListField(
dtype=str,
default=("INJECTED", "INJECTED_CORE", "INJECTED_TEMPLATE", "INJECTED_CORE_TEMPLATE"),
doc="Mask planes to preserve without dilation when convolving the image.",
)

Definition at line 326 of file subtractImages.py.

◆ preserveTemplateMask

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.preserveTemplateMask
staticinherited
Initial value:
= lsst.pex.config.ListField(
dtype=str,
default=("NO_DATA", "BAD", "HIGH_VARIANCE"),
doc="Mask planes from the template to propagate to the image difference."
)

Definition at line 315 of file subtractImages.py.

◆ psfMatchingKernel

lsst.ip.diffim.subtractImages.SubtractScoreOutputConnections.psfMatchingKernel
staticinherited
Initial value:
= connectionTypes.Output(
doc="Kernel used to PSF match the science and template images.",
dimensions=("instrument", "visit", "detector"),
storageClass="MatchingKernel",
name="{fakesType}{coaddName}Diff_psfScoreMatchKernel",
)

Definition at line 164 of file subtractImages.py.

◆ renameTemplateMask

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.renameTemplateMask
staticinherited
Initial value:
= lsst.pex.config.ListField(
dtype=str,
default=("SAT", "INJECTED", "INJECTED_CORE",),
doc="Mask planes from the template to propagate to the image difference"
"with '_TEMPLATE' appended to the name."
)

Definition at line 320 of file subtractImages.py.

◆ requiredTemplateFraction

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.requiredTemplateFraction
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=float,
default=0.1,
doc="Raise NoWorkFound and do not attempt image subtraction if template covers less than this "
" fraction of pixels. Setting to 0 will always attempt image subtraction."
)

Definition at line 225 of file subtractImages.py.

◆ restrictKernelEdgeSources

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.restrictKernelEdgeSources
staticinherited
Initial value:
= lsst.pex.config.Field(
dtype=bool,
default=True,
doc="Exclude sources close to the edge from the kernel calculation?"
)

Definition at line 289 of file subtractImages.py.

◆ scaleVariance

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.scaleVariance
staticinherited
Initial value:
= lsst.pex.config.ConfigurableField(
target=ScaleVarianceTask,
doc="Subtask to rescale the variance of the template to the statistically expected level."
)

Definition at line 244 of file subtractImages.py.

◆ science

lsst.ip.diffim.subtractImages.SubtractInputConnections.science
staticinherited
Initial value:
= connectionTypes.Input(
doc="Input science exposure to subtract from."
" With image_type='future' this is read as a lsst.images.VisitImage, so that its"
" photometric scaling can be passed on to the outputs.",
dimensions=("instrument", "visit", "detector"),
storageClass="ExposureF",
name="{fakesType}calexp"
)

Definition at line 84 of file subtractImages.py.

◆ scoreExposure

lsst.ip.diffim.subtractImages.SubtractScoreOutputConnections.scoreExposure
staticinherited
Initial value:
= connectionTypes.Output(
doc="The maximum likelihood image, used for the detection of diaSources.",
dimensions=("instrument", "visit", "detector"),
storageClass="ExposureF",
name="{fakesType}{coaddName}Diff_scoreTempExp",
)

Definition at line 158 of file subtractImages.py.

◆ sources

lsst.ip.diffim.subtractImages.SubtractInputConnections.sources
staticinherited
Initial value:
= connectionTypes.Input(
doc="Sources measured on the science exposure; "
"used to select sources for making the matching kernel.",
dimensions=("instrument", "visit", "detector"),
storageClass="SourceCatalog",
name="{fakesType}src"
)

Definition at line 92 of file subtractImages.py.

◆ sourceSelector

lsst.ip.diffim.subtractImages.AlardLuptonSubtractBaseConfig.sourceSelector
staticinherited
Initial value:
= lsst.pex.config.ConfigurableField(
target=ScienceSourceSelectorTask,
doc="Task to select sources to be used for PSF matching.",
)

Definition at line 263 of file subtractImages.py.

◆ template

lsst.ip.diffim.subtractImages.SubtractInputConnections.template
staticinherited
Initial value:
= connectionTypes.Input(
doc="Input warped template to subtract."
" With image_type='future' this is read as a lsst.images.DifferenceImage, so that the"
" record of the coadds that went into it can be passed on to the outputs.",
dimensions=("instrument", "visit", "detector"),
storageClass="ExposureF",
name="{fakesType}{coaddName}Diff_templateExp"
)

Definition at line 76 of file subtractImages.py.

◆ visitSummary

lsst.ip.diffim.subtractImages.SubtractInputConnections.visitSummary
staticinherited
Initial value:
= connectionTypes.Input(
doc=("Per-visit catalog with final calibration objects. "
"These catalogs use the detector id for the catalog id, "
"sorted on id for fast lookup."),
dimensions=("instrument", "visit"),
storageClass="ExposureCatalog",
name="finalVisitSummary",
)

Definition at line 99 of file subtractImages.py.


The documentation for this class was generated from the following file: