GeneralizedImage#

class lsst.images.GeneralizedImage(metadata: dict[str, MetadataValue] | None = None)#

Bases: ABC

A base class for types that represent one or more 2-d image-like arrays with the same pixel grid and projection.

Parameters#

Attributes Summary

`absolute`	A proxy object for slicing a generalized image using absolute pixel coordinates.
`astropy_wcs`	An Astropy WCS for this image's pixel array.
`bbox`	Bounding box for the image (`Box`).
`butler_dataset`	The butler dataset reference for this image (`lsst.daf.butler.SerializedDatasetRef` \| `None`).
`butler_provenance`	The butler inputs and ID of the task quantum that produced this dataset (`lsst.daf.butler.DatasetProvenance` \| `None`)
`fits_wcs`	An Astropy FITS WCS for this image's pixel array.
`local`	A proxy object for slicing a generalized image using "local" or "array" pixel coordinates.
`metadata`	Arbitrary flexible metadata associated with the image (`dict`).
`projection`	The projection that maps this image's pixel grid to the sky (`Projection` \| `None`).

Methods Summary

Deep-copy the image and metadata.

Attributes Documentation

absolute#: A proxy object for slicing a generalized image using absolute pixel coordinates.

Notes#

In this convention, the first row and column of the pixel grid is bbox.start. A subimage and its parent image share the same absolute pixel coordinate system, and most lsst.images types (e.g. Box, Projection, PointSpreadFunction) operate exclusively in this system.

Note that astropy.wcs and numpy.ndarray are not aware of the bbox.start offset that defines tihs coordinates system; use local slicing for indices obtained from those.

See Also#

lsst.images.BoxSliceFactory lsst.images.IntervalSliceFactory

astropy_wcs#: An Astropy WCS for this image’s pixel array.

Notes#

As expected for Astropy WCS objects, this defines pixel coordinates such that the first row and column in any associated arrays are (0, 0), not bbox.start, as is the case for projection.

This object satisfies the astropy.wcs.wcsapi.BaseHighLevelWCS and astropy.wcs.wcsapi.BaseLowLevelWCS interfaces, but it is not an astropy.wcs.WCS (use fits_wcs for that).

butler_dataset#: The butler dataset reference for this image (lsst.daf.butler.SerializedDatasetRef | None).

butler_provenance#: The butler inputs and ID of the task quantum that produced this dataset (lsst.daf.butler.DatasetProvenance | None)

fits_wcs#: An Astropy FITS WCS for this image’s pixel array.

Notes#

As expected for Astropy WCS objects, this defines pixel coordinates such that the first row and column in any associated arrays are (0, 0), not bbox.start, as is the case for projection.

This may be an approximation or absent if projection is not naturally representable as a FITS WCS.

local#: A proxy object for slicing a generalized image using “local” or “array” pixel coordinates.

Notes#

In this convention, the first row and column of the pixel grid is always at (0, 0). This is also the convention used by astropy.wcs objects. When a subimage is created from a parent image, its “local” coordinate system is offset from the coordinate systems of the parent image.

Note that most lsst.images types (e.g. Box, Projection, PointSpreadFunction) operate instead in “absolute” coordinates, which is shared by subimage and their parents.

See Also#

lsst.images.BoxSliceFactory lsst.images.IntervalSliceFactory

metadata#: Arbitrary flexible metadata associated with the image (dict).

Notes#

Metadata is shared with subimages and other views. It can be disconnected by reassigning to a copy explicitly:

image.metadata = image.metadata.copy()

projection#: The projection that maps this image’s pixel grid to the sky (Projection | None).

Notes#

The pixel coordinates used by this projection account for the bounding box start; they are not just array indices.

Methods Documentation

abstract copy() → Self#

Deep-copy the image and metadata.

Attached immutable objects (like Projection instances) are not copied.