Instrument

class lsst.obs.base.Instrument(*args, **kwargs)

Bases: object

Base class for instrument-specific logic for the Gen3 Butler.

Concrete instrument subclasses should be directly constructable with no arguments.

Attributes Summary

configPaths Paths to config files to read for specific Tasks.
filterDefinitions FilterDefinitionCollection, defining the filters for this instrument.
obsDataPackage Name of the package containing the text curated calibration files.
obsDataPackageDir
policyName Instrument specific name to use when locating a policy or configuration file in the file system.
standardCuratedDatasetTypes The dataset types expected to be obtained from the obsDataPackage.

Methods Summary

applyConfigOverrides(name, config) Apply instrument-specific overrides for a task config.
getCamera() Retrieve the cameraGeom representation of this instrument.
getName()
getRawFormatter(dataId) Return the Formatter class that should be used to read a particular raw file.
register(registry) Insert instrument, physical_filter, and detector entries into a Registry.
writeCameraGeom(butler) Write the default camera geometry to the butler repository with an infinite validity range.
writeCuratedCalibrations(butler) Write human-curated calibration Datasets to the given Butler with the appropriate validity ranges.
writeStandardTextCuratedCalibrations(butler) Write the set of standardized curated text calibrations to the repository.

Attributes Documentation

configPaths = ()

Paths to config files to read for specific Tasks.

The paths in this list should contain files of the form task.py, for each of the Tasks that requires special configuration.

filterDefinitions

FilterDefinitionCollection, defining the filters for this instrument.

obsDataPackage = None

Name of the package containing the text curated calibration files. Usually a obs _data package. If None no curated calibration files will be read. (str)

obsDataPackageDir
policyName = None

Instrument specific name to use when locating a policy or configuration file in the file system.

standardCuratedDatasetTypes = ('defects', 'qe_curve')

The dataset types expected to be obtained from the obsDataPackage. These dataset types are all required to have standard definitions and must be known to the base class. Clearing this list will prevent any of these calibrations from being stored. If a dataset type is not known to a specific instrument it can still be included in this list since the data package is the source of truth.

Methods Documentation

applyConfigOverrides(name, config)

Apply instrument-specific overrides for a task config.

Parameters:
name : str

Name of the object being configured; typically the _DefaultName of a Task.

config : lsst.pex.config.Config

Config instance to which overrides should be applied.

getCamera()

Retrieve the cameraGeom representation of this instrument.

This is a temporary API that should go away once obs_ packages have a standardized approach to writing versioned cameras to a Gen3 repo.

classmethod getName()
getRawFormatter(dataId)

Return the Formatter class that should be used to read a particular raw file.

Parameters:
dataId : DataCoordinate

Dimension-based ID for the raw file or files being ingested.

Returns:
formatter : Formatter class

Class to be used that reads the file into an lsst.afw.image.Exposure instance.

register(registry)

Insert instrument, physical_filter, and detector entries into a Registry.

writeCameraGeom(butler)

Write the default camera geometry to the butler repository with an infinite validity range.

Parameters:
butler : lsst.daf.butler.Butler

Butler to receive these calibration datasets.

writeCuratedCalibrations(butler)

Write human-curated calibration Datasets to the given Butler with the appropriate validity ranges.

Parameters:
butler : lsst.daf.butler.Butler

Butler to use to store these calibrations.

Notes

Expected to be called from subclasses. The base method calls writeCameraGeom and writeStandardTextCuratedCalibrations.

writeStandardTextCuratedCalibrations(butler)

Write the set of standardized curated text calibrations to the repository.

Parameters:
butler : lsst.daf.butler.Butler

Butler to receive these calibration datasets.