LSSTApplications
18.0.0+106,18.0.0+50,19.0.0,19.0.0+1,19.0.0+10,19.0.0+11,19.0.0+13,19.0.0+17,19.0.0+2,19.0.0-1-g20d9b18+6,19.0.0-1-g425ff20,19.0.0-1-g5549ca4,19.0.0-1-g580fafe+6,19.0.0-1-g6fe20d0+1,19.0.0-1-g7011481+9,19.0.0-1-g8c57eb9+6,19.0.0-1-gb5175dc+11,19.0.0-1-gdc0e4a7+9,19.0.0-1-ge272bc4+6,19.0.0-1-ge3aa853,19.0.0-10-g448f008b,19.0.0-12-g6990b2c,19.0.0-2-g0d9f9cd+11,19.0.0-2-g3d9e4fb2+11,19.0.0-2-g5037de4,19.0.0-2-gb96a1c4+3,19.0.0-2-gd955cfd+15,19.0.0-3-g2d13df8,19.0.0-3-g6f3c7dc,19.0.0-4-g725f80e+11,19.0.0-4-ga671dab3b+1,19.0.0-4-gad373c5+3,19.0.0-5-ga2acb9c+2,19.0.0-5-gfe96e6c+2,w.2020.01
LSSTDataManagementBasePackage
|
A FITS reader class for Exposures and their components. More...
#include <ExposureFitsReader.h>
Classes | |
class | ArchiveReader |
class | MetadataReader |
Public Member Functions | |
ExposureFitsReader (std::string const &fileName) | |
Construct a FITS reader object. More... | |
ExposureFitsReader (fits::MemFileManager &manager) | |
Construct a FITS reader object. More... | |
ExposureFitsReader (fits::Fits *fitsFile) | |
Construct a FITS reader object. More... | |
ExposureFitsReader (ExposureFitsReader const &)=delete | |
ExposureFitsReader (ExposureFitsReader &&)=delete | |
ExposureFitsReader & | operator= (ExposureFitsReader const &)=delete |
ExposureFitsReader & | operator= (ExposureFitsReader &&)=delete |
~ExposureFitsReader () noexcept | |
lsst::geom::Box2I | readBBox (ImageOrigin origin=PARENT) |
Read the bounding box of the on-disk image. More... | |
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. More... | |
std::shared_ptr< daf::base::PropertyList > | readMetadata () |
Read the flexible metadata associated with the Exposure. More... | |
std::shared_ptr< afw::geom::SkyWcs > | readWcs () |
Read the Exposure's world coordinate system. More... | |
Filter | readFilter () |
Read the Exposure's filter. More... | |
std::shared_ptr< PhotoCalib > | readPhotoCalib () |
Read the Exposure's photometric calibration. More... | |
std::shared_ptr< detection::Psf > | readPsf () |
Read the Exposure's point-spread function. More... | |
std::shared_ptr< afw::geom::polygon::Polygon > | readValidPolygon () |
Read the polygon describing the region of validity for the Exposure. More... | |
std::shared_ptr< ApCorrMap > | readApCorrMap () |
Read the Exposure's aperture correction map. More... | |
std::shared_ptr< CoaddInputs > | readCoaddInputs () |
Read the Exposure's coadd input catalogs. More... | |
std::shared_ptr< VisitInfo > | readVisitInfo () |
Read the Exposure's visit metadata. More... | |
std::shared_ptr< TransmissionCurve > | readTransmissionCurve () |
Read the Exposure's transmission curve. More... | |
std::shared_ptr< cameraGeom::Detector > | readDetector () |
Read the Exposure's detector. More... | |
std::map< std::string, std::shared_ptr< table::io::Persistable > > | readExtraComponents () |
Read the Exposure's non-standard components. More... | |
std::shared_ptr< ExposureInfo > | readExposureInfo () |
Read the ExposureInfo containing all non-image components. More... | |
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. More... | |
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. More... | |
template<typename ImagePixelT , typename MaskPixelT = MaskPixel, typename VariancePixelT = VariancePixel> | |
MaskedImage< ImagePixelT, MaskPixelT, VariancePixelT > | readMaskedImage (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool conformMasks=false, bool allowUnsafe=false) |
Read the MaskedImage. More... | |
template<typename ImagePixelT , typename MaskPixelT = MaskPixel, typename VariancePixelT = VariancePixel> | |
Exposure< ImagePixelT, MaskPixelT, VariancePixelT > | read (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool conformMasks=false, bool allowUnsafe=false) |
Read the full Exposure. More... | |
std::string | getFileName () const |
Return the name of the file this reader targets. More... | |
std::string | readImageDType () const |
Read a string describing the pixel type of the on-disk image plane. More... | |
std::string | readMaskDType () const |
Read a string describing the pixel type of the on-disk image plane. More... | |
std::string | readVarianceDType () const |
Read a string describing the pixel type of the on-disk image plane. More... | |
template<typename ImagePixelT > | |
Image< ImagePixelT > | readImage (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the image plane. More... | |
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. More... | |
template<typename VariancePixelT > | |
Image< VariancePixelT > | readVariance (lsst::geom::Box2I const &bbox=lsst::geom::Box2I(), ImageOrigin origin=PARENT, bool allowUnsafe=false) |
Read the variance plane. More... | |
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. More... | |
A FITS reader class for Exposures and their components.
Definition at line 42 of file ExposureFitsReader.h.
|
explicit |
Construct a FITS reader object.
fileName | Name of a file to open. |
Definition at line 263 of file ExposureFitsReader.cc.
|
explicit |
Construct a FITS reader object.
manager | Memory block containing a FITS file. |
Definition at line 265 of file ExposureFitsReader.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 267 of file ExposureFitsReader.cc.
|
delete |
|
delete |
|
defaultnoexcept |
|
inline |
Return the name of the file this reader targets.
Definition at line 274 of file ExposureFitsReader.h.
|
delete |
|
delete |
template Exposure< std::uint64_t, MaskPixel, VariancePixel > lsst::afw::image::ExposureFitsReader::read | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I() , |
ImageOrigin | origin = PARENT , |
||
bool | conformMasks = false , |
||
bool | allowUnsafe = false |
||
) |
Read the full Exposure.
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 (for the image plane). This defaults to the type of the on-disk image.
Definition at line 473 of file ExposureFitsReader.cc.
std::shared_ptr< ApCorrMap > lsst::afw::image::ExposureFitsReader::readApCorrMap | ( | ) |
lsst::geom::Box2I lsst::afw::image::ExposureFitsReader::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 271 of file ExposureFitsReader.cc.
std::shared_ptr< CoaddInputs > lsst::afw::image::ExposureFitsReader::readCoaddInputs | ( | ) |
std::shared_ptr< cameraGeom::Detector > lsst::afw::image::ExposureFitsReader::readDetector | ( | ) |
Read the Exposure's detector.
Definition at line 345 of file ExposureFitsReader.cc.
std::shared_ptr< ExposureInfo > lsst::afw::image::ExposureFitsReader::readExposureInfo | ( | ) |
Read the ExposureInfo containing all non-image components.
Definition at line 355 of file ExposureFitsReader.cc.
std::map< std::string, std::shared_ptr< table::io::Persistable > > lsst::afw::image::ExposureFitsReader::readExtraComponents | ( | ) |
Read the Exposure's non-standard components.
Definition at line 350 of file ExposureFitsReader.cc.
Filter lsst::afw::image::ExposureFitsReader::readFilter | ( | ) |
Read the Exposure's filter.
Definition at line 299 of file ExposureFitsReader.cc.
template Image< std::uint64_t > lsst::afw::image::ExposureFitsReader::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 428 of file ExposureFitsReader.cc.
template ndarray::Array< std::uint64_t, 2, 2 > lsst::afw::image::ExposureFitsReader::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 434 of file ExposureFitsReader.cc.
std::string lsst::afw::image::ExposureFitsReader::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 279 of file ExposureFitsReader.cc.
template Mask< MaskPixel > lsst::afw::image::ExposureFitsReader::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 440 of file ExposureFitsReader.cc.
template ndarray::Array< MaskPixel, 2, 2 > lsst::afw::image::ExposureFitsReader::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 446 of file ExposureFitsReader.cc.
std::string lsst::afw::image::ExposureFitsReader::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 281 of file ExposureFitsReader.cc.
template MaskedImage< std::uint64_t, MaskPixel, VariancePixel > lsst::afw::image::ExposureFitsReader::readMaskedImage | ( | lsst::geom::Box2I const & | bbox = lsst::geom::Box2I() , |
ImageOrigin | origin = PARENT , |
||
bool | conformMasks = false , |
||
bool | allowUnsafe = false |
||
) |
Read the 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. |
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 465 of file ExposureFitsReader.cc.
std::shared_ptr< daf::base::PropertyList > lsst::afw::image::ExposureFitsReader::readMetadata | ( | ) |
Read the flexible metadata associated with the Exposure.
FITS header keys used to construct other Exposure components will be stripped.
Definition at line 285 of file ExposureFitsReader.cc.
std::shared_ptr< PhotoCalib > lsst::afw::image::ExposureFitsReader::readPhotoCalib | ( | ) |
Read the Exposure's photometric calibration.
Definition at line 304 of file ExposureFitsReader.cc.
std::shared_ptr< detection::Psf > lsst::afw::image::ExposureFitsReader::readPsf | ( | ) |
std::shared_ptr< TransmissionCurve > lsst::afw::image::ExposureFitsReader::readTransmissionCurve | ( | ) |
std::shared_ptr< afw::geom::polygon::Polygon > lsst::afw::image::ExposureFitsReader::readValidPolygon | ( | ) |
Read the polygon describing the region of validity for the Exposure.
Definition at line 318 of file ExposureFitsReader.cc.
template Image< VariancePixel > lsst::afw::image::ExposureFitsReader::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 452 of file ExposureFitsReader.cc.
template ndarray::Array< VariancePixel, 2, 2 > lsst::afw::image::ExposureFitsReader::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 458 of file ExposureFitsReader.cc.
std::string lsst::afw::image::ExposureFitsReader::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 283 of file ExposureFitsReader.cc.
std::shared_ptr< VisitInfo > lsst::afw::image::ExposureFitsReader::readVisitInfo | ( | ) |
Read the Exposure's visit metadata.
Definition at line 334 of file ExposureFitsReader.cc.
std::shared_ptr< afw::geom::SkyWcs > lsst::afw::image::ExposureFitsReader::readWcs | ( | ) |
lsst::geom::Point2I lsst::afw::image::ExposureFitsReader::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 |
origin | Coordinate system convention for the given box. Ignored if bbox is empty. |
Definition at line 275 of file ExposureFitsReader.cc.