lsst.meas.base
16.0-12-g5ad1ebf+7
|
A command-line driver for performing forced measurement on coadd images. More...
Public Member Functions | |
def | getExposure (self, dataRef) |
def | makeIdFactory (self, dataRef) |
def | getExposureId (self, dataRef) |
def | fetchReferences (self, dataRef, exposure) |
def | attachFootprints (self, sources, refCat, exposure, refWcs, dataRef) |
def | runDataRef (self, dataRef, psfCache=None) |
Measure a single exposure for forced detection for a reference catalog using a dataRef. More... | |
def | run (self, measCat, exposure, refCat, refWcs, exposureId=None) |
Measure a single exposure with forced detection for a reference catalog. More... | |
def | writeOutput (self, dataRef, sources) |
Write forced source table. More... | |
def | getSchemaCatalogs (self) |
Get a dict of Schema catalogs that will be used by this Task. More... | |
Static Public Attributes | |
ConfigClass = ForcedPhotCoaddConfig | |
RunnerClass = lsst.pipe.base.ButlerInitializedTaskRunner | |
string | dataPrefix = "deepCoadd_" |
A command-line driver for performing forced measurement on coadd images.
This task is a subclass of ForcedPhotImageTask which is specifically for doing forced measurement on a coadd, using as a reference catalog detections which were made on overlapping coadds (i.e. in other bands).
The run method (inherited from ForcedPhotImageTask) takes a lsst.daf.persistence.ButlerDataRef argument that corresponds to a coadd image. This is used to provide all the inputs and outputs for the task:
In addition to the run method, ForcedPhotCcdTask overrides several methods of ForcedPhotImageTask to specialize it for coadd processing, including makeIdFactory() and fetchReferences(). None of these should be called directly by the user, though it may be useful to override them further in subclasses.
Definition at line 81 of file forcedPhotCoadd.py.
def lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.attachFootprints | ( | self, | |
sources, | |||
refCat, | |||
exposure, | |||
refWcs, | |||
dataRef | |||
) |
For coadd forced photometry, we use the deblended HeavyFootprints from the single-band measurements of the same band - because we've guaranteed that the peaks (and hence child sources) will be consistent across all bands before we get to measurement, this should yield reasonable deblending for most sources. It's most likely limitation is that it will not provide good flux upper limits for sources that were not detected in this band but were blended with sources that were.
Definition at line 151 of file forcedPhotCoadd.py.
def lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.fetchReferences | ( | self, | |
dataRef, | |||
exposure | |||
) |
Return an iterable of reference sources which overlap the exposure @param dataRef Data reference from butler corresponding to the image to be measured; should have tract, patch, and filter keys. @param exposure lsst.afw.image.Exposure to be measured (not used by this implementation) All work is delegated to the references subtask; see CoaddSrcReferencesTask for information about the default behavior.
Definition at line 133 of file forcedPhotCoadd.py.
def lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.getExposure | ( | self, | |
dataRef | |||
) |
Definition at line 111 of file forcedPhotCoadd.py.
def lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.getExposureId | ( | self, | |
dataRef | |||
) |
Definition at line 130 of file forcedPhotCoadd.py.
|
inherited |
Get a dict of Schema catalogs that will be used by this Task.
In the case of forced taks, there is only one schema for each type of forced measurement. The dataset type for this measurement is defined in the mapper.
Definition at line 230 of file forcedPhotImage.py.
def lsst.meas.base.forcedPhotCoadd.ForcedPhotCoaddTask.makeIdFactory | ( | self, | |
dataRef | |||
) |
Create an object that generates globally unique source IDs from per-CCD IDs and the CCD ID. @param dataRef Data reference from butler. The "CoaddId_bits" and "CoaddId" datasets are accessed. The data ID must have tract and patch keys.
Definition at line 115 of file forcedPhotCoadd.py.
|
inherited |
Measure a single exposure with forced detection for a reference catalog.
[in] | measCat | The measurement catalog generated by measurement.generateMeasCat(), based on the sources listed in the reference catalog. |
[in] | exposure | The measurement image upon which to perform forced detection. |
[in] | refCat | The reference catalog of sources to measure. |
[in] | refWcs | The WCS for the references. |
[in] | exposureId | Optional unique exposureId used for random seed in measurement task. |
Definition at line 155 of file forcedPhotImage.py.
|
inherited |
Measure a single exposure for forced detection for a reference catalog using a dataRef.
[in] | dataRef | An lsst.daf.persistence.ButlerDataRef. It is passed to the references subtask to obtain the reference WCS, the getExposure() method (implemented by derived classes) to read the measurement image, and the fetchReferences() method (implemented by derived classes) to get the exposure and load the reference catalog (see the CoaddSrcReferencesTask for more information). The sources are then passed to the writeOutputs() method (implemented by derived classes) which writes the outputs. See derived class documentation for which datasets and data ID keys are used. |
[in] | psfCache | Size of PSF cache, or None. The size of the PSF cache can have a significant effect upon the runtime for complicated PSF models. |
Definition at line 123 of file forcedPhotImage.py.
|
inherited |
Write forced source table.
dataRef | Data reference from butler; the forced_src dataset (with self.dataPrefix included) is all that will be modified. |
sources | SourceCatalog to save |
Definition at line 221 of file forcedPhotImage.py.
|
static |
Definition at line 106 of file forcedPhotCoadd.py.
|
static |
Definition at line 109 of file forcedPhotCoadd.py.
|
static |
Definition at line 107 of file forcedPhotCoadd.py.