lsst.ip.diffim¶
The lsst.ip.diffim module provides algorithms for astronomical image differencing.
Contributing¶
lsst.ip.diffim is developed at https://github.com/lsst/ip_diffim.
You can find Jira issues for this module under the ip_diffim component.
Task reference¶
Tasks¶
- FractionDiaSourcesToSciSourcesMetricTask
- Task that computes the ratio of difference image sources to science sources in an image, visit, etc.
- NumberSciSourcesMetricTask
- Task that computes the number of cataloged science sources.
Configurations¶
No topics.
Python API reference¶
lsst.ip.diffim Package¶
Functions¶
| AssessSpatialKernelVisitorF | |
| BuildSingleKernelVisitorF | |
| BuildSpatialKernelVisitorF | |
| ImageStatisticsF | |
| KernelCandidateDetectionF | |
| KernelCandidateF | |
| KernelSumVisitorF | |
| applyDcr(image, dcr[, useInverse, …]) | Shift an image along the X and Y directions. | 
| backgroundSubtract(config, maskedImages) | Subtract the background from masked images. | 
| calculateDcr(visitInfo, wcs, filterInfo, …) | Calculate the shift in pixels of an exposure due to DCR. | 
| calculateImageParallacticAngle(visitInfo, wcs) | Calculate the total sky rotation angle of an exposure. | 
| convolveAndSubtract(*args, **kwargs) | Overloaded function. | 
| generateAlardLuptonBasisList(config[, …]) | Generate an Alard-Lupton kernel basis list based upon the Config and the input FWHM of the science and template images. | 
| makeAlardLuptonBasisList(halfWidth, nGauss, …) | |
| makeAssessSpatialKernelVisitor(…) | |
| makeBuildSingleKernelVisitor(*args, **kwargs) | Overloaded function. | 
| makeBuildSpatialKernelVisitor(basisList, …) | |
| makeCentralDifferenceMatrix(width, height, …) | |
| makeDeltaFunctionBasisList(width, height) | |
| makeForwardDifferenceMatrix(width, height, …) | |
| makeKernelBasisList(config[, targetFwhmPix, …]) | Generate the delta function or Alard-Lupton kernel bases depending on the Config. | 
| makeKernelCandidate(*args, **kwargs) | Overloaded function. | 
| makeKernelPcaVisitor(imagePca) | |
| makeKernelSumVisitor(ps) | |
| makeRegularizationMatrix(ps) | |
| renormalizeKernelList(kernelListIn) | |
| sourceToFootprintList(candidateInList, …) | Convert a list of sources for the PSF-matching Kernel to Footprints. | 
| writeKernelCellSet(kernelCellSet, …) | TODO: DM-17458 | 
Classes¶
| ClassificationDipoleConfig | Configuration for classification of detected diaSources as dipole or not | 
| ClassificationDipolePlugin(config, name, …) | A plugin to classify whether a diaSource is a dipole. | 
| DcrModel(modelImages[, filterInfo, psf, …]) | A model of the true sky after correcting chromatic effects. | 
| DecorrelateALKernelConfig | Configuration parameters for the DecorrelateALKernelTask | 
| DecorrelateALKernelMapReduceConfig | Configuration parameters for the ImageMapReduceTask to direct it to use DecorrelateALKernelMapper as its mapper for A&L decorrelation. | 
| DecorrelateALKernelMapper(*args, **kwargs) | Task to be used as an ImageMapper for performing A&L decorrelation on subimages on a grid across a A&L difference image. | 
| DecorrelateALKernelSpatialConfig | Configuration parameters for the DecorrelateALKernelSpatialTask. | 
| DecorrelateALKernelSpatialTask(*args, **kwargs) | Decorrelate the effect of convolution by Alard-Lupton matching kernel in image difference | 
| DecorrelateALKernelTask(*args, **kwargs) | Decorrelate the effect of convolution by Alard-Lupton matching kernel in image difference | 
| DetectionConfig | Configuration for detecting sources on images for building a PSF-matching kernel | 
| DiaCatalogSourceSelectorConfig | |
| DiaCatalogSourceSelectorTask(**kwargs) | A task that selects sources for Kernel candidates. | 
| DiaSourceAnalyst(config) | |
| DiaSourceAnalystConfig | |
| DipoleAnalysis() | Functor class that provides (S/N, position, orientation) of measured dipoles | 
| DipoleCentroidControl | |
| DipoleDeblender() | Functor to deblend a source as a dipole, and return a new source with deblended footprints. | 
| DipoleFitAlgorithm(diffim[, posImage, negImage]) | Fit a dipole model using an image difference. | 
| DipoleFitPlugin(config, name, schema, metadata) | A single frame measurement plugin that fits dipoles to all merged (two-peak) diaSources. | 
| DipoleFitPluginConfig | Configuration for DipoleFitPlugin | 
| DipoleFitTask(schema[, algMetadata]) | A task that fits a dipole to a difference image, with an optional separate detection image. | 
| DipoleFitTaskConfig | Measurement of detected diaSources as dipoles | 
| DipoleFluxControl | |
| DipoleMeasurementConfig | Measurement of detected diaSources as dipoles | 
| DipoleMeasurementTask(schema[, algMetadata]) | Measurement of Sources, specifically ones from difference images, for characterization as dipoles | 
| FindSetBitsU | |
| GetCalexpAsTemplateConfig | |
| GetCalexpAsTemplateTask([config, name, …]) | Subtask to retrieve calexp of the same ccd number as the science image SensorRef for use as an image difference template. | 
| GetCoaddAsTemplateConfig | |
| GetCoaddAsTemplateTask([config, name, …]) | Subtask to retrieve coadd for use as an image difference template. | 
| ImageMapReduceConfig | Configuration parameters for the ImageMapReduceTask | 
| ImageMapReduceTask(*args, **kwargs) | Split an Exposure into subExposures (optionally on a grid) and perform the same operation on each. | 
| ImageMapper([config, name, parentTask, log]) | Abstract base class for any task that is to be used as ImageMapReduceConfig.mapper. | 
| ImageMapperConfig | Configuration parameters for ImageMapper | 
| ImagePsfMatchConfig | Configuration for image-to-image Psf matching. | 
| ImagePsfMatchTask(*args, **kwargs) | Psf-match two MaskedImages or Exposures using the sources in the images. | 
| ImageReducer([config, name, parentTask, log]) | Base class for any ‘reduce’ task that is to be used as ImageMapReduceConfig.reducer. | 
| ImageReducerConfig | Configuration parameters for the ImageReducer | 
| ImageStatisticsD | |
| ImageStatisticsI | |
| KernelCandidateQa(nKernelSpatial) | Quality Assessment class for Kernel Candidates | 
| KernelPcaD | |
| KernelPcaVisitorF | |
| KernelSolution | |
| MaskedKernelSolutionF | |
| ModelPsfMatchConfig | Configuration for model-to-model Psf matching | 
| ModelPsfMatchTask(*args, **kwargs) | Matching of two model Psfs, and application of the Psf-matching kernel to an input Exposure | 
| NaiveDipoleCentroid | |
| NaiveDipoleFlux | |
| NbasisEvaluator(psfMatchConfig, …) | A functor to evaluate the Bayesian Information Criterion for the number of basis sets going into the kernel fitting | 
| PsfDipoleFlux | |
| PsfDipoleFluxControl | |
| PsfMatchConfig | Base configuration for Psf-matching | 
| PsfMatchConfigAL | The parameters specific to the “Alard-Lupton” (sum-of-Gaussian) Psf-matching basis | 
| PsfMatchConfigDF | The parameters specific to the delta-function (one basis per-pixel) Psf-matching basis | 
| PsfMatchTask(*args, **kwargs) | Base class for Psf Matching; should not be called directly | 
| RegularizedKernelSolutionF | |
| SnapPsfMatchConfig | |
| SnapPsfMatchConfigAL | Sum-of-Gaussian (Alard-Lupton) Psf-matching config optimized for snap subtraction | 
| SnapPsfMatchConfigDF | Delta-function Psf-matching config optimized for snap subtraction | 
| SnapPsfMatchTask(*args, **kwargs) | Image-based Psf-matching of two subsequent snaps from the same visit | 
| SourceFlagChecker(sources[, badFlags]) | Functor class to check whether a diaSource has flags set that should cause it to be labeled bad. | 
| SpatialKernelSolution | |
| StaticKernelSolutionF | |
| ZogyConfig | Configuration parameters for the ZogyTask | 
| ZogyImagePsfMatchConfig | Config for the ZogyImagePsfMatchTask | 
| ZogyImagePsfMatchTask(*args, **kwargs) | Task to perform Zogy PSF matching and image subtraction. | 
| ZogyMapReduceConfig | Config to be passed to ImageMapReduceTask | 
| ZogyMapper(*args, **kwargs) | Task to be used as an ImageMapper for performing ZOGY image subtraction on a grid of subimages. | 
| ZogyTask([templateExposure, …]) | Task to perform ZOGY proper image subtraction. | 
Class Inheritance Diagram¶
lsst.ip.diffim.metrics Module¶
Classes¶
| NumberSciSourcesMetricTask(**kwargs) | Task that computes the number of cataloged science sources. | 
| NumberSciSourcesMetricConfig | |
| FractionDiaSourcesToSciSourcesMetricTask(…) | Task that computes the ratio of difference image sources to science sources in an image, visit, etc. | 
| FractionDiaSourcesToSciSourcesMetricConfig |