lsst.pipe.tasks.calibrateImage.CalibrateImageConfig Class Reference
Inheritance diagram for lsst.pipe.tasks.calibrateImage.CalibrateImageConfig:
Public Member Functions | |
| setDefaults (self) | |
| validate (self) | |
Detailed Description
Definition at line 256 of file calibrateImage.py.
Member Function Documentation
◆ setDefaults()
| lsst.pipe.tasks.calibrateImage.CalibrateImageConfig.setDefaults | ( | self | ) |
Definition at line 461 of file calibrateImage.py.
◆ validate()
| lsst.pipe.tasks.calibrateImage.CalibrateImageConfig.validate | ( | self | ) |
Definition at line 567 of file calibrateImage.py.
Member Data Documentation
◆ applied_photo_calib
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc=(
"Photometric calibration that was applied to exposure's pixels. "
"This connection is disabled when do_calibrate_pixels=False."
),
name="initial_photoCalib_detector",
storageClass="PhotoCalib",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 176 of file calibrateImage.py.
◆ astrometry
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.astrom.AstrometryTask,
doc="Task to perform astrometric calibration to fit a WCS.",
)
Definition at line 377 of file calibrateImage.py.
◆ astrometry_matches
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Source to reference catalog matches from the astrometry solver.",
name="initial_astrometry_match_detector",
storageClass="Catalog",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 221 of file calibrateImage.py.
◆ astrometry_ref_cat
|
staticinherited |
Initial value:
= connectionTypes.PrerequisiteInput(
doc="Reference catalog to use for astrometric calibration.",
name="gaia_dr3_20230707",
storageClass="SimpleCatalog",
dimensions=("skypix",),
deferLoad=True,
multiple=True,
)
Definition at line 99 of file calibrateImage.py.
◆ astrometry_ref_loader
|
static |
Initial value:
= pexConfig.ConfigField(
dtype=lsst.meas.algorithms.LoadReferenceObjectsConfig,
doc="Configuration of reference object loader for astrometric fit.",
)
Definition at line 381 of file calibrateImage.py.
◆ background
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Background models estimated during calibration task; calibrated to be in nJy units.",
name="initial_pvi_background",
storageClass="Background",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 185 of file calibrateImage.py.
◆ background_flat
|
staticinherited |
Initial value:
= connectionTypes.PrerequisiteInput(
name="flat",
doc="Flat calibration frame used for background correction.",
storageClass="ExposureF",
dimensions=["instrument", "detector", "physical_filter"],
isCalibration=True,
)
Definition at line 131 of file calibrateImage.py.
◆ background_to_photometric_ratio
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Ratio of a background-flattened image to a photometric-flattened image. Only persisted "
"if do_illumination_correction is True.",
name="background_to_photometric_ratio",
storageClass="Image",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 191 of file calibrateImage.py.
◆ camera_model
|
staticinherited |
Initial value:
= connectionTypes.PrerequisiteInput(
doc="Camera distortion model to use for astrometric calibration.",
name="astrometry_camera",
storageClass="Camera",
dimensions=("instrument", "physical_filter"),
isCalibration=True,
minimum=0, # Can fall back on WCS already attached to exposure.
)
Definition at line 115 of file calibrateImage.py.
◆ compute_summary_stats
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=computeExposureSummaryStats.ComputeExposureSummaryStatsTask,
doc="Task to to compute summary statistics on the calibrated exposure."
)
Definition at line 405 of file calibrateImage.py.
◆ diffractionSpikeMask
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=diffractionSpikeMask.DiffractionSpikeMaskTask,
doc="Task to identify and mask the diffraction spikes of bright stars.",
)
Definition at line 400 of file calibrateImage.py.
◆ do_adaptive_threshold_detection
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=True,
doc="Implement the adaptive detection thresholding approach?",
)
Definition at line 292 of file calibrateImage.py.
◆ do_calibrate_pixels
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=True,
doc=(
"If True, apply the photometric calibration to the image pixels "
"and background model, and attach an identity PhotoCalib to "
"the output image to reflect this. If False`, leave the image "
"and background uncalibrated and attach the PhotoCalib that maps "
"them to physical units."
)
)
Definition at line 418 of file calibrateImage.py.
◆ do_downsample_footprints
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="Downsample footprints prior to deblending to optimize speed?",
)
Definition at line 335 of file calibrateImage.py.
◆ do_illumination_correction
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="If True, apply the illumination correction. This assumes that the "
"input image has already been flat-fielded such that it is suitable "
"for background subtraction.",
)
Definition at line 410 of file calibrateImage.py.
◆ do_include_astrometric_errors
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=True,
doc="If True, include astrometric errors in the output catalog.",
)
Definition at line 430 of file calibrateImage.py.
◆ doMaskDiffractionSpikes
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="If True, load the photometric reference catalog again but select "
"only bright stars. Use the bright star catalog to set the SPIKE "
"mask for regions likely contaminated by diffraction spikes.",
)
Definition at line 393 of file calibrateImage.py.
◆ downsample_max_footprints
|
static |
Initial value:
= pexConfig.Field(
dtype=int,
default=1000,
doc="Maximum number of non-sky-source footprints to use if do_downsample_footprints is True,",
)
Definition at line 340 of file calibrateImage.py.
◆ exposure
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Photometrically calibrated, background-subtracted exposure with fitted calibrations and "
"summary statistics. To recover the original exposure, first add the background "
"(`initial_pvi_background`), and then uncalibrate (divide by `initial_photoCalib_detector`).",
name="initial_pvi",
storageClass="ExposureF",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 155 of file calibrateImage.py.
◆ exposures
|
staticinherited |
Initial value:
= connectionTypes.Input(
doc="Exposure (or two snaps) to be calibrated, and detected and measured on.",
name="postISRCCD",
storageClass="Exposure",
multiple=True, # to handle 1 exposure or 2 snaps
dimensions=["instrument", "exposure", "detector"],
)
Definition at line 123 of file calibrateImage.py.
◆ id_generator
|
static |
Definition at line 267 of file calibrateImage.py.
◆ illumination_correction
|
staticinherited |
Initial value:
= connectionTypes.PrerequisiteInput(
name="illuminationCorrection",
doc="Illumination correction frame.",
storageClass="Exposure",
dimensions=["instrument", "detector", "physical_filter"],
isCalibration=True,
)
Definition at line 138 of file calibrateImage.py.
◆ initial_stars_schema
|
staticinherited |
Initial value:
= connectionTypes.InitOutput(
doc="Schema of the output initial stars catalog.",
name="initial_stars_schema",
storageClass="SourceCatalog",
)
Definition at line 147 of file calibrateImage.py.
◆ install_simple_psf
|
static |
Initial value:
= pexConfig.ConfigurableField(
doc="Task to install a simple PSF model into the input exposure to use "
"when detecting bright sources for PSF estimation.",
)
Definition at line 275 of file calibrateImage.py.
◆ mask
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="The mask plane of the calibrated exposure, written as a separate "
"output so that it can be passed to downstream tasks even if the "
"exposure is removed to save storage.",
name="preliminary_visit_mask",
storageClass="Mask",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 200 of file calibrateImage.py.
◆ measure_aperture_correction
|
static |
Initial value:
= pexConfig.ConfigurableField(
doc="Task to compute the aperture correction from the bright stars."
)
Definition at line 317 of file calibrateImage.py.
◆ optional_outputs
|
static |
Initial value:
= pexConfig.ListField(
doc="Which optional outputs to save (as their connection name)?",
dtype=str,
# TODO: note somewhere to disable this for benchmarking, but should
# we always have it on for production runs?
default=["psf_stars", "psf_stars_footprints", "astrometry_matches", "photometry_matches", "mask"],
optional=False
)
Definition at line 257 of file calibrateImage.py.
◆ photometry
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=photoCal.PhotoCalTask,
doc="Task to perform photometric calibration to fit a PhotoCalib.",
)
Definition at line 385 of file calibrateImage.py.
◆ photometry_matches
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Source to reference catalog matches from the photometry solver.",
name="initial_photometry_match_detector",
storageClass="Catalog",
dimensions=("instrument", "visit", "detector"),
)
Definition at line 227 of file calibrateImage.py.
◆ photometry_ref_cat
|
staticinherited |
Initial value:
= connectionTypes.PrerequisiteInput(
doc="Reference catalog to use for photometric calibration.",
name="ps1_pv3_3pi_20170110",
storageClass="SimpleCatalog",
dimensions=("skypix",),
deferLoad=True,
multiple=True
)
Definition at line 107 of file calibrateImage.py.
◆ photometry_ref_loader
|
static |
Initial value:
= pexConfig.ConfigField(
dtype=lsst.meas.algorithms.LoadReferenceObjectsConfig,
doc="Configuration of reference object loader for photometric fit.",
)
Definition at line 389 of file calibrateImage.py.
◆ psf_adaptive_threshold_detection
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=AdaptiveThresholdDetectionTask,
doc="Task to adaptively detect sources for PSF determination.",
)
Definition at line 297 of file calibrateImage.py.
◆ psf_detection
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.SourceDetectionTask,
doc="Task to detect sources for PSF determination."
)
Definition at line 288 of file calibrateImage.py.
◆ psf_measure_psf
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=measurePsf.MeasurePsfTask,
doc="Task to measure the psf on bright sources."
)
Definition at line 305 of file calibrateImage.py.
◆ psf_normalized_calibration_flux
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.NormalizedCalibrationFluxTask,
doc="Task to normalize the calibration flux (e.g. compensated tophats) "
"for the bright stars used for psf estimation.",
)
Definition at line 309 of file calibrateImage.py.
◆ psf_repair
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=repair.RepairTask,
doc="Task to repair cosmic rays on the exposure before PSF determination.",
)
Definition at line 280 of file calibrateImage.py.
◆ psf_source_measurement
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.base.SingleFrameMeasurementTask,
doc="Task to measure sources to be used for psf estimation."
)
Definition at line 301 of file calibrateImage.py.
◆ psf_stars
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Catalog of bright unresolved sources detected on the exposure used for PSF determination.",
name="initial_psf_stars_detector",
storageClass="ArrowAstropy",
dimensions=["instrument", "visit", "detector"],
)
Definition at line 215 of file calibrateImage.py.
◆ psf_stars_footprints
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Catalog of bright unresolved sources detected on the exposure used for PSF determination; "
"includes source footprints.",
name="initial_psf_stars_footprints_detector",
storageClass="SourceCatalog",
dimensions=["instrument", "visit", "detector"],
)
Definition at line 208 of file calibrateImage.py.
◆ psf_subtract_background
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.SubtractBackgroundTask,
doc="Task to perform intial background subtraction, before first detection pass.",
)
Definition at line 284 of file calibrateImage.py.
◆ run_sattle
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="If True, the sattle service will populate a cache for later use "
"in ip_diffim.detectAndMeasure alert verification."
)
Definition at line 436 of file calibrateImage.py.
◆ sattle_historical
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="If re-running a pipeline that requires sattle, this should be set "
"to True. This will populate sattle's cache with the historic data "
"closest in time to the exposure.",
)
Definition at line 443 of file calibrateImage.py.
◆ snap_combine
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=snapCombine.SnapCombineTask,
doc="Task to combine two snaps to make one exposure.",
)
Definition at line 269 of file calibrateImage.py.
◆ star_apply_aperture_correction
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.base.ApplyApCorrTask,
doc="Task to apply aperture corrections to the selected stars."
)
Definition at line 358 of file calibrateImage.py.
◆ star_background
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.SubtractBackgroundTask,
doc="Task to perform final background subtraction, just before photoCal.",
)
Definition at line 323 of file calibrateImage.py.
◆ star_catalog_calculation
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.base.CatalogCalculationTask,
doc="Task to compute extendedness values on the star catalog, "
"for the star selector to remove extended sources."
)
Definition at line 362 of file calibrateImage.py.
◆ star_deblend
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.deblender.SourceDeblendTask,
doc="Split blended sources into their components."
)
Definition at line 345 of file calibrateImage.py.
◆ star_detection
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.SourceDetectionTask,
doc="Task to detect stars to return in the output catalog."
)
Definition at line 327 of file calibrateImage.py.
◆ star_measurement
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.base.SingleFrameMeasurementTask,
doc="Task to measure stars to return in the output catalog."
)
Definition at line 349 of file calibrateImage.py.
◆ star_normalized_calibration_flux
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.NormalizedCalibrationFluxTask,
doc="Task to apply the normalization for calibration fluxes (e.g. compensated tophats) "
"for the final output star catalog.",
)
Definition at line 353 of file calibrateImage.py.
◆ star_selector
|
static |
Initial value:
= lsst.meas.algorithms.sourceSelectorRegistry.makeField(
default="science",
doc="Task to select reliable stars to use for calibration."
)
Definition at line 371 of file calibrateImage.py.
◆ star_set_primary_flags
|
static |
Initial value:
= pexConfig.ConfigurableField(
doc="Task to add isPrimary to the catalog."
)
Definition at line 367 of file calibrateImage.py.
◆ star_sky_sources
|
static |
Initial value:
= pexConfig.ConfigurableField(
target=lsst.meas.algorithms.SkyObjectsTask,
doc="Task to generate sky sources ('empty' regions where there are no detections).",
)
Definition at line 331 of file calibrateImage.py.
◆ stars
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Catalog of unresolved sources detected on the calibrated exposure.",
name="initial_stars_detector",
storageClass="ArrowAstropy",
dimensions=["instrument", "visit", "detector"],
)
Definition at line 163 of file calibrateImage.py.
◆ stars_footprints
|
staticinherited |
Initial value:
= connectionTypes.Output(
doc="Catalog of unresolved sources detected on the calibrated exposure; "
"includes source footprints.",
name="initial_stars_footprints_detector",
storageClass="SourceCatalog",
dimensions=["instrument", "visit", "detector"],
)
Definition at line 169 of file calibrateImage.py.
◆ useButlerCamera
|
static |
Initial value:
= pexConfig.Field(
dtype=bool,
default=False,
doc="If True, use a camera distortion model generated elsewhere in "
"the pipeline combined with the telescope boresight as a starting "
"point for fitting the WCS, instead of using the WCS attached to "
"the exposure, which is generated from the boresight and the "
"camera model from the obs_* package."
)
Definition at line 451 of file calibrateImage.py.
The documentation for this class was generated from the following file:
- python/lsst/pipe/tasks/calibrateImage.py
Generated on Fri Nov 14 2025 01:46:22 for lsst.pipe.tasks by
1.13.2