LSST Applications g02d81e74bb+86cf3d8bc9,g180d380827+7a4e862ed4,g2079a07aa2+86d27d4dc4,g2305ad1205+e1ca1c66fa,g29320951ab+012e1474a1,g295015adf3+341ea1ce94,g2bbee38e9b+0e5473021a,g337abbeb29+0e5473021a,g33d1c0ed96+0e5473021a,g3a166c0a6a+0e5473021a,g3ddfee87b4+c429d67c83,g48712c4677+f88676dd22,g487adcacf7+27e1e21933,g50ff169b8f+96c6868917,g52b1c1532d+585e252eca,g591dd9f2cf+b41db86c35,g5a732f18d5+53520f316c,g64a986408d+86cf3d8bc9,g858d7b2824+86cf3d8bc9,g8a8a8dda67+585e252eca,g99cad8db69+84912a7fdc,g9ddcbc5298+9a081db1e4,ga1e77700b3+15fc3df1f7,ga8c6da7877+a2b54eae19,gb0e22166c9+60f28cb32d,gba4ed39666+c2a2e4ac27,gbb8dafda3b+6681f309db,gc120e1dc64+f0fcc2f6d8,gc28159a63d+0e5473021a,gcf0d15dbbd+c429d67c83,gdaeeff99f8+f9a426f77a,ge6526c86ff+0433e6603d,ge79ae78c31+0e5473021a,gee10cc3b42+585e252eca,gff1a9f87cc+86cf3d8bc9,w.2024.17
LSST Data Management Base Package
|
A FITS reader class for MaskedImages and their components. More...
#include <MaskedImageFitsReader.h>
Public Member Functions | |
MaskedImageFitsReader (std::string const &fileName, int hdu=fits::DEFAULT_HDU) | |
Construct a FITS reader object. | |
MaskedImageFitsReader (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU) | |
Construct a FITS reader object. | |
MaskedImageFitsReader (fits::Fits *fitsFile) | |
Construct a FITS reader object. | |
MaskedImageFitsReader (MaskedImageFitsReader const &)=delete | |
MaskedImageFitsReader (MaskedImageFitsReader &&)=delete | |
MaskedImageFitsReader & | operator= (MaskedImageFitsReader const &)=delete |
MaskedImageFitsReader & | operator= (MaskedImageFitsReader &&)=delete |
~MaskedImageFitsReader () noexcept | |
lsst::geom::Box2I | readBBox (ImageOrigin origin=PARENT) |
Read the bounding box of the on-disk image. | |
lsst::geom::Point2I | readXY0 (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT) |
Read the image origin from the on-disk image or a subimage thereof. | |
template<typename MaskPixelT > | |
Mask< MaskPixelT > | readMask (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool conformMasks=false, bool allowUnsafe=false) |
Read the mask plane. | |
template<typename MaskPixelT > | |
ndarray::Array< MaskPixelT, 2, 2 > | readMaskArray (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the mask plane. | |
template<typename ImagePixelT , typename MaskPixelT = MaskPixel, typename VariancePixelT = VariancePixel> | |
MaskedImage< ImagePixelT, MaskPixelT, VariancePixelT > | read (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool conformMasks=false, bool needAllHdus=false, bool allowUnsafe=false) |
Read the full MaskedImage. | |
std::string | getFileName () const |
Return the name of the file this reader targets. | |
std::string | readImageDType () const |
Read a string describing the pixel type of the on-disk image plane. | |
std::string | readMaskDType () const |
Read a string describing the pixel type of the on-disk image plane. | |
std::string | readVarianceDType () const |
Read a string describing the pixel type of the on-disk image plane. | |
std::shared_ptr< daf::base::PropertyList > | readPrimaryMetadata () |
Read the FITS header of one of the HDUs. | |
std::shared_ptr< daf::base::PropertyList > | readImageMetadata () |
Read the FITS header of one of the HDUs. | |
std::shared_ptr< daf::base::PropertyList > | readMaskMetadata () |
Read the FITS header of one of the HDUs. | |
std::shared_ptr< daf::base::PropertyList > | readVarianceMetadata () |
Read the FITS header of one of the HDUs. | |
template<typename ImagePixelT > | |
Image< ImagePixelT > | readImage (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the image plane. | |
template<typename ImagePixelT > | |
ndarray::Array< ImagePixelT, 2, 2 > | readImageArray (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the image plane. | |
template<typename VariancePixelT > | |
Image< VariancePixelT > | readVariance (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the variance plane. | |
template<typename VariancePixelT > | |
ndarray::Array< VariancePixelT, 2, 2 > | readVarianceArray (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the variance plane. | |
Friends | |
class | ExposureFitsReader |
A FITS reader class for MaskedImages and their components.
Definition at line 41 of file MaskedImageFitsReader.h.
|
explicit |
Construct a FITS reader object.
fileName | Name of a file to open. |
hdu | HDU index for the image plane, where 0 is the primary HDU and DEFAULT_HDU is the first non-empty HDU. |
Definition at line 46 of file MaskedImageFitsReader.cc.
|
explicit |
Construct a FITS reader object.
manager | Memory block containing a FITS file. |
hdu | HDU index for the image plane, where 0 is the primary HDU and DEFAULT_HDU is the first non-empty HDU. |
Definition at line 52 of file MaskedImageFitsReader.cc.
|
explicit |
Construct a FITS reader object.
fitsFile | Pointer to a CFITSIO file object. Lifetime will not be managed by the Reader object. |
Definition at line 58 of file MaskedImageFitsReader.cc.
|
delete |
|
delete |
|
defaultnoexcept |
|
inline |
Return the name of the file this reader targets.
Definition at line 230 of file MaskedImageFitsReader.h.
|
delete |
|
delete |
template MaskedImage< std::uint64_t, MaskPixel, VariancePixel > lsst::afw::image::MaskedImageFitsReader::read | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | conformMasks = false, | ||
bool | needAllHdus = false, | ||
bool | allowUnsafe = false ) |
Read the full MaskedImage.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
conformMasks | If True, conform the global mask dict to match this file. |
needAllHdus | If True, refuse to read the image if the mask or variance plane is not present (the image plane is always required). |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read (for the image plane). This defaults to the type of the on-disk image.
Definition at line 170 of file MaskedImageFitsReader.cc.
lsst::geom::Box2I lsst::afw::image::MaskedImageFitsReader::readBBox | ( | ImageOrigin | origin = PARENT | ) |
Read the bounding box of the on-disk image.
origin | Coordinate system convention for the returned box. If LOCAL, the returned box will always have a minimum of (0, 0). |
Definition at line 72 of file MaskedImageFitsReader.cc.
template Image< std::uint64_t > lsst::afw::image::MaskedImageFitsReader::readImage | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | allowUnsafe = false ) |
Read the image plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 131 of file MaskedImageFitsReader.cc.
template ndarray::Array< std::uint64_t, 2, 2 > lsst::afw::image::MaskedImageFitsReader::readImageArray | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | allowUnsafe = false ) |
Read the image plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 137 of file MaskedImageFitsReader.cc.
std::string lsst::afw::image::MaskedImageFitsReader::readImageDType | ( | ) | const |
Read a string describing the pixel type of the on-disk image plane.
[u](int|float)<bits>
(e.g. "uint16", "float64"). Definition at line 66 of file MaskedImageFitsReader.cc.
std::shared_ptr< daf::base::PropertyList > lsst::afw::image::MaskedImageFitsReader::readImageMetadata | ( | ) |
Read the FITS header of one of the HDUs.
Definition at line 106 of file MaskedImageFitsReader.cc.
template Mask< MaskPixel > lsst::afw::image::MaskedImageFitsReader::readMask | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | conformMasks = false, | ||
bool | allowUnsafe = false ) |
Read the mask plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
conformMasks | If True, conform the global mask dict to match this file. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 144 of file MaskedImageFitsReader.cc.
template ndarray::Array< MaskPixel, 2, 2 > lsst::afw::image::MaskedImageFitsReader::readMaskArray | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | allowUnsafe = false ) |
Read the mask plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 150 of file MaskedImageFitsReader.cc.
std::string lsst::afw::image::MaskedImageFitsReader::readMaskDType | ( | ) | const |
Read a string describing the pixel type of the on-disk image plane.
[u](int|float)<bits>
(e.g. "uint16", "float64"). Definition at line 68 of file MaskedImageFitsReader.cc.
std::shared_ptr< daf::base::PropertyList > lsst::afw::image::MaskedImageFitsReader::readMaskMetadata | ( | ) |
Read the FITS header of one of the HDUs.
Definition at line 114 of file MaskedImageFitsReader.cc.
std::shared_ptr< daf::base::PropertyList > lsst::afw::image::MaskedImageFitsReader::readPrimaryMetadata | ( | ) |
Read the FITS header of one of the HDUs.
Definition at line 100 of file MaskedImageFitsReader.cc.
template Image< VariancePixel > lsst::afw::image::MaskedImageFitsReader::readVariance | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | allowUnsafe = false ) |
Read the variance plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 157 of file MaskedImageFitsReader.cc.
template ndarray::Array< VariancePixel, 2, 2 > lsst::afw::image::MaskedImageFitsReader::readVarianceArray | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT, | ||
bool | allowUnsafe = false ) |
Read the variance plane.
bbox | A bounding box used to defined a subimage, or an empty box (default) to read the whole image. |
origin | Coordinate system convention for the given box. |
allowUnsafe | Permit reading into the requested pixel type even when on-disk values may overflow or truncate. |
In Python, this templated method is wrapped with an additional dtype
argument to provide the type to read. This defaults to the type of the on-disk image.
Definition at line 163 of file MaskedImageFitsReader.cc.
std::string lsst::afw::image::MaskedImageFitsReader::readVarianceDType | ( | ) | const |
Read a string describing the pixel type of the on-disk image plane.
[u](int|float)<bits>
(e.g. "uint16", "float64"). Definition at line 70 of file MaskedImageFitsReader.cc.
std::shared_ptr< daf::base::PropertyList > lsst::afw::image::MaskedImageFitsReader::readVarianceMetadata | ( | ) |
Read the FITS header of one of the HDUs.
Definition at line 122 of file MaskedImageFitsReader.cc.
lsst::geom::Point2I lsst::afw::image::MaskedImageFitsReader::readXY0 | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I(), |
ImageOrigin | origin = PARENT ) |
Read the image origin from the on-disk image or a subimage thereof.
bbox | A bounding box used to defined a subimage, or an empty box (default) to use the whole image. |
origin | Coordinate system convention for the given box. Ignored if bbox is empty. |
Definition at line 76 of file MaskedImageFitsReader.cc.
|
friend |
Definition at line 234 of file MaskedImageFitsReader.h.