lsst.meas.deblender  16.0-3-g150e024+5
Public Member Functions | Public Attributes | Static Public Attributes | List of all members
lsst.meas.deblender.deblend.MultibandDeblendTask Class Reference
Inheritance diagram for lsst.meas.deblender.deblend.MultibandDeblendTask:

Public Member Functions

def __init__ (self, schema, peakSchema=None, kwargs)
 
def run (self, exposures, sources)
 
def deblend (self, exposures, sources, psfs, bands=None)
 
def preSingleDeblendHook (self, exposures, sources, pk, fp, psfs, psf_fwhms, sigmas)
 
def postSingleDeblendHook (self, exposures, flux_catalogs, template_catalogs, pk, npre, fp, psfs, psf_fwhms, sigmas, result)
 
def isLargeFootprint (self, footprint)
 
def isMasked (self, footprint, mask)
 
def skipParent (self, source, masks)
 

Public Attributes

 peakSchemaMapper
 
 plugins
 
 runtimeKey
 
 nChildKey
 
 psfKey
 
 tooManyPeaksKey
 
 tooBigKey
 
 maskedKey
 
 deblendFailedKey
 
 deblendSkippedKey
 
 psfCenterKey
 
 psfFluxKey
 
 deblendRampedTemplateKey
 
 deblendPatchedTemplateKey
 
 hasStrayFluxKey
 

Static Public Attributes

 ConfigClass = MultibandDeblendConfig
 

Detailed Description

MultibandDeblendTask

Split blended sources into individual sources.

This task has no return value; it only modifies the SourceCatalog in-place.

Definition at line 638 of file deblend.py.

Constructor & Destructor Documentation

◆ __init__()

def lsst.meas.deblender.deblend.MultibandDeblendTask.__init__ (   self,
  schema,
  peakSchema = None,
  kwargs 
)
Create the task, adding necessary fields to the given schema.

Parameters
----------
schema: `lsst.afw.table.schema.schema.Schema`
    Schema object for measurement fields; will be modified in-place.
peakSchema: `lsst.afw.table.schema.schema.Schema`
    Schema of Footprint Peaks that will be passed to the deblender.
    Any fields beyond the PeakTable minimal schema will be transferred
    to the main source Schema.  If None, no fields will be transferred
    from the Peaks.
bands: list of str
    Names of the filters used for the eposures. This is needed to store the SED as a field
**kwargs
    Passed to Task.__init__.

Definition at line 648 of file deblend.py.

Member Function Documentation

◆ deblend()

def lsst.meas.deblender.deblend.MultibandDeblendTask.deblend (   self,
  exposures,
  sources,
  psfs,
  bands = None 
)
Deblend a data cube of multiband images

Parameters
----------
exposures: dict
    Keys of the dict are the names of the filters and values are
    `lsst.afw.image.exposure.exposure.ExposureF`'s.
    The exposures should be co-added images of the same
    shape and region of the sky.
sources: dict
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s, which
    should be a merged catalog of the sources in each band ('deepCoadd_mergeDet').
psfs: dict
bands: list, default=None
    Names of the bands in the deblender.
    If `bands` is `None`, the keys of `exposures` are used.
    Either `bands` should be specified or `exposures` should be an
    `OrderedDict` to set the preferential order of the filters.

Returns
-------
flux_catalogs: dict or None
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s.
    These are the flux-conserved catalogs with heavy footprints with
    the image data weighted by the multiband templates.
    If `self.config.conserveFlux` is `False`, then this item will be None
template_catalogs: dict or None
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s.
    These are catalogs with heavy footprints that are the templates
    created by the multiband templates.
    If `self.config.saveTemplates` is `False`, then this item will be None

Definition at line 872 of file deblend.py.

◆ isLargeFootprint()

def lsst.meas.deblender.deblend.MultibandDeblendTask.isLargeFootprint (   self,
  footprint 
)
Returns whether a Footprint is large

'Large' is defined by thresholds on the area, size and axis ratio.
These may be disabled independently by configuring them to be non-positive.

This is principally intended to get rid of satellite streaks, which the
deblender or other downstream processing can have trouble dealing with
(e.g., multiple large HeavyFootprints can chew up memory).

Definition at line 1137 of file deblend.py.

◆ isMasked()

def lsst.meas.deblender.deblend.MultibandDeblendTask.isMasked (   self,
  footprint,
  mask 
)
Returns whether the footprint violates the mask limits

Definition at line 1159 of file deblend.py.

◆ postSingleDeblendHook()

def lsst.meas.deblender.deblend.MultibandDeblendTask.postSingleDeblendHook (   self,
  exposures,
  flux_catalogs,
  template_catalogs,
  pk,
  npre,
  fp,
  psfs,
  psf_fwhms,
  sigmas,
  result 
)

Definition at line 1134 of file deblend.py.

◆ preSingleDeblendHook()

def lsst.meas.deblender.deblend.MultibandDeblendTask.preSingleDeblendHook (   self,
  exposures,
  sources,
  pk,
  fp,
  psfs,
  psf_fwhms,
  sigmas 
)

Definition at line 1130 of file deblend.py.

◆ run()

def lsst.meas.deblender.deblend.MultibandDeblendTask.run (   self,
  exposures,
  sources 
)
Get the psf from each exposure and then run deblend().

Parameters
----------
exposures: dict
    Keys of the dict are the names of the filters and values are
    `lsst.afw.image.exposure.exposure.ExposureF`'s.
    The exposures should be co-added images of the same
    shape and region of the sky.
sources: dict
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s, which
    should be a merged catalog of the sources in each band.

Returns
-------
flux_catalogs: dict or None
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s.
    These are the flux-conserved catalogs with heavy footprints with
    the image data weighted by the multiband templates.
    If `self.config.conserveFlux` is `False`, then this item will be None
template_catalogs: dict or None
    Keys are the names of the filters and the values are
    `lsst.afw.table.source.source.SourceCatalog`'s.
    These are catalogs with heavy footprints that are the templates
    created by the multiband templates.
    If `self.config.saveTemplates` is `False`, then this item will be None

Definition at line 815 of file deblend.py.

◆ skipParent()

def lsst.meas.deblender.deblend.MultibandDeblendTask.skipParent (   self,
  source,
  masks 
)
Indicate that the parent source is not being deblended

We set the appropriate flags and masks for each exposure.

Parameters
----------
source: `lsst.afw.table.source.source.SourceRecord`
    The source to flag as skipped
masks: list of `lsst.afw.image.mask.mask.MaskX`
    The mask in each band to update with the non-detection

Definition at line 1169 of file deblend.py.

Member Data Documentation

◆ ConfigClass

lsst.meas.deblender.deblend.MultibandDeblendTask.ConfigClass = MultibandDeblendConfig
static

Definition at line 645 of file deblend.py.

◆ deblendFailedKey

lsst.meas.deblender.deblend.MultibandDeblendTask.deblendFailedKey

Definition at line 784 of file deblend.py.

◆ deblendPatchedTemplateKey

lsst.meas.deblender.deblend.MultibandDeblendTask.deblendPatchedTemplateKey

Definition at line 801 of file deblend.py.

◆ deblendRampedTemplateKey

lsst.meas.deblender.deblend.MultibandDeblendTask.deblendRampedTemplateKey

Definition at line 796 of file deblend.py.

◆ deblendSkippedKey

lsst.meas.deblender.deblend.MultibandDeblendTask.deblendSkippedKey

Definition at line 787 of file deblend.py.

◆ hasStrayFluxKey

lsst.meas.deblender.deblend.MultibandDeblendTask.hasStrayFluxKey

Definition at line 806 of file deblend.py.

◆ maskedKey

lsst.meas.deblender.deblend.MultibandDeblendTask.maskedKey

Definition at line 782 of file deblend.py.

◆ nChildKey

lsst.meas.deblender.deblend.MultibandDeblendTask.nChildKey

Definition at line 773 of file deblend.py.

◆ peakSchemaMapper

lsst.meas.deblender.deblend.MultibandDeblendTask.peakSchemaMapper

Definition at line 676 of file deblend.py.

◆ plugins

lsst.meas.deblender.deblend.MultibandDeblendTask.plugins

Definition at line 745 of file deblend.py.

◆ psfCenterKey

lsst.meas.deblender.deblend.MultibandDeblendTask.psfCenterKey

Definition at line 792 of file deblend.py.

◆ psfFluxKey

lsst.meas.deblender.deblend.MultibandDeblendTask.psfFluxKey

Definition at line 794 of file deblend.py.

◆ psfKey

lsst.meas.deblender.deblend.MultibandDeblendTask.psfKey

Definition at line 775 of file deblend.py.

◆ runtimeKey

lsst.meas.deblender.deblend.MultibandDeblendTask.runtimeKey

Definition at line 771 of file deblend.py.

◆ tooBigKey

lsst.meas.deblender.deblend.MultibandDeblendTask.tooBigKey

Definition at line 780 of file deblend.py.

◆ tooManyPeaksKey

lsst.meas.deblender.deblend.MultibandDeblendTask.tooManyPeaksKey

Definition at line 777 of file deblend.py.


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