UpdateVisitSummaryTask¶
UpdateVisitSummaryTask combines updated versions of the various Exposure component objects used to characterize and calibrate a single-epoch image into a single per-visit exposure catalog (finalVisitSummary).
It also recomputes summary statistics to reflect these updates.
Processing summary¶
UpdateVisitSummaryTask reads in the initial summary dataset of essentially the same form (visitSummary), then replaces the object fields of each record with objects loaded from other (often optional) input datasets that contain newer (often final) versions of those objects.
When an object field is replaced, any related summary statistics in the catalog’s non-object columns are also recomputed.
See connection and run argument documentation for details.
Python API summary¶
from lsst.drp.tasks.update_visit_summary import UpdateVisitSummaryTask
-
class
UpdateVisitSummaryTask(*, initInputs=None, **kwargs) A pipeline task that creates a new visit-summary table after all `lsst.afw.image.Exposure` components have been finalized
...
- attributeconfig
Access configuration fields and retargetable subtasks.
-
method
run(*, result, input_summary_catalog, input_exposures, psf_overrides, psf_star_catalog, ap_corr_overrides, camera=None, photo_calib_overrides=None, wcs_overrides=None, background_originals=None, background_overrides=None) Build an updated version of a visit summary catalog
...
See also
See the UpdateVisitSummaryTask API reference for complete details.
Butler datasets¶
When run through the runQuantum method, UpdateVisitSummaryTask obtains datasets from the input Butler data repository and persists outputs to the output Butler data repository.
In this mode, the PSF and aperture correction map are always replaced (since at present all relevant pipelines do recompute these), even though they are optional when calling lsst.drp.tasks.update_visit_summary.UpdateVisitSummaryTask.run directly.
The main output dataset, finalVisitSummary (by default), can typically be
used to provide all downstream tasks with the best versions of all calibrations
for each detector.
Retargetable subtasks¶
compute_summary_stats¶
Subtask that computes summary statistics from Exposure components.
refit_pointing¶
- Default
lsst.meas.astrom.refit_pointing.RefitPointingTask- Field type
A subtask for refitting the boresight pointing and orientation, and fitting WCS SIP approximations.
Configuration fields¶
background_provider¶
- Default
'input_summary'- Field type
- Choices
'input_summary'The input visit summary catalog already includes summary statistics for the final backgrounds that can be used as-is.
'replacement'{“The ‘background_originals’ connection refers to a background model that has been superseded by the model referred to by the ‘background_overrides’ connection.”}
Which connection(s) and behavior to use when applying background overrides.
camera_dimensions¶
The dimensions of the ‘camera’ prerequisite input connection.
connections¶
- Data type
lsst.pipe.base.config.UpdateVisitSummaryConfigConnections- Field type
Configurations describing the connections of the PipelineTask to datatypes
do_refit_pointing¶
Whether to re-fit the pointing model and add TAN-SIP WCS approximations.
do_write_visit_geometry¶
Whether to write refit-pointing regions that can be used to update butler dimension records.
photo_calib_provider¶
- Default
'input_summary'- Field type
- Choices
'input_summary'Propagate the PhotoCalib from the input visit summary catalog and do not recompute photometric calibration summary statistics.
'tract'{“Use the ‘photo_calib_overrides_tract’ connection to load an `ExposureCatalog` with {visit, tract} dimensions and per-detector rows, and recommpute photometric calibration summary statistics.”}
'global'{“Use the ‘photo_calib_overrides_global’ connection to load an `ExposureCatalog` with {visit} dimensions and per-detector rows, and recommpute photometric calibration summary statistics.”}
Which connection and behavior to use when applying photometric calibration overrides.
saveLogOutput¶
Flag to enable/disable saving of log output for a task, enabled by default.
wcs_consistency_threshold¶
Maximum distance (in arcseconds) between the on-sky corners of a wcs_provider WCS and the input_summary WCS. When this threshold is exceeded, the WCS is set to None. When this is not None and there is no input summary WCS, the WCS is also nulled.
wcs_provider¶
Which connection and behavior to use when applying WCS overrides.The string should be one of the following:
- input_summary: Propagate the WCS from the input visit summary catalog and do not recompute WCS-based summary statistics.
- tract: Use the ‘wcs_overrides_tract’ connection to load an ExposureCatalog with {visit, tract} dimensions and per-detector rows, and recommpute WCS-based summary statistics.
- global: Use the ‘wcs_overrides_global’ connection to load an ExposureCatalog with {visit} dimensions and per-detector rows, and recommpute WCS-based summary statistics.
- healpixN: Use the ‘wcs_overrides_skypix’ connection to load an ExposureCatalog with {visit, healpixN} dimensions and per-detector rows, and recommpute WCS-based summary statistics.