Compute the PSF, aperture corrections, astrometric and photometric
calibrations, and summary statistics for a single science exposure, and
produce a catalog of brighter stars that were used to calibrate it.
Parameters
----------
initial_stars_schema : `lsst.afw.table.Schema`
Schema of the initial_stars output catalog.
Definition at line 325 of file calibrateImage.py.
lsst.pipe.tasks.calibrateImage.CalibrateImageTask._compute_psf |
( |
|
self, |
|
|
|
exposure, |
|
|
|
guess_psf = True |
|
) |
| |
|
protected |
Find bright sources detected on an exposure and fit a PSF model to
them, repairing likely cosmic rays before detection.
Repair, detect, measure, and compute PSF twice, to ensure the PSF
model does not include contributions from cosmic rays.
Parameters
----------
exposure : `lsst.afw.image.Exposure`
Exposure to detect and measure bright stars on.
Returns
-------
sources : `lsst.afw.table.SourceCatalog`
Catalog of detected bright sources.
background : `lsst.afw.math.BackgroundList`
Background that was fit to the exposure during detection.
cell_set : `lsst.afw.math.SpatialCellSet`
PSF candidates returned by the psf determiner.
Definition at line 456 of file calibrateImage.py.
lsst.pipe.tasks.calibrateImage.CalibrateImageTask._find_stars |
( |
|
self, |
|
|
|
exposure, |
|
|
|
background |
|
) |
| |
|
protected |
Detect stars on an exposure that has a PSF model, and measure their
PSF, circular aperture, compensated gaussian fluxes.
Parameters
----------
exposure : `lsst.afw.image.Exposure`
Exposure to set the ApCorrMap on.
background : `lsst.afw.math.BackgroundList`
Background that was fit to the exposure during detection;
modified in-place during subsequent detection.
Returns
-------
stars : `SourceCatalog`
Sources that are very likely to be stars, with a limited set of
measurements performed on them.
Definition at line 547 of file calibrateImage.py.
lsst.pipe.tasks.calibrateImage.CalibrateImageTask._fit_photometry |
( |
|
self, |
|
|
|
exposure, |
|
|
|
stars |
|
) |
| |
|
protected |
Fit a photometric model to the data and return the reference
matches used in the fit, and the fitted PhotoCalib.
Parameters
----------
exposure : `lsst.afw.image.Exposure`
Exposure that is being fit, to get PSF and other metadata from.
Modified to be in nanojanksy units, with an assigned photoCalib
identically 1.
stars : `lsst.afw.table.SourceCatalog`
Good stars selected for use in calibration.
Returns
-------
calibrated_stars : `lsst.afw.table.SourceCatalog`
Star catalog with flux/magnitude columns computed from the fitted
photoCalib.
matches : `list` [`lsst.afw.table.ReferenceMatch`]
Reference/stars matches used in the fit.
photoCalib : `lsst.afw.image.PhotoCalib`
Photometric calibration that was fit to the star catalog.
Definition at line 615 of file calibrateImage.py.
lsst.pipe.tasks.calibrateImage.CalibrateImageTask.run |
( |
|
self, |
|
|
* |
exposure |
|
) |
| |
Find stars and perform psf measurement, then do a deeper detection
and measurement and calibrate astrometry and photometry from that.
Parameters
----------
exposure : `lsst.afw.image.Exposure`
Post-ISR exposure, with an initial WCS, VisitInfo, and Filter.
Modified in-place during processing.
Returns
-------
result : `lsst.pipe.base.Struct`
Results as a struct with attributes:
``output_exposure``
Calibrated exposure, with pixels in nJy units.
(`lsst.afw.image.Exposure`)
``stars``
Stars that were used to calibrate the exposure, with
calibrated fluxes and magnitudes.
(`lsst.afw.table.SourceCatalog`)
``psf_stars``
Stars that were used to determine the image PSF.
(`lsst.afw.table.SourceCatalog`)
``background``
Background that was fit to the exposure when detecting
``stars``. (`lsst.afw.math.BackgroundList`)
``applied_photo_calib``
Photometric calibration that was fit to the star catalog and
applied to the exposure. (`lsst.afw.image.PhotoCalib`)
``astrometry_matches``
Reference catalog stars matches used in the astrometric fit.
(`list` [`lsst.afw.table.ReferenceMatch`] or `lsst.afw.table.BaseCatalog`)
``photometry_matches``
Reference catalog stars matches used in the photometric fit.
(`list` [`lsst.afw.table.ReferenceMatch`] or `lsst.afw.table.BaseCatalog`)
Definition at line 395 of file calibrateImage.py.