|
def | __init__ (self, butler=None, initInputs=None, *args, **kwargs) |
|
def | applySkyCorr (self, calexp, skyCorr) |
|
def | extractStamps (self, inputExposure, refObjLoader=None) |
|
def | warpStamps (self, stamps, pixCenters) |
|
def | run (self, inputExposure, refObjLoader=None, dataId=None, skyCorr=None) |
|
def | runDataRef (self, dataRef) |
|
def | runQuantum (self, butlerQC, inputRefs, outputRefs) |
|
The description of the parameters for this Task are detailed in
:lsst-task:`~lsst.pipe.base.PipelineTask`.
Notes
-----
`ProcessBrightStarsTask` is used to extract, process, and store small
image cut-outs (or "postage stamps") around bright stars. It relies on
three methods, called in succession:
`extractStamps`
Find bright stars within the exposure using a reference catalog and
extract a stamp centered on each.
`warpStamps`
Shift and warp each stamp to remove optical distortions and sample all
stars on the same pixel grid.
`measureAndNormalize`
Compute the flux of an object in an annulus and normalize it. This is
required to normalize each bright star stamp as their central pixels
are likely saturated and/or contain ghosts, and cannot be used.
Definition at line 180 of file processBrightStars.py.
def lsst.pipe.tasks.processBrightStars.ProcessBrightStarsTask.run |
( |
|
self, |
|
|
|
inputExposure, |
|
|
|
refObjLoader = None , |
|
|
|
dataId = None , |
|
|
|
skyCorr = None |
|
) |
| |
Identify bright stars within an exposure using a reference catalog,
extract stamps around each, then preprocess them. The preprocessing
steps are: shifting, warping and potentially rotating them to the same
pixel grid; computing their annular flux and normalizing them.
Parameters
----------
inputExposure : `afwImage.exposure.exposure.ExposureF`
The image from which bright star stamps should be extracted.
refObjLoader : `LoadIndexedReferenceObjectsTask`, optional
Loader to find objects within a reference catalog.
dataId : `dict` or `lsst.daf.butler.DataCoordinate`
The dataId of the exposure (and detector) bright stars should be
extracted from.
skyCorr : `lsst.afw.math.backgroundList.BackgroundList` or ``None``,
optional
Full focal plane sky correction, obtained by running
`lsst.pipe.drivers.skyCorrection.SkyCorrectionTask`.
Returns
-------
result : `lsst.pipe.base.Struct`
Result struct with component:
- ``brightStarStamps``: ``bSS.BrightStarStamps``
Definition at line 434 of file processBrightStars.py.
def lsst.pipe.tasks.processBrightStars.ProcessBrightStarsTask.warpStamps |
( |
|
self, |
|
|
|
stamps, |
|
|
|
pixCenters |
|
) |
| |
Warps and shifts all given stamps so they are sampled on the same
pixel grid and centered on the central pixel. This includes rotating
the stamp depending on detector orientation.
Parameters
----------
stamps : `collections.abc.Sequence`
[`afwImage.exposure.exposure.ExposureF`]
Image cutouts centered on a single object.
pixCenters : `collections.abc.Sequence` [`geom.Point2D`]
Positions of each object's center (as obtained from the refCat),
in pixels.
Returns
-------
result : `lsst.pipe.base.Struct`
Result struct with components:
- ``warpedStars``:
`list` [`afwImage.maskedImage.maskedImage.MaskedImage`] of
stamps of warped stars
- ``warpTransforms``:
`list` [`afwGeom.TransformPoint2ToPoint2`] of
the corresponding Transform from the initial star stamp to
the common model grid
- ``xy0s``:
`list` [`geom.Point2I`] of coordinates of the bottom-left
pixels of each stamp, before rotation
- ``nb90Rots``: `int`, the number of 90 degrees rotations required
to compensate for detector orientation
Definition at line 340 of file processBrightStars.py.