ScarletDeblendTask#

class lsst.meas.extensions.scarlet.ScarletDeblendTask(schema: Schema, peakSchema: Schema = None, **kwargs)#

Bases: Task

Split blended sources into individual sources.

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

Methods Summary

deblend(mExposure, mDeconvolved, ...)

Deblend a data cube of multiband images

run(mExposure, mDeconvolved, mergedSources)

Get the psf from each exposure and then run deblend().

Methods Documentation

deblend(mExposure: MultibandExposure, mDeconvolved: MultibandExposure, objectCatalog: SourceCatalog, parentCatalog: SourceCatalog) → Struct#

Deblend a data cube of multiband images

Deblending iterates over sources from the input catalog, which are blends of peaks with overlapping PSFs (depth 0 parents). In many cases those footprints can be subdived into multiple deconvolved footprints, which have an intermediate parent record added to the catalog and are be deblended separately. All deblended peaks have a source record added to the catalog, each of which has a depth one greater than the parent.

Parameters#

mExposure :

The exposures should be co-added images of the same shape and region of the sky.

mDeconvolved :

The deconvolved images of the same shape and region of the sky.

objectCatalog :

An empty SourceCatalog with the schema to hold isolated sources and deblended children. This catalog is filled in place.

parentCatalog :

The merged SourceCatalog that contains parent footprints to (potentially) deblend. If a parent is subdivided into multiple deconvolved parents, the deconvolved parents are added to this catalog in place.

Returns#

resultlsst.pipe.base.Struct

A struct with the following attributes (all lsst.afw.table.SourceCatalog instances):

  • deblendedCatalog: isolated and deblended child sources.

  • scarletModelData: persistable deblended model data for the deblender.

  • objectParents: the parent catalog with deconvolved parents added.

run(mExposure: MultibandExposure, mDeconvolved: MultibandExposure, mergedSources: SourceCatalog) → Struct#

Get the psf from each exposure and then run deblend().

Parameters#

mExposure :

The exposures should be co-added images of the same shape and region of the sky.

mDeconvolved :

The deconvolved images of the same shape and region of the sky.

mergedSources :

The merged SourceCatalog that contains parent footprints to (potentially) deblend.

Returns#

resultlsst.pipe.base.Struct

See deblend; its output is returned unmodified.