lsst.obs.base

The lsst.obs.base module provides the framework and common API for telescope/camera specific “obs” packages. New cameras will derive from the classes defined here. lsst.obs.base.tests provides the tests that all “obs” packages should pass.

Changes

• obs_base v24.0.0 (2022-08-30)
• obs_base v23.0.0 (2021-12-10)
• obs_base v22.0 (2021-04-01)

Using lsst.obs.base

• How to create a new LSST obs package

Contributing

lsst.obs.base is developed at https://github.com/lsst/obs_base. You can find Jira issues for this module under the obs_base component.

Command Line Interface

daf_butler implements a command line interface command called butler. The following subcommands are implemented by this package and available to the butler command when this package is setup.

Python API reference

lsst.obs.base Package

Functions

bboxFromIraf(irafBBoxStr)	Return a Box2I corresponding to an IRAF-style BBOX
createInitialSkyWcs(visitInfo, detector[, flipX])	Create a SkyWcs from the visit information and detector geometry.
createInitialSkyWcsFromBoresight(boresight, ...)	Create a SkyWcs from the telescope boresight and detector geometry.
loadCamera(butler, dataId, *[, collections])	Attempt to load versioned camera geometry from a butler, but fall back to obtaining a nominal camera from the Instrument class if that fails.
makeExposureRecordFromObsInfo(obsInfo, ...)	Construct an exposure DimensionRecord from astro_metadata_translator.ObservationInfo.
makeTransferChoiceField([doc, default])	Create a Config field with options for transferring data between repos.

Classes

DefineVisitsConfig(*args, **kw)
DefineVisitsTask(config, *, butler, **kwargs)	Driver Task for defining visits (and their spatial regions) in Gen3 Butler repositories.
ExposureIdInfo([expId, expBits, maxBits])	Struct representing an exposure ID and the number of bits it uses.
FilterDefinition(physical_filter[, band, ...])	The definition of an instrument's filter bandpass.
FilterDefinitionCollection(*filters)	An order-preserving collection of multiple FilterDefinition.
FitsRawFormatterBase(*args, **kwargs)	Abstract base class for reading and writing raw data to and from FITS files.
GroupExposuresConfig(*args, **kw)
GroupExposuresTask(config, **kwargs)	Abstract base class for the subtask of DefineVisitsTask that is responsible for grouping exposures into visits.
InitialSkyWcsError	For handling failures when creating a SkyWcs from a camera geometry and boresight.
Instrument([collection_prefix])	Rubin-specified base for instrument-specific logic for the Gen3 Butler.
MakeRawVisitInfoViaObsInfo([log, doStripHeader])	Base class functor to make a VisitInfo from the FITS header of a raw image using ObservationInfo translators.
RawIngestConfig(*args, **kw)	Configuration class for RawIngestTask.
RawIngestTask(config, *, butler, on_success, ...)	Driver Task for ingesting raw data into Gen3 Butler repositories.
VisitDefinitionData(instrument, id, name, ...)	Struct representing a group of exposures that will be used to define a visit.
VisitSystem(value)	Enumeration used to label different visit systems.

Class Inheritance Diagram

lsst.obs.base.tests Module

Functions

make_ramp_array(bbox, pedestal)	Make a 2-d ramp array.
make_ramp_exposure_trimmed(detector[, dtype])	Create a trimmed, assembled exposure with different ramps for each amplifier region.
make_ramp_exposure_untrimmed(detector[, dtype])	Create an untrimmed, assembled exposure with different ramps for each sub-amplifier region.

Classes

ObsTests()

Aggregator class for all of the obs_* test classes.

Class Inheritance Diagram

lsst.obs.base.formatters.fitsExposure Module

Functions

standardizeAmplifierParameters(parameters, ...)

Preprocess the Exposure storage class's "amp" and "detector" parameters

Classes

FitsExposureFormatter(fileDescriptor, dataId)	Concrete formatter for reading/writing Exposure from/to FITS.
FitsImageFormatter(fileDescriptor, dataId[, ...])	Concrete formatter for reading/writing Image from/to FITS.
FitsMaskFormatter(fileDescriptor, dataId[, ...])	Concrete formatter for reading/writing Mask from/to FITS.
FitsMaskedImageFormatter(fileDescriptor, dataId)	Concrete formatter for reading/writing MaskedImage from/to FITS.

Class Inheritance Diagram

lsst.obs.base.formatters.fitsGeneric Module

Classes

FitsGenericFormatter(fileDescriptor, dataId)

Interface for reading and writing objects that support the standard afw I/O readFits/writeFits methods.

Class Inheritance Diagram