LSST Applications 27.0.0,g0265f82a02+469cd937ee,g02d81e74bb+21ad69e7e1,g1470d8bcf6+cbe83ee85a,g2079a07aa2+e67c6346a6,g212a7c68fe+04a9158687,g2305ad1205+94392ce272,g295015adf3+81dd352a9d,g2bbee38e9b+469cd937ee,g337abbeb29+469cd937ee,g3939d97d7f+72a9f7b576,g487adcacf7+71499e7cba,g50ff169b8f+5929b3527e,g52b1c1532d+a6fc98d2e7,g591dd9f2cf+df404f777f,g5a732f18d5+be83d3ecdb,g64a986408d+21ad69e7e1,g858d7b2824+21ad69e7e1,g8a8a8dda67+a6fc98d2e7,g99cad8db69+f62e5b0af5,g9ddcbc5298+d4bad12328,ga1e77700b3+9c366c4306,ga8c6da7877+71e4819109,gb0e22166c9+25ba2f69a1,gb6a65358fc+469cd937ee,gbb8dafda3b+69d3c0e320,gc07e1c2157+a98bf949bb,gc120e1dc64+615ec43309,gc28159a63d+469cd937ee,gcf0d15dbbd+72a9f7b576,gdaeeff99f8+a38ce5ea23,ge6526c86ff+3a7c1ac5f1,ge79ae78c31+469cd937ee,gee10cc3b42+a6fc98d2e7,gf1cff7945b+21ad69e7e1,gfbcc870c63+9a11dc8c8f
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.