|
| | setMetadata (self, metadata) |
| |
| | fromTable (cls, tableList) |
| |
| | setTransmissionCurveRepresentation (self) |
| |
| | getTransmissionCurve (self) |
| |
| | writeFits (self, outputFilename) |
| |
| | requiredAttributes (self) |
| |
| | requiredAttributes (self, value) |
| |
| | __str__ (self) |
| |
| | __eq__ (self, other) |
| |
| | metadata (self) |
| |
| | getMetadata (self) |
| |
| | updateMetadata (self, camera=None, detector=None, filterName=None, setCalibId=False, setCalibInfo=False, setDate=False, **kwargs) |
| |
| | updateMetadataFromExposures (self, exposures) |
| |
| | calibInfoFromDict (self, dictionary) |
| |
| | determineCalibClass (cls, metadata, message) |
| |
| | readText (cls, filename, **kwargs) |
| |
| | writeText (self, filename, format="auto") |
| |
| | readFits (cls, filename, **kwargs) |
| |
| | fromDetector (self, detector) |
| |
| | fromDict (cls, dictionary, **kwargs) |
| |
| | toDict (self) |
| |
| | toTable (self) |
| |
| | validate (self, other=None) |
| |
| | apply (self, target) |
| |
Definition at line 202 of file transmissionCurve.py.
◆ __eq__()
| lsst.ip.isr.calibType.IsrCalib.__eq__ |
( |
| self, |
|
|
| other ) |
|
inherited |
Calibration equivalence.
Running ``calib.log.setLevel(0)`` enables debug statements to
identify problematic fields.
Definition at line 105 of file calibType.py.
◆ __str__()
| lsst.ip.isr.calibType.IsrCalib.__str__ |
( |
| self | ) |
|
|
inherited |
◆ apply()
| lsst.ip.isr.calibType.IsrCalib.apply |
( |
| self, |
|
|
| target ) |
|
inherited |
Method to apply the calibration to the target object.
Parameters
----------
target : `object`
Thing to validate against.
Returns
-------
valid : `bool`
Returns true if the calibration was applied correctly.
Raises
------
NotImplementedError
Raised if not implemented.
Definition at line 706 of file calibType.py.
◆ calibInfoFromDict()
| lsst.ip.isr.calibType.IsrCalib.calibInfoFromDict |
( |
| self, |
|
|
| dictionary ) |
|
inherited |
Handle common keywords.
This isn't an ideal solution, but until all calibrations
expect to find everything in the metadata, they still need to
search through dictionaries.
Parameters
----------
dictionary : `dict` or `lsst.daf.base.PropertyList`
Source for the common keywords.
Raises
------
RuntimeError
Raised if the dictionary does not match the expected OBSTYPE.
Definition at line 325 of file calibType.py.
◆ determineCalibClass()
| lsst.ip.isr.calibType.IsrCalib.determineCalibClass |
( |
| cls, |
|
|
| metadata, |
|
|
| message ) |
|
inherited |
Attempt to find calibration class in metadata.
Parameters
----------
metadata : `dict` or `lsst.daf.base.PropertyList`
Metadata possibly containing a calibration class entry.
message : `str`
Message to include in any errors.
Returns
-------
calibClass : `object`
The class to use to read the file contents. Should be an
`lsst.ip.isr.IsrCalib` subclass.
Raises
------
ValueError
Raised if the resulting calibClass is the base
`lsst.ip.isr.IsrClass` (which does not implement the
content methods).
Definition at line 391 of file calibType.py.
◆ fromDetector()
| lsst.ip.isr.calibType.IsrCalib.fromDetector |
( |
| self, |
|
|
| detector ) |
|
inherited |
◆ fromDict()
| lsst.ip.isr.calibType.IsrCalib.fromDict |
( |
| cls, |
|
|
| dictionary, |
|
|
** | kwargs ) |
|
inherited |
Construct a calibration from a dictionary of properties.
Must be implemented by the specific calibration subclasses.
Parameters
----------
dictionary : `dict`
Dictionary of properties.
kwargs : `dict` or collections.abc.Mapping`, optional
Set of key=value options.
Returns
-------
calib : `lsst.ip.isr.CalibType`
Constructed calibration.
Raises
------
NotImplementedError
Raised if not implemented.
Reimplemented in lsst.ip.isr.brighterFatterKernel.BrighterFatterKernel, lsst.ip.isr.calibType.IsrProvenance, lsst.ip.isr.crosstalk.CrosstalkCalib, lsst.ip.isr.defects.Defects, lsst.ip.isr.deferredCharge.DeferredChargeCalib, lsst.ip.isr.electrostaticBrighterFatter.ElectrostaticBrighterFatterDistortionMatrix, lsst.ip.isr.flatGradient.FlatGradient, lsst.ip.isr.gainCorrection.GainCorrection, lsst.ip.isr.linearize.Linearizer, lsst.ip.isr.photodiode.PhotodiodeCalib, lsst.ip.isr.photodiodeCorrection.PhotodiodeCorrection, lsst.ip.isr.ptcDataset.PhotonTransferCurveDataset, and lsst.ip.isr.shutterMotion.ShutterMotionProfile.
Definition at line 606 of file calibType.py.
◆ fromTable()
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.fromTable |
( |
| cls, |
|
|
| tableList ) |
|
inherited |
Construct intermediate transmission curve from a list of input
tables. Only the first table is used.
Parameters
----------
tableList : `list` [`astropy.table.Table`]
List containing input tables.
Returns
-------
calib : `lsst.ip.isr.IntermediateTransmissionCurve`
The final calibration.
Reimplemented from lsst.ip.isr.calibType.IsrCalib.
Definition at line 66 of file transmissionCurve.py.
◆ getMetadata()
| lsst.ip.isr.calibType.IsrCalib.getMetadata |
( |
| self | ) |
|
|
inherited |
Retrieve metadata associated with this calibration.
Returns
-------
meta : `lsst.daf.base.PropertyList`
Metadata. The returned `~lsst.daf.base.PropertyList` can be
modified by the caller and the changes will be written to
external files.
Definition at line 174 of file calibType.py.
◆ getTransmissionCurve()
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.getTransmissionCurve |
( |
| self | ) |
|
|
inherited |
◆ metadata()
| lsst.ip.isr.calibType.IsrCalib.metadata |
( |
| self | ) |
|
|
inherited |
◆ readFits()
| lsst.ip.isr.calibType.IsrCalib.readFits |
( |
| cls, |
|
|
| filename, |
|
|
** | kwargs ) |
|
inherited |
Read calibration data from a FITS file.
Parameters
----------
filename : `str`
Filename to read data from.
kwargs : `dict` or collections.abc.Mapping`, optional
Set of key=value pairs to pass to the ``fromTable``
method.
Returns
-------
calib : `lsst.ip.isr.IsrCalib`
Calibration contained within the file.
Definition at line 517 of file calibType.py.
◆ readText()
| lsst.ip.isr.calibType.IsrCalib.readText |
( |
| cls, |
|
|
| filename, |
|
|
** | kwargs ) |
|
inherited |
Read calibration representation from a yaml/ecsv file.
Parameters
----------
filename : `str`
Name of the file containing the calibration definition.
kwargs : `dict` or collections.abc.Mapping`, optional
Set of key=value pairs to pass to the ``fromDict`` or
``fromTable`` methods.
Returns
-------
calib : `~lsst.ip.isr.IsrCalibType`
Calibration class.
Raises
------
RuntimeError
Raised if the filename does not end in ".ecsv" or ".yaml".
Definition at line 425 of file calibType.py.
◆ requiredAttributes() [1/2]
| lsst.ip.isr.calibType.IsrCalib.requiredAttributes |
( |
| self | ) |
|
|
inherited |
◆ requiredAttributes() [2/2]
| lsst.ip.isr.calibType.IsrCalib.requiredAttributes |
( |
| self, |
|
|
| value ) |
|
inherited |
◆ setMetadata()
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.setMetadata |
( |
| self, |
|
|
| metadata ) |
|
inherited |
Store a copy of the supplied metadata with this calibration.
Parameters
----------
metadata : `lsst.daf.base.PropertyList`
Metadata to associate with the calibration. Will be copied and
overwrite existing metadata.
Reimplemented from lsst.ip.isr.calibType.IsrCalib.
Definition at line 61 of file transmissionCurve.py.
◆ setTransmissionCurveRepresentation()
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.setTransmissionCurveRepresentation |
( |
| self | ) |
|
|
inherited |
Construct transmission curve representation from the data that was
read.
Raises
------
RuntimeError
This is raised if no table data exists in the calibration,
if there are array length mismatches, or if the wavelength
sampling for multi-amp tables differ.
Definition at line 90 of file transmissionCurve.py.
◆ toDict()
| lsst.ip.isr.calibType.IsrCalib.toDict |
( |
| self | ) |
|
|
inherited |
Return a dictionary containing the calibration properties.
The dictionary should be able to be round-tripped through
`fromDict`.
Returns
-------
dictionary : `dict`
Dictionary of properties.
Raises
------
NotImplementedError
Raised if not implemented.
Reimplemented in lsst.ip.isr.brighterFatterKernel.BrighterFatterKernel, lsst.ip.isr.calibType.IsrProvenance, lsst.ip.isr.crosstalk.CrosstalkCalib, lsst.ip.isr.defects.Defects, lsst.ip.isr.deferredCharge.DeferredChargeCalib, lsst.ip.isr.electrostaticBrighterFatter.ElectrostaticBrighterFatterDistortionMatrix, lsst.ip.isr.flatGradient.FlatGradient, lsst.ip.isr.gainCorrection.GainCorrection, lsst.ip.isr.linearize.Linearizer, lsst.ip.isr.photodiode.PhotodiodeCalib, lsst.ip.isr.photodiodeCorrection.PhotodiodeCorrection, lsst.ip.isr.ptcDataset.PhotonTransferCurveDataset, and lsst.ip.isr.shutterMotion.ShutterMotionProfile.
Definition at line 630 of file calibType.py.
◆ toTable()
| lsst.ip.isr.calibType.IsrCalib.toTable |
( |
| self | ) |
|
|
inherited |
Return a list of tables containing the calibration properties.
The table list should be able to be round-tripped through
`fromDict`.
Returns
-------
tableList : `list` [`lsst.afw.table.Table`]
List of tables of properties.
Raises
------
NotImplementedError
Raised if not implemented.
Reimplemented in lsst.ip.isr.brighterFatterKernel.BrighterFatterKernel, lsst.ip.isr.calibType.IsrProvenance, lsst.ip.isr.crosstalk.CrosstalkCalib, lsst.ip.isr.defects.Defects, lsst.ip.isr.deferredCharge.DeferredChargeCalib, lsst.ip.isr.electrostaticBrighterFatter.ElectrostaticBrighterFatterDistortionMatrix, lsst.ip.isr.flatGradient.FlatGradient, lsst.ip.isr.gainCorrection.GainCorrection, lsst.ip.isr.linearize.Linearizer, lsst.ip.isr.photodiode.PhotodiodeCalib, lsst.ip.isr.photodiodeCorrection.PhotodiodeCorrection, lsst.ip.isr.ptcDataset.PhotonTransferCurveDataset, and lsst.ip.isr.shutterMotion.ShutterMotionProfile.
Definition at line 673 of file calibType.py.
◆ updateMetadata()
| lsst.ip.isr.calibType.IsrCalib.updateMetadata |
( |
| self, |
|
|
| camera = None, |
|
|
| detector = None, |
|
|
| filterName = None, |
|
|
| setCalibId = False, |
|
|
| setCalibInfo = False, |
|
|
| setDate = False, |
|
|
** | kwargs ) |
|
inherited |
Update metadata keywords with new values.
Parameters
----------
camera : `lsst.afw.cameraGeom.Camera`, optional
Reference camera to use to set ``_instrument`` field.
detector : `lsst.afw.cameraGeom.Detector`, optional
Reference detector to use to set ``_detector*`` fields.
filterName : `str`, optional
Filter name to assign to this calibration.
setCalibId : `bool`, optional
Construct the ``_calibId`` field from other fields.
setCalibInfo : `bool`, optional
Set calibration parameters from metadata.
setDate : `bool`, optional
Ensure the metadata ``CALIBDATE`` fields are set to the current
datetime.
kwargs : `dict` or `collections.abc.Mapping`, optional
Set of ``key=value`` pairs to assign to the metadata.
Reimplemented in lsst.ip.isr.brighterFatterKernel.BrighterFatterKernel, lsst.ip.isr.calibType.IsrProvenance, lsst.ip.isr.crosstalk.CrosstalkCalib, lsst.ip.isr.electrostaticBrighterFatter.ElectrostaticBrighterFatterDistortionMatrix, lsst.ip.isr.linearize.Linearizer, lsst.ip.isr.photodiodeCorrection.PhotodiodeCorrection, and lsst.ip.isr.ptcDataset.PhotonTransferCurveDataset.
Definition at line 208 of file calibType.py.
◆ updateMetadataFromExposures()
| lsst.ip.isr.calibType.IsrCalib.updateMetadataFromExposures |
( |
| self, |
|
|
| exposures ) |
|
inherited |
Extract and unify metadata information.
Parameters
----------
exposures : `list`
Exposures or other calibrations to scan.
Definition at line 294 of file calibType.py.
◆ validate()
| lsst.ip.isr.calibType.IsrCalib.validate |
( |
| self, |
|
|
| other = None ) |
|
inherited |
◆ writeFits()
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.writeFits |
( |
| self, |
|
|
| outputFilename ) |
|
inherited |
Write the transmission curve data to a file.
Parameters
----------
outputFilename : `str`
Destination filename.
Returns
-------
outputFilename : `str`
The output filename actually used.
Raises
------
RuntimeError
Raised if no transmission curve can be created.
Reimplemented from lsst.ip.isr.calibType.IsrCalib.
Definition at line 172 of file transmissionCurve.py.
◆ writeText()
| lsst.ip.isr.calibType.IsrCalib.writeText |
( |
| self, |
|
|
| filename, |
|
|
| format = "auto" ) |
|
inherited |
Write the calibration data to a text file.
Parameters
----------
filename : `str`
Name of the file to write.
format : `str`
Format to write the file as. Supported values are:
``"auto"`` : Determine filetype from filename.
``"yaml"`` : Write as yaml.
``"ecsv"`` : Write as ecsv.
Returns
-------
used : `str`
The name of the file used to write the data. This may
differ from the input if the format is explicitly chosen.
Raises
------
RuntimeError
Raised if filename does not end in a known extension, or
if all information cannot be written.
Notes
-----
The file is written to YAML/ECSV format and will include any
associated metadata.
Definition at line 463 of file calibType.py.
◆ _calibId
| str lsst.ip.isr.calibType.IsrCalib._calibId = None |
|
protectedinherited |
◆ _detectorId
| lsst.ip.isr.calibType.IsrCalib._detectorId = None |
|
protectedinherited |
◆ _detectorName
| lsst.ip.isr.calibType.IsrCalib._detectorName = None |
|
protectedinherited |
◆ _detectorSerial
| lsst.ip.isr.calibType.IsrCalib._detectorSerial = None |
|
protectedinherited |
◆ _filter
| lsst.ip.isr.calibType.IsrCalib._filter = None |
|
protectedinherited |
◆ _instrument
| lsst.ip.isr.calibType.IsrCalib._instrument = None |
|
protectedinherited |
◆ _metadata
◆ _OBSTYPE
| str lsst.ip.isr.calibType.IsrCalib._OBSTYPE = "generic" |
|
staticprotectedinherited |
◆ _raftName
| lsst.ip.isr.calibType.IsrCalib._raftName = None |
|
protectedinherited |
◆ _requiredAttributes
| lsst.ip.isr.calibType.IsrCalib._requiredAttributes |
|
protectedinherited |
◆ _SCHEMA
| str lsst.ip.isr.calibType.IsrCalib._SCHEMA = "NO SCHEMA" |
|
staticprotectedinherited |
◆ _seqcksum
| lsst.ip.isr.calibType.IsrCalib._seqcksum = None |
|
protectedinherited |
◆ _seqfile
| lsst.ip.isr.calibType.IsrCalib._seqfile = None |
|
protectedinherited |
◆ _seqname
| lsst.ip.isr.calibType.IsrCalib._seqname = None |
|
protectedinherited |
◆ _slotName
| lsst.ip.isr.calibType.IsrCalib._slotName = None |
|
protectedinherited |
◆ _VERSION
| int lsst.ip.isr.calibType.IsrCalib._VERSION = 0 |
|
staticprotectedinherited |
◆ data
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.data = None |
|
inherited |
◆ isSpatiallyConstant
| bool lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.isSpatiallyConstant = True |
|
inherited |
◆ log
| lsst.ip.isr.calibType.IsrCalib.log = log if log else logging.getLogger(__name__) |
|
inherited |
◆ requiredAttributes
| lsst.ip.isr.calibType.IsrCalib.requiredAttributes = set(["_OBSTYPE", "_SCHEMA", "_VERSION"]) |
|
inherited |
◆ transmissionCurve
| lsst.ip.isr.transmissionCurve.IntermediateTransmissionCurve.transmissionCurve = None |
|
inherited |
The documentation for this class was generated from the following file: