lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase Class Reference

Inheritance diagram for lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase:

Public Member Functions
def	__init__ (self, *args, **kwargs)
def	fromMetadata (cls, metadata, obsInfo=None, storageClass=None, location=None)
def	translatorClass (self)
def	filterDefinitions (self)
def	readImage (self)
def	readMask (self)
def	readVariance (self)
def	isOnSky (self)
def	stripMetadata (self)
def	makeVisitInfo (self)
def	getDetector (self, id)
def	makeWcs (self, visitInfo, detector)
def	makeRawSkyWcsFromBoresight (cls, boresight, orientation, detector)
def	makeFilter (self)
def	makeFilterLabel (self)
def	readComponent (self, component, parameters=None)
def	readFull (self, parameters=None)
def	readRawHeaderWcs (self, parameters=None)
def	write (self, inMemoryDataset)
def	observationInfo (self)
def	metadata (self)
def	readMetadata (self)
def	read (self, component=None)
def	getImageCompressionSettings (self, recipeName)
def	validateWriteRecipes (cls, recipes)

Static Public Attributes
bool	wcsFlipX = False
	supportedExtensions = frozenset({".fits", ".fits.gz", ".fits.fz", ".fz", ".fit"})
string	extension = ".fits"
	supportedWriteParameters = frozenset({"recipe"})
dictionary	unsupportedParameters = {}

Detailed Description

Abstract base class for reading and writing raw data to and from
FITS files.

Definition at line 40 of file _fitsRawFormatterBase.py.

Constructor & Destructor Documentation

__init__()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.__init__	(		self,
		*	args,
		**	kwargs
	)

Definition at line 49 of file _fitsRawFormatterBase.py.

    def __init__(self, *args, **kwargs):
        self.filterDefinitions.reset()
        self.filterDefinitions.defineFilters()
        super().__init__(*args, **kwargs)
 

Member Function Documentation

filterDefinitions()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.filterDefinitions

(

self

)

`~lsst.obs.base.FilterDefinitions`, defining the filters for this
instrument.

Definition at line 98 of file _fitsRawFormatterBase.py.

    def filterDefinitions(self):
        """`~lsst.obs.base.FilterDefinitions`, defining the filters for this
        instrument.
        """
        return None
 

fromMetadata()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.fromMetadata	(		cls,
			metadata,
			obsInfo = None,
			storageClass = None,
			location = None
	)

Construct a possibly-limited formatter from known metadata.

Parameters
----------
metadata : `lsst.daf.base.PropertyList`
    Raw header metadata, with any fixes (see
    `astro_metadata_translator.fix_header`) applied but nothing
    stripped.
obsInfo : `astro_metadata_translator.ObservationInfo`, optional
    Structured information already extracted from ``metadata``.
    If not provided, will be read from ``metadata`` on first use.
storageClass : `lsst.daf.butler.StorageClass`, optional
    StorageClass for this file.  If not provided, the formatter will
    only support `makeWcs`, `makeVisitInfo`, `makeFilter`, and other
    operations that operate purely on metadata and not the actual file.
location : `lsst.daf.butler.Location`, optional.
    Location of the file.  If not provided, the formatter will only
    support `makeWcs`, `makeVisitInfo`, `makeFilter`, and other
    operations that operate purely on metadata and not the actual file.

Returns
-------
formatter : `FitsRawFormatterBase`
    An instance of ``cls``.

Definition at line 55 of file _fitsRawFormatterBase.py.

    def fromMetadata(cls, metadata, obsInfo=None, storageClass=None, location=None):
        """Construct a possibly-limited formatter from known metadata.
 
        Parameters
        ----------
        metadata : `lsst.daf.base.PropertyList`
            Raw header metadata, with any fixes (see
            `astro_metadata_translator.fix_header`) applied but nothing
            stripped.
        obsInfo : `astro_metadata_translator.ObservationInfo`, optional
            Structured information already extracted from ``metadata``.
            If not provided, will be read from ``metadata`` on first use.
        storageClass : `lsst.daf.butler.StorageClass`, optional
            StorageClass for this file.  If not provided, the formatter will
            only support `makeWcs`, `makeVisitInfo`, `makeFilter`, and other
            operations that operate purely on metadata and not the actual file.
        location : `lsst.daf.butler.Location`, optional.
            Location of the file.  If not provided, the formatter will only
            support `makeWcs`, `makeVisitInfo`, `makeFilter`, and other
            operations that operate purely on metadata and not the actual file.
 
        Returns
        -------
        formatter : `FitsRawFormatterBase`
            An instance of ``cls``.
        """
        self = cls(FileDescriptor(location, storageClass))
        self._metadata = metadata
        self._observationInfo = obsInfo
        return self
 

getDetector()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.getDetector	(		self,
			id
	)

Return the detector that acquired this raw exposure.

Parameters
----------
id : `int`
    The identifying number of the detector to get.

Returns
-------
detector : `~lsst.afw.cameraGeom.Detector`
    The detector associated with that ``id``.

Reimplemented in lsst.obs.decam.rawFormatter.DarkEnergyCameraRawFormatter.

Definition at line 184 of file _fitsRawFormatterBase.py.

    def getDetector(self, id):
        """Return the detector that acquired this raw exposure.
 
        Parameters
        ----------
        id : `int`
            The identifying number of the detector to get.
 
        Returns
        -------
        detector : `~lsst.afw.cameraGeom.Detector`
            The detector associated with that ``id``.
        """
        raise NotImplementedError("Must be implemented by subclasses.")
 

getImageCompressionSettings()

def lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.getImageCompressionSettings (   self,   recipeName  )

inherited

Retrieve the relevant compression settings for this recipe.

Parameters
----------
recipeName : `str`
    Label associated with the collection of compression parameters
    to select.

Returns
-------
settings : `dict`
    The selected settings.

Definition at line 304 of file fitsExposure.py.

    def getImageCompressionSettings(self, recipeName):
        """Retrieve the relevant compression settings for this recipe.
 
        Parameters
        ----------
        recipeName : `str`
            Label associated with the collection of compression parameters
            to select.
 
        Returns
        -------
        settings : `dict`
            The selected settings.
        """
        # if no recipe has been provided and there is no default
        # return immediately
        if not recipeName:
            if "default" not in self.writeRecipes:
                return {}
            recipeName = "default"
 
        if recipeName not in self.writeRecipes:
            raise RuntimeError(f"Unrecognized recipe option given for compression: {recipeName}")
 
        recipe = self.writeRecipes[recipeName]
 
        # Set the seed based on dataId
        seed = hash(tuple(self.dataId.items())) % 2**31
        for plane in ("image", "mask", "variance"):
            if plane in recipe and "scaling" in recipe[plane]:
                scaling = recipe[plane]["scaling"]
                if "seed" in scaling and scaling["seed"] == 0:
                    scaling["seed"] = seed
 
        return recipe
 

isOnSky()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.isOnSky

(

self

)

Boolean to determine if the exposure is thought to be on the sky.

Returns
-------
onSky : `bool`
    Returns `True` if the observation looks like it was taken on the
    sky.  Returns `False` if this observation looks like a calibration
    observation.

Notes
-----
If there is tracking RA/Dec information associated with the
observation it is assumed that the observation is on sky.
Currently the observation type is not checked.

Definition at line 144 of file _fitsRawFormatterBase.py.

    def isOnSky(self):
        """Boolean to determine if the exposure is thought to be on the sky.
 
        Returns
        -------
        onSky : `bool`
            Returns `True` if the observation looks like it was taken on the
            sky.  Returns `False` if this observation looks like a calibration
            observation.
 
        Notes
        -----
        If there is tracking RA/Dec information associated with the
        observation it is assumed that the observation is on sky.
        Currently the observation type is not checked.
        """
        if self.observationInfo.tracking_radec is None:
            return False
        return True
 

makeFilter()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.makeFilter

(

self

)

Construct a Filter from metadata.

Returns
-------
filter : `~lsst.afw.image.Filter`
    Object that identifies the filter for this image.

Raises
------
NotFoundError
    Raised if the physical filter was not registered via
    `~lsst.afw.image.utils.defineFilter`.

Definition at line 286 of file _fitsRawFormatterBase.py.

    def makeFilter(self):
        """Construct a Filter from metadata.
 
        Returns
        -------
        filter : `~lsst.afw.image.Filter`
            Object that identifies the filter for this image.
 
        Raises
        ------
        NotFoundError
            Raised if the physical filter was not registered via
            `~lsst.afw.image.utils.defineFilter`.
        """
        return lsst.afw.image.Filter(self.observationInfo.physical_filter)
 

makeFilterLabel()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.makeFilterLabel

(

self

)

Construct a FilterLabel from metadata.

Returns
-------
filter : `~lsst.afw.image.FilterLabel`
    Object that identifies the filter for this image.

Definition at line 303 of file _fitsRawFormatterBase.py.

    def makeFilterLabel(self):
        """Construct a FilterLabel from metadata.
 
        Returns
        -------
        filter : `~lsst.afw.image.FilterLabel`
            Object that identifies the filter for this image.
        """
        physical = self.observationInfo.physical_filter
        band = self.filterDefinitions.physical_to_band[physical]
        return lsst.afw.image.FilterLabel(physical=physical, band=band)
 

makeRawSkyWcsFromBoresight()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.makeRawSkyWcsFromBoresight	(		cls,
			boresight,
			orientation,
			detector
	)

Class method to make a raw sky WCS from boresight and detector.

Parameters
----------
boresight : `lsst.geom.SpherePoint`
    The ICRS boresight RA/Dec
orientation : `lsst.geom.Angle`
    The rotation angle of the focal plane on the sky.
detector : `lsst.afw.cameraGeom.Detector`
    Where to get the camera geomtry from.

Returns
-------
skyWcs : `~lsst.afw.geom.SkyWcs`
    Reversible mapping from pixel coordinates to sky coordinates.

Definition at line 245 of file _fitsRawFormatterBase.py.

    def makeRawSkyWcsFromBoresight(cls, boresight, orientation, detector):
        """Class method to make a raw sky WCS from boresight and detector.
 
        Parameters
        ----------
        boresight : `lsst.geom.SpherePoint`
            The ICRS boresight RA/Dec
        orientation : `lsst.geom.Angle`
            The rotation angle of the focal plane on the sky.
        detector : `lsst.afw.cameraGeom.Detector`
            Where to get the camera geomtry from.
 
        Returns
        -------
        skyWcs : `~lsst.afw.geom.SkyWcs`
            Reversible mapping from pixel coordinates to sky coordinates.
        """
        return createInitialSkyWcsFromBoresight(boresight, orientation, detector, flipX=cls.wcsFlipX)
 

makeVisitInfo()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.makeVisitInfo

(

self

)

Construct a VisitInfo from metadata.

Returns
-------
visitInfo : `~lsst.afw.image.VisitInfo`
    Structured metadata about the observation.

Definition at line 173 of file _fitsRawFormatterBase.py.

    def makeVisitInfo(self):
        """Construct a VisitInfo from metadata.
 
        Returns
        -------
        visitInfo : `~lsst.afw.image.VisitInfo`
            Structured metadata about the observation.
        """
        return MakeRawVisitInfoViaObsInfo.observationInfo2visitInfo(self.observationInfo)
 

makeWcs()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.makeWcs	(		self,
			visitInfo,
			detector
	)

Create a SkyWcs from information about the exposure.

If VisitInfo is not None, use it and the detector to create a SkyWcs,
otherwise return the metadata-based SkyWcs (always created, so that
the relevant metadata keywords are stripped).

Parameters
----------
visitInfo : `~lsst.afw.image.VisitInfo`
    The information about the telescope boresight and camera
    orientation angle for this exposure.
detector : `~lsst.afw.cameraGeom.Detector`
    The detector used to acquire this exposure.

Returns
-------
skyWcs : `~lsst.afw.geom.SkyWcs`
    Reversible mapping from pixel coordinates to sky coordinates.

Raises
------
InitialSkyWcsError
    Raised if there is an error generating the SkyWcs, chained from the
    lower-level exception if available.

Definition at line 199 of file _fitsRawFormatterBase.py.

    def makeWcs(self, visitInfo, detector):
        """Create a SkyWcs from information about the exposure.
 
        If VisitInfo is not None, use it and the detector to create a SkyWcs,
        otherwise return the metadata-based SkyWcs (always created, so that
        the relevant metadata keywords are stripped).
 
        Parameters
        ----------
        visitInfo : `~lsst.afw.image.VisitInfo`
            The information about the telescope boresight and camera
            orientation angle for this exposure.
        detector : `~lsst.afw.cameraGeom.Detector`
            The detector used to acquire this exposure.
 
        Returns
        -------
        skyWcs : `~lsst.afw.geom.SkyWcs`
            Reversible mapping from pixel coordinates to sky coordinates.
 
        Raises
        ------
        InitialSkyWcsError
            Raised if there is an error generating the SkyWcs, chained from the
            lower-level exception if available.
        """
        if not self.isOnSky():
            # This is not an on-sky observation
            return None
 
        skyWcs = self._createSkyWcsFromMetadata()
 
        log = lsst.log.Log.getLogger("fitsRawFormatter")
        if visitInfo is None:
            msg = "No VisitInfo; cannot access boresight information. Defaulting to metadata-based SkyWcs."
            log.warn(msg)
            if skyWcs is None:
                raise InitialSkyWcsError("Failed to create both metadata and boresight-based SkyWcs."
                                         "See warnings in log messages for details.")
            return skyWcs
 
        return self.makeRawSkyWcsFromBoresight(visitInfo.getBoresightRaDec(),
                                               visitInfo.getBoresightRotAngle(),
                                               detector)
 

metadata()

def lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.metadata (   self )

inherited

The metadata read from this file. It will be stripped as
components are extracted from it
(`lsst.daf.base.PropertyList`).

Definition at line 95 of file fitsExposure.py.

    def metadata(self):
        """The metadata read from this file. It will be stripped as
        components are extracted from it
        (`lsst.daf.base.PropertyList`).
        """
        if self._metadata is None:
            self._metadata = self.readMetadata()
        return self._metadata
 

observationInfo()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.observationInfo

(

self

)

The `~astro_metadata_translator.ObservationInfo` extracted from
this file's metadata (`~astro_metadata_translator.ObservationInfo`,
read-only).

Definition at line 407 of file _fitsRawFormatterBase.py.

    def observationInfo(self):
        """The `~astro_metadata_translator.ObservationInfo` extracted from
        this file's metadata (`~astro_metadata_translator.ObservationInfo`,
        read-only).
        """
        if self._observationInfo is None:
            location = self.fileDescriptor.location
            path = location.path if location is not None else None
            self._observationInfo = ObservationInfo(self.metadata, translator_class=self.translatorClass,
                                                    filename=path)
        return self._observationInfo

read()

def lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.read (   self,   component = None  )

inherited

Read data from a file.

Parameters
----------
component : `str`, optional
    Component to read from the file. Only used if the `StorageClass`
    for reading differed from the `StorageClass` used to write the
    file.

Returns
-------
inMemoryDataset : `object`
    The requested data as a Python object. The type of object
    is controlled by the specific formatter.

Raises
------
ValueError
    Component requested but this file does not seem to be a concrete
    composite.
KeyError
    Raised when parameters passed with fileDescriptor are not
    supported.

Definition at line 242 of file fitsExposure.py.

    def read(self, component=None):
        """Read data from a file.
 
        Parameters
        ----------
        component : `str`, optional
            Component to read from the file. Only used if the `StorageClass`
            for reading differed from the `StorageClass` used to write the
            file.
 
        Returns
        -------
        inMemoryDataset : `object`
            The requested data as a Python object. The type of object
            is controlled by the specific formatter.
 
        Raises
        ------
        ValueError
            Component requested but this file does not seem to be a concrete
            composite.
        KeyError
            Raised when parameters passed with fileDescriptor are not
            supported.
        """
        fileDescriptor = self.fileDescriptor
        if fileDescriptor.readStorageClass != fileDescriptor.storageClass:
            if component == "metadata":
                self.stripMetadata()
                return self.metadata
            elif component is not None:
                return self.readComponent(component)
            else:
                raise ValueError("Storage class inconsistency ({} vs {}) but no"
                                 " component requested".format(fileDescriptor.readStorageClass.name,
                                                               fileDescriptor.storageClass.name))
        return self.readFull()
 

readComponent()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readComponent	(		self,
			component,
			parameters = None
	)

Read a component held by the Exposure.

Parameters
----------
component : `str`, optional
    Component to read from the file.
parameters : `dict`, optional
    If specified, a dictionary of slicing parameters that
    overrides those in ``fileDescriptor``.

Returns
-------
obj : component-dependent
    In-memory component object.

Raises
------
KeyError
    Raised if the requested component cannot be handled.

Reimplemented from lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.

Definition at line 315 of file _fitsRawFormatterBase.py.

    def readComponent(self, component, parameters=None):
        """Read a component held by the Exposure.
 
        Parameters
        ----------
        component : `str`, optional
            Component to read from the file.
        parameters : `dict`, optional
            If specified, a dictionary of slicing parameters that
            overrides those in ``fileDescriptor``.
 
        Returns
        -------
        obj : component-dependent
            In-memory component object.
 
        Raises
        ------
        KeyError
            Raised if the requested component cannot be handled.
        """
        if component == "image":
            return self.readImage()
        elif component == "mask":
            return self.readMask()
        elif component == "variance":
            return self.readVariance()
        elif component == "filter":
            return self.makeFilter()
        elif component == "filterLabel":
            return self.makeFilterLabel()
        elif component == "visitInfo":
            return self.makeVisitInfo()
        elif component == "wcs":
            detector = self.getDetector(self.observationInfo.detector_num)
            visitInfo = self.makeVisitInfo()
            return self.makeWcs(visitInfo, detector)
        return None
 

readFull()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readFull	(		self,
			parameters = None
	)

Read the full Exposure object.

Parameters
----------
parameters : `dict`, optional
    If specified, a dictionary of slicing parameters that overrides
    those in the `fileDescriptor` attribute.

Returns
-------
exposure : `~lsst.afw.image.Exposure`
    Complete in-memory exposure.

Reimplemented from lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.

Definition at line 354 of file _fitsRawFormatterBase.py.

    def readFull(self, parameters=None):
        """Read the full Exposure object.
 
        Parameters
        ----------
        parameters : `dict`, optional
            If specified, a dictionary of slicing parameters that overrides
            those in the `fileDescriptor` attribute.
 
        Returns
        -------
        exposure : `~lsst.afw.image.Exposure`
            Complete in-memory exposure.
        """
        from lsst.afw.image import makeExposure, makeMaskedImage
        full = makeExposure(makeMaskedImage(self.readImage()))
        mask = self.readMask()
        if mask is not None:
            full.setMask(mask)
        variance = self.readVariance()
        if variance is not None:
            full.setVariance(variance)
        full.setDetector(self.getDetector(self.observationInfo.detector_num))
        info = full.getInfo()
        info.setFilterLabel(self.makeFilterLabel())
        info.setVisitInfo(self.makeVisitInfo())
        info.setWcs(self.makeWcs(info.getVisitInfo(), info.getDetector()))
        # We don't need to call stripMetadata() here because it has already
        # been stripped during creation of the ObservationInfo, WCS, etc.
        full.setMetadata(self.metadata)
        return full
 

readImage()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readImage

(

self

)

Read just the image component of the Exposure.

Returns
-------
image : `~lsst.afw.image.Image`
    In-memory image component.

Reimplemented in lsst.obs.decam.rawFormatter.DarkEnergyCameraCPCalibFormatter, and lsst.obs.decam.rawFormatter.DarkEnergyCameraRawFormatter.

Definition at line 104 of file _fitsRawFormatterBase.py.

    def readImage(self):
        """Read just the image component of the Exposure.
 
        Returns
        -------
        image : `~lsst.afw.image.Image`
            In-memory image component.
        """
        return lsst.afw.image.ImageU(self.fileDescriptor.location.path)
 

readMask()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readMask

(

self

)

Read just the mask component of the Exposure.

May return None (as the default implementation does) to indicate that
there is no mask information to be extracted (at least not trivially)
from the raw data.  This will prohibit direct reading of just the mask,
and set the mask of the full Exposure to zeros.

Returns
-------
mask : `~lsst.afw.image.Mask`
    In-memory mask component.

Definition at line 114 of file _fitsRawFormatterBase.py.

    def readMask(self):
        """Read just the mask component of the Exposure.
 
        May return None (as the default implementation does) to indicate that
        there is no mask information to be extracted (at least not trivially)
        from the raw data.  This will prohibit direct reading of just the mask,
        and set the mask of the full Exposure to zeros.
 
        Returns
        -------
        mask : `~lsst.afw.image.Mask`
            In-memory mask component.
        """
        return None
 

readMetadata()

def lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.readMetadata (   self )

inherited

Read all header metadata directly into a PropertyList.

Returns
-------
metadata : `~lsst.daf.base.PropertyList`
    Header metadata.

Reimplemented in lsst.obs.decam.rawFormatter.DarkEnergyCameraRawFormatter.

Definition at line 104 of file fitsExposure.py.

    def readMetadata(self):
        """Read all header metadata directly into a PropertyList.
 
        Returns
        -------
        metadata : `~lsst.daf.base.PropertyList`
            Header metadata.
        """
        md = readMetadata(self.fileDescriptor.location.path)
        fix_header(md)
        return md
 

readRawHeaderWcs()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readRawHeaderWcs	(		self,
			parameters = None
	)

Read the SkyWcs stored in the un-modified raw FITS WCS header keys.

Definition at line 386 of file _fitsRawFormatterBase.py.

    def readRawHeaderWcs(self, parameters=None):
        """Read the SkyWcs stored in the un-modified raw FITS WCS header keys.
        """
        return lsst.afw.geom.makeSkyWcs(lsst.afw.fits.readMetadata(self.fileDescriptor.location.path))
 

readVariance()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.readVariance

(

self

)

Read just the variance component of the Exposure.

May return None (as the default implementation does) to indicate that
there is no variance information to be extracted (at least not
trivially) from the raw data.  This will prohibit direct reading of
just the variance, and set the variance of the full Exposure to zeros.

Returns
-------
image : `~lsst.afw.image.Image`
    In-memory variance component.

Definition at line 129 of file _fitsRawFormatterBase.py.

    def readVariance(self):
        """Read just the variance component of the Exposure.
 
        May return None (as the default implementation does) to indicate that
        there is no variance information to be extracted (at least not
        trivially) from the raw data.  This will prohibit direct reading of
        just the variance, and set the variance of the full Exposure to zeros.
 
        Returns
        -------
        image : `~lsst.afw.image.Image`
            In-memory variance component.
        """
        return None
 

stripMetadata()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.stripMetadata

(

self

)

Remove metadata entries that are parsed into components.

Reimplemented from lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.

Definition at line 164 of file _fitsRawFormatterBase.py.

    def stripMetadata(self):
        """Remove metadata entries that are parsed into components.
        """
        # NOTE: makeVisitInfo() may not strip any metadata itself, but calling
        # it ensures that ObservationInfo is created from the metadata, which
        # will strip the VisitInfo keys and more.
        self.makeVisitInfo()
        self._createSkyWcsFromMetadata()
 

translatorClass()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.translatorClass

(

self

)

`~astro_metadata_translator.MetadataTranslator` to translate
metadata header to `~astro_metadata_translator.ObservationInfo`.

Definition at line 88 of file _fitsRawFormatterBase.py.

    def translatorClass(self):
        """`~astro_metadata_translator.MetadataTranslator` to translate
        metadata header to `~astro_metadata_translator.ObservationInfo`.
        """
        return None
 

validateWriteRecipes()

def lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.validateWriteRecipes (   cls,   recipes  )

inherited

Validate supplied recipes for this formatter.

The recipes are supplemented with default values where appropriate.

TODO: replace this custom validation code with Cerberus (DM-11846)

Parameters
----------
recipes : `dict`
    Recipes to validate. Can be empty dict or `None`.

Returns
-------
validated : `dict`
    Validated recipes. Returns what was given if there are no
    recipes listed.

Raises
------
RuntimeError
    Raised if validation fails.

Definition at line 341 of file fitsExposure.py.

    def validateWriteRecipes(cls, recipes):
        """Validate supplied recipes for this formatter.
 
        The recipes are supplemented with default values where appropriate.
 
        TODO: replace this custom validation code with Cerberus (DM-11846)
 
        Parameters
        ----------
        recipes : `dict`
            Recipes to validate. Can be empty dict or `None`.
 
        Returns
        -------
        validated : `dict`
            Validated recipes. Returns what was given if there are no
            recipes listed.
 
        Raises
        ------
        RuntimeError
            Raised if validation fails.
        """
        # Schemas define what should be there, and the default values (and by
        # the default value, the expected type).
        compressionSchema = {
            "algorithm": "NONE",
            "rows": 1,
            "columns": 0,
            "quantizeLevel": 0.0,
        }
        scalingSchema = {
            "algorithm": "NONE",
            "bitpix": 0,
            "maskPlanes": ["NO_DATA"],
            "seed": 0,
            "quantizeLevel": 4.0,
            "quantizePad": 5.0,
            "fuzz": True,
            "bscale": 1.0,
            "bzero": 0.0,
        }
 
        if not recipes:
            # We can not insist on recipes being specified
            return recipes
 
        def checkUnrecognized(entry, allowed, description):
            """Check to see if the entry contains unrecognised keywords"""
            unrecognized = set(entry) - set(allowed)
            if unrecognized:
                raise RuntimeError(
                    f"Unrecognized entries when parsing image compression recipe {description}: "
                    f"{unrecognized}")
 
        validated = {}
        for name in recipes:
            checkUnrecognized(recipes[name], ["image", "mask", "variance"], name)
            validated[name] = {}
            for plane in ("image", "mask", "variance"):
                checkUnrecognized(recipes[name][plane], ["compression", "scaling"],
                                  f"{name}->{plane}")
 
                np = {}
                validated[name][plane] = np
                for settings, schema in (("compression", compressionSchema),
                                         ("scaling", scalingSchema)):
                    np[settings] = {}
                    if settings not in recipes[name][plane]:
                        for key in schema:
                            np[settings][key] = schema[key]
                        continue
                    entry = recipes[name][plane][settings]
                    checkUnrecognized(entry, schema.keys(), f"{name}->{plane}->{settings}")
                    for key in schema:
                        value = type(schema[key])(entry[key]) if key in entry else schema[key]
                        np[settings][key] = value
        return validated
 
 

write()

def lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.write	(		self,
			inMemoryDataset
	)

Write a Python object to a file.

Parameters
----------
inMemoryDataset : `object`
    The Python object to store.

Returns
-------
path : `str`
    The `URI` where the primary file is stored.

Reimplemented from lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.

Definition at line 391 of file _fitsRawFormatterBase.py.

    def write(self, inMemoryDataset):
        """Write a Python object to a file.
 
        Parameters
        ----------
        inMemoryDataset : `object`
            The Python object to store.
 
        Returns
        -------
        path : `str`
            The `URI` where the primary file is stored.
        """
        raise NotImplementedError("Raw data cannot be `put`.")
 

Member Data Documentation

extension

string lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.extension = ".fits"

staticinherited

Definition at line 86 of file fitsExposure.py.

supportedExtensions

lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.supportedExtensions = frozenset({".fits", ".fits.gz", ".fits.fz", ".fz", ".fit"})

staticinherited

Definition at line 85 of file fitsExposure.py.

supportedWriteParameters

lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.supportedWriteParameters = frozenset({"recipe"})

staticinherited

Definition at line 88 of file fitsExposure.py.

unsupportedParameters

dictionary lsst.obs.base.formatters.fitsExposure.FitsExposureFormatter.unsupportedParameters = {}

staticinherited

Definition at line 91 of file fitsExposure.py.

wcsFlipX

bool lsst.obs.base._fitsRawFormatterBase.FitsRawFormatterBase.wcsFlipX = False

static

Definition at line 46 of file _fitsRawFormatterBase.py.

---

The documentation for this class was generated from the following file:

• /j/snowflake/release/lsstsw/stack/0.2.1/Linux64/obs_base/21.0.0-27-gbbd0d29+ae871e0f33/python/lsst/obs/base/_fitsRawFormatterBase.py