PossiblyMultipleInput

class lsst.drp.tasks.update_visit_summary.PossiblyMultipleInput

Bases: abc.ABC

A helper ABC for handling input ExposureCatalog datasets that may be multiple (one per tract/visit combination) or unique/global (one per visit).

Methods Summary

best_for_detector(detector_id, center, …)

Return the exposure record for this detector that is the best match for this detector.

Methods Documentation

best_for_detector(detector_id: int, center: Optional[lsst.geom.SpherePoint, None] = None, bbox: Optional[lsst.geom.Box2I, None] = None) → tuple

Return the exposure record for this detector that is the best match for this detector.

Parameters:

detector_id : int

Detector ID; used to find the right row in the catalog or catalogs.

center : lsst.geom.SpherePoint or None

Center of the detector in sky coordinates. If not provided, one will be computed via compute_center_for_detector_record.

bbox : lsst.geom.Box2I, optional

Bounding box for the detector in its own pixel coordinates.

Returns:

tract_id : int

ID of the tract that supplied this record, or -1 if record is None or if the input was not per-tract.

record : lsst.afw.table.ExposureRecord or None

Best record for this detector, or None if there either were no records for this detector or no WCS available to compute a center.