CalibrateTask¶

Python API summary¶

from lsst.pipe.tasks.calibrate import CalibrateTask

classCalibrateTask(butler=None, astromRefObjLoader=None, photoRefObjLoader=None, icSourceSchema=None, initInputs=None, **kwargs): !Calibrate an exposure: measure sources and perform astrometric and photometric calibration...

attributeconfig: Access configuration fields and retargetable subtasks.

methodrun(exposure, exposureIdInfo=None, background=None, icSourceCat=None): !Calibrate an exposure (science image or coadd)...

methodrunDataRef(dataRef, exposure=None, background=None, icSourceCat=None, doUnpersist=True): !Calibrate an exposure, optionally unpersisting inputs and persisting outputs...

Retargetable subtasks¶

applyApCorr¶

Default: lsst.meas.base.applyApCorr.ApplyApCorrTask
Field type: ConfigurableField

Subtask to apply aperture corrections

astromRefObjLoader¶

Default: lsst.meas.extensions.astrometryNet.loadAstrometryNetObjects.LoadAstrometryNetObjectsTask
Field type: ConfigurableField

reference object loader for astrometric calibration

astrometry¶

Default: lsst.meas.astrom.astrometry.AstrometryTask
Field type: ConfigurableField

Perform astrometric calibration to refine the WCS

catalogCalculation¶

Default: lsst.meas.base.catalogCalculation.CatalogCalculationTask
Field type: ConfigurableField

Subtask to run catalogCalculation plugins on catalog

deblend¶

Default: lsst.meas.deblender.deblend.SourceDeblendTask
Field type: ConfigurableField

Split blended sources into their components

detection¶

Default: lsst.meas.algorithms.detection.SourceDetectionTask
Field type: ConfigurableField

Detect sources

insertFakes¶

Default: lsst.pipe.tasks.fakes.BaseFakeSourcesTask
Field type: ConfigurableField

Injection of fake sources for testing purposes (must be retargeted)

measurement¶

Default: lsst.meas.base.sfm.SingleFrameMeasurementTask
Field type: ConfigurableField

Measure sources

photoCal¶

Default: lsst.pipe.tasks.photoCal.PhotoCalTask
Field type: ConfigurableField

Perform photometric calibration

photoRefObjLoader¶

Default: lsst.meas.extensions.astrometryNet.loadAstrometryNetObjects.LoadAstrometryNetObjectsTask
Field type: ConfigurableField

reference object loader for photometric calibration

Configuration fields¶

astromRefCat¶

Data type: lsst.pipe.base.config.InputDatasetConfig
Field type: ConfigField

Reference catalog to use for astrometry

background¶

Data type: lsst.pipe.base.config.InputDatasetConfig
Field type: ConfigField

Backgrounds determined by characterize task

checkUnitsParseStrict¶

Default: 'raise'
Field type: str Field

Strictness of Astropy unit compatibility check, can be ‘raise’, ‘warn’ or ‘silent’

doApCorr¶

Default: True
Field type: bool Field

Run subtask to apply aperture correction

doAstrometry¶

Default: True
Field type: bool Field

Perform astrometric calibration?

doDeblend¶

Default: True
Field type: bool Field

Run deblender input exposure

doInsertFakes¶

Default: False
Field type: bool Field

Run fake sources injection task

doPhotoCal¶

Default: True
Field type: bool Field

Perform phometric calibration?

doWrite¶

Default: True
Field type: bool Field

Save calibration results?

doWriteHeavyFootprintsInSources¶

Default: True
Field type: bool Field

Include HeavyFootprint data in source table? If false then heavy footprints are saved as normal footprints, which saves some space

doWriteMatches¶

Default: True
Field type: bool Field

Write reference matches (ignored if doWrite false)?

doWriteMatchesDenormalized¶

Default: False
Field type: bool Field

Write reference matches in denormalized format? This format uses more disk space, but is more convenient to read. Ignored if doWriteMatches=False or doWrite=False.

exposure¶

Data type: lsst.pipe.base.config.InputDatasetConfig
Field type: ConfigField

Input image to calibrate

icSourceCat¶

Data type: lsst.pipe.base.config.InputDatasetConfig
Field type: ConfigField

Source catalog created by characterize task

icSourceFieldsToCopy¶

Default: ('calib_psf_candidate', 'calib_psf_used', 'calib_psf_reserved')
Field type: str ListField

Fields to copy from the icSource catalog to the output catalog for matching sources Any missing fields will trigger a RuntimeError exception. Ignored if icSourceCat is not provided.

icSourceSchema¶

Data type: lsst.pipe.base.config.InitInputDatasetConfig
Field type: ConfigField

Schema produced by characterize image task, used to initialize this task

matchRadiusPix¶

Default: 3
Field type: float Field

Match radius for matching icSourceCat objects to sourceCat objects (pixels)

matches¶

Data type: lsst.pipe.base.config.OutputDatasetConfig
Field type: ConfigField

Source/refObj matches from the astrometry solver

matchesDenormalized¶

Data type: lsst.pipe.base.config.OutputDatasetConfig
Field type: ConfigField

Denormalized matches from astrometry solver

outputBackground¶

Data type: lsst.pipe.base.config.OutputDatasetConfig
Field type: ConfigField

Background models estimated in calibration task

outputCat¶

Data type: lsst.pipe.base.config.OutputDatasetConfig
Field type: ConfigField

Source catalog produced in calibrate task

outputExposure¶

Data type: lsst.pipe.base.config.OutputDatasetConfig
Field type: ConfigField

Exposure after running calibration task

outputSchema¶

Data type: lsst.pipe.base.config.InitOutputDatasetConfig
Field type: ConfigField

Schema after CalibrateTask has been initialized

photoRefCat¶

Data type: lsst.pipe.base.config.InputDatasetConfig
Field type: ConfigField

Reference catalog to use for photometric calibration

quantum¶

Data type: lsst.pipe.base.config.QuantumConfig
Field type: ConfigField

configuration for PipelineTask quantum

requireAstrometry¶

Default: True
Field type: bool Field

Raise an exception if astrometry fails? Ignored if doAstrometry false.

requirePhotoCal¶

Default: True
Field type: bool Field

Raise an exception if photoCal fails? Ignored if doPhotoCal false.

Navigation