LSST Applications
21.0.0-147-g0e635eb1+1acddb5be5,22.0.0+052faf71bd,22.0.0+1ea9a8b2b2,22.0.0+6312710a6c,22.0.0+729191ecac,22.0.0+7589c3a021,22.0.0+9f079a9461,22.0.1-1-g7d6de66+b8044ec9de,22.0.1-1-g87000a6+536b1ee016,22.0.1-1-g8e32f31+6312710a6c,22.0.1-10-gd060f87+016f7cdc03,22.0.1-12-g9c3108e+df145f6f68,22.0.1-16-g314fa6d+c825727ab8,22.0.1-19-g93a5c75+d23f2fb6d8,22.0.1-19-gb93eaa13+aab3ef7709,22.0.1-2-g8ef0a89+b8044ec9de,22.0.1-2-g92698f7+9f079a9461,22.0.1-2-ga9b0f51+052faf71bd,22.0.1-2-gac51dbf+052faf71bd,22.0.1-2-gb66926d+6312710a6c,22.0.1-2-gcb770ba+09e3807989,22.0.1-20-g32debb5+b8044ec9de,22.0.1-23-gc2439a9a+fb0756638e,22.0.1-3-g496fd5d+09117f784f,22.0.1-3-g59f966b+1e6ba2c031,22.0.1-3-g849a1b8+f8b568069f,22.0.1-3-gaaec9c0+c5c846a8b1,22.0.1-32-g5ddfab5d3+60ce4897b0,22.0.1-4-g037fbe1+64e601228d,22.0.1-4-g8623105+b8044ec9de,22.0.1-5-g096abc9+d18c45d440,22.0.1-5-g15c806e+57f5c03693,22.0.1-7-gba73697+57f5c03693,master-g6e05de7fdc+c1283a92b8,master-g72cdda8301+729191ecac,w.2021.39
LSST Data Management Base Package
|
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... | |
int | readSerializationVersion () |
Read the serialization version number from the header. 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< FilterLabel > | readFilterLabel () |
Read the Exposure's filter information. 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::shared_ptr< typehandling::Storable > | readComponent (std::string const &componentName) |
Read an arbitrary non-standard component by name. 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 480 of file ExposureFitsReader.cc.
|
explicit |
Construct a FITS reader object.
manager | Memory block containing a FITS file. |
Definition at line 482 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 484 of file ExposureFitsReader.cc.
|
delete |
|
delete |
|
defaultnoexcept |
|
inline |
Return the name of the file this reader targets.
Definition at line 290 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 718 of file ExposureFitsReader.cc.
std::shared_ptr< ApCorrMap > lsst::afw::image::ExposureFitsReader::readApCorrMap | ( | ) |
Read the Exposure's aperture correction map.
Definition at line 560 of file ExposureFitsReader.cc.
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 488 of file ExposureFitsReader.cc.
std::shared_ptr< CoaddInputs > lsst::afw::image::ExposureFitsReader::readCoaddInputs | ( | ) |
Read the Exposure's coadd input catalogs.
Definition at line 565 of file ExposureFitsReader.cc.
std::shared_ptr< typehandling::Storable > lsst::afw::image::ExposureFitsReader::readComponent | ( | std::string const & | componentName | ) |
Read an arbitrary non-standard component by name.
Definition at line 586 of file ExposureFitsReader.cc.
std::shared_ptr< cameraGeom::Detector > lsst::afw::image::ExposureFitsReader::readDetector | ( | ) |
Read the Exposure's detector.
Definition at line 581 of file ExposureFitsReader.cc.
std::shared_ptr< ExposureInfo > lsst::afw::image::ExposureFitsReader::readExposureInfo | ( | ) |
Read the ExposureInfo containing all non-image components.
Definition at line 596 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 591 of file ExposureFitsReader.cc.
Filter lsst::afw::image::ExposureFitsReader::readFilter | ( | ) |
Read the Exposure's filter.
Definition at line 521 of file ExposureFitsReader.cc.
std::shared_ptr< FilterLabel > lsst::afw::image::ExposureFitsReader::readFilterLabel | ( | ) |
Read the Exposure's filter information.
Definition at line 531 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 673 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 679 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 501 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 685 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 691 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 503 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 710 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 507 of file ExposureFitsReader.cc.
std::shared_ptr< PhotoCalib > lsst::afw::image::ExposureFitsReader::readPhotoCalib | ( | ) |
Read the Exposure's photometric calibration.
Definition at line 540 of file ExposureFitsReader.cc.
std::shared_ptr< detection::Psf > lsst::afw::image::ExposureFitsReader::readPsf | ( | ) |
int lsst::afw::image::ExposureFitsReader::readSerializationVersion | ( | ) |
Read the serialization version number from the header.
Definition at line 496 of file ExposureFitsReader.cc.
std::shared_ptr< TransmissionCurve > lsst::afw::image::ExposureFitsReader::readTransmissionCurve | ( | ) |
Read the Exposure's transmission curve.
Definition at line 575 of file ExposureFitsReader.cc.
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 554 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 697 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 703 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 505 of file ExposureFitsReader.cc.
std::shared_ptr< VisitInfo > lsst::afw::image::ExposureFitsReader::readVisitInfo | ( | ) |
Read the Exposure's visit metadata.
Definition at line 570 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 492 of file ExposureFitsReader.cc.