|
| __init__ (self, initInputs=None, *args, **kwargs) |
|
| runQuantum (self, butlerQC, inputRefs, outputRefs) |
|
| run (self, inputExposure, refObjLoader=None, dataId=None, skyCorr=None) |
|
| applySkyCorr (self, calexp, skyCorr) |
|
| extractStamps (self, inputExposure, filterName="phot_g_mean", refObjLoader=None, inputBrightStarStamps=None) |
|
| warpStamps (self, stamps, pixCenters) |
|
| setModelStamp (self) |
|
Extract bright star cutouts; normalize and warp to the same pixel grid.
This task 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 165 of file processBrightStars.py.
lsst.pipe.tasks.processBrightStars.ProcessBrightStarsTask._getCutout |
( |
| self, |
|
|
| inputExposure, |
|
|
Point2D | coordPix, |
|
|
list[int] | stampSize ) |
|
protected |
Get a cutout from an input exposure, handling edge cases.
Generate a cutout from an input exposure centered on a given position
and with a given size.
If any part of the cutout is outside the input exposure bounding box,
the cutout is padded with NaNs.
Parameters
----------
inputExposure : `~lsst.afw.image.ExposureF`
The image to extract bright star stamps from.
coordPix : `~lsst.geom.Point2D`
Center of the cutout in pixel space.
stampSize : `list` [`int`]
Size of the cutout, in pixels.
Returns
-------
stamp : `~lsst.afw.image.ExposureF` or `None`
The cutout, or `None` if the cutout is entirely outside the input
exposure bounding box.
Notes
-----
This method is a short-term workaround until DM-40042 is implemented.
At that point, it should be replaced by a call to the Exposure method
``getCutout``, which will handle edge cases automatically.
Definition at line 415 of file processBrightStars.py.
lsst.pipe.tasks.processBrightStars.ProcessBrightStarsTask.extractStamps |
( |
| self, |
|
|
| inputExposure, |
|
|
| filterName = "phot_g_mean", |
|
|
| refObjLoader = None, |
|
|
| inputBrightStarStamps = None ) |
Identify the positions of bright stars within an input exposure using
a reference catalog and extract them.
Parameters
----------
inputExposure : `~lsst.afw.image.ExposureF`
The image to extract bright star stamps from.
filterName : `str`, optional
Name of the camera filter to use for reference catalog filtering.
refObjLoader : `~lsst.meas.algorithms.ReferenceObjectLoader`, optional
Loader to find objects within a reference catalog.
inputBrightStarStamps:
`~lsst.meas.algorithms.brightStarStamps.BrightStarStamps`, optional
Provides information about the stars that have already been
extracted from the inputExposure in other steps of the pipeline.
For example, this is used in the `SubtractBrightStarsTask` to avoid
extracting stars that already have been extracted when running
`ProcessBrightStarsTask` to produce brightStarStamps.
Returns
-------
result : `~lsst.pipe.base.Struct`
Results as a struct with attributes:
``starStamps``
Postage stamps (`list`).
``pixCenters``
Corresponding coords to each star's center, in pixels (`list`).
``gMags``
Corresponding (Gaia) G magnitudes (`list`).
``gaiaIds``
Corresponding unique Gaia identifiers (`np.ndarray`).
Definition at line 321 of file processBrightStars.py.
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.
Bright star preprocessing steps are: shifting, warping and potentially
rotating them to the same pixel grid; computing their annular flux,
and; normalizing them.
Parameters
----------
inputExposure : `~lsst.afw.image.ExposureF`
The image from which bright star stamps should be extracted.
refObjLoader : `~lsst.meas.algorithms.ReferenceObjectLoader`, optional
Loader to find objects within a reference catalog.
dataId : `dict` or `~lsst.daf.butler.DataCoordinate`
The dataId of the exposure (including detector) that bright stars
should be extracted from.
skyCorr : `~lsst.afw.math.backgroundList.BackgroundList`, optional
Full focal plane sky correction obtained by `SkyCorrectionTask`.
Returns
-------
brightStarResults : `~lsst.pipe.base.Struct`
Results as a struct with attributes:
``brightStarStamps``
(`~lsst.meas.algorithms.brightStarStamps.BrightStarStamps`)
Definition at line 206 of file processBrightStars.py.