SsSingleFrameAssociationTask#

class lsst.ap.association.SsSingleFrameAssociationTask(initInputs=None, **kwargs)#

Bases: PipelineTask

Task for loading, associating and storing Difference Image Analysis (DIA) Objects and Sources.

Methods Summary

run(exposure, sourceTable, band[, ...])

Process DiaSources and DiaObjects.

runQuantum(butlerQC, inputRefs, outputRefs)

Do butler IO and transform to provide in memory objects for tasks run method.

Methods Documentation

run(exposure, sourceTable, band, solarSystemObjectTable=None)#

Process DiaSources and DiaObjects.

Load previous DiaObjects and their DiaSource history. Calibrate the values in the diaSourceCat. Associate new DiaSources with previous DiaObjects. Run forced photometry at the updated DiaObject locations. Store the results in the Alert Production Database (Apdb).

Parameters#

exposurelsst.afw.image.ExposureF

Calibrated exposure with wcs and midpoint time.

sourceTablelsst.afw.table.SourceCatalog

Newly detected sources.

bandstr

The band in which the new DiaSources were detected.

solarSystemObjectTableastropy.table.Table or None

Preloaded Solar System objects expected to be visible in the image.

Returns#

resultslsst.pipe.base.Struct

Results struct with components. - ssoAssocDiaSources : DiaSources that were associated with

solar system objects in this visit. (Astropy.table.Table)

  • unAssocDiaSources : Set of DiaSources that were not associated with any solar system object. (astropy.table.Table)

  • nTotalSsObjects : Total number of SolarSystemObjects contained in the CCD footprint. (int)

  • nAssociatedSsObjects : Number of SolarSystemObjects that were associated with DiaSources.

  • ssSourceData : ssSource table data. (Astropy.table.Table)

Raises#

RuntimeError

Raised if duplicate DiaObjects or duplicate DiaSources are found.

runQuantum(butlerQC, inputRefs, outputRefs)#

Do butler IO and transform to provide in memory objects for tasks run method.

Parameters#

butlerQCQuantumContext

A butler which is specialized to operate in the context of a lsst.daf.butler.Quantum.

inputRefsInputQuantizedConnection

Datastructure whose attribute names are the names that identify connections defined in corresponding PipelineTaskConnections class. The values of these attributes are the lsst.daf.butler.DatasetRef objects associated with the defined input/prerequisite connections.

outputRefsOutputQuantizedConnection

Datastructure whose attribute names are the names that identify connections defined in corresponding PipelineTaskConnections class. The values of these attributes are the lsst.daf.butler.DatasetRef objects associated with the defined output connections.