LSST Applications
21.0.0+04719a4bac,21.0.0-1-ga51b5d4+f5e6047307,21.0.0-11-g2b59f77+a9c1acf22d,21.0.0-11-ga42c5b2+86977b0b17,21.0.0-12-gf4ce030+76814010d2,21.0.0-13-g1721dae+760e7a6536,21.0.0-13-g3a573fe+768d78a30a,21.0.0-15-g5a7caf0+f21cbc5713,21.0.0-16-g0fb55c1+b60e2d390c,21.0.0-19-g4cded4ca+71a93a33c0,21.0.0-2-g103fe59+bb20972958,21.0.0-2-g45278ab+04719a4bac,21.0.0-2-g5242d73+3ad5d60fb1,21.0.0-2-g7f82c8f+8babb168e8,21.0.0-2-g8f08a60+06509c8b61,21.0.0-2-g8faa9b5+616205b9df,21.0.0-2-ga326454+8babb168e8,21.0.0-2-gde069b7+5e4aea9c2f,21.0.0-2-gecfae73+1d3a86e577,21.0.0-2-gfc62afb+3ad5d60fb1,21.0.0-25-g1d57be3cd+e73869a214,21.0.0-3-g357aad2+ed88757d29,21.0.0-3-g4a4ce7f+3ad5d60fb1,21.0.0-3-g4be5c26+3ad5d60fb1,21.0.0-3-g65f322c+e0b24896a3,21.0.0-3-g7d9da8d+616205b9df,21.0.0-3-ge02ed75+a9c1acf22d,21.0.0-4-g591bb35+a9c1acf22d,21.0.0-4-g65b4814+b60e2d390c,21.0.0-4-gccdca77+0de219a2bc,21.0.0-4-ge8a399c+6c55c39e83,21.0.0-5-gd00fb1e+05fce91b99,21.0.0-6-gc675373+3ad5d60fb1,21.0.0-64-g1122c245+4fb2b8f86e,21.0.0-7-g04766d7+cd19d05db2,21.0.0-7-gdf92d54+04719a4bac,21.0.0-8-g5674e7b+d1bd76f71f,master-gac4afde19b+a9c1acf22d,w.2021.13
LSST Data Management Base Package
|
Information about a single exposure of an imaging camera. More...
#include <VisitInfo.h>
Public Member Functions | |
VisitInfo (table::RecordId exposureId, double exposureTime, double darkTime, daf::base::DateTime const &date, double ut1, lsst::geom::Angle const &era, lsst::geom::SpherePoint const &boresightRaDec, lsst::geom::SpherePoint const &boresightAzAlt, double boresightAirmass, lsst::geom::Angle const &boresightRotAngle, RotType const &rotType, coord::Observatory const &observatory, coord::Weather const &weather, std::string const &instrumentLabel) | |
Construct a VisitInfo. More... | |
VisitInfo (daf::base::PropertySet const &metadata) | |
~VisitInfo () override=default | |
VisitInfo (VisitInfo const &)=default | |
VisitInfo (VisitInfo &&)=default | |
VisitInfo & | operator= (VisitInfo const &)=default |
VisitInfo & | operator= (VisitInfo &&)=default |
bool | operator== (VisitInfo const &other) const |
bool | operator!= (VisitInfo const &other) const |
std::size_t | hash_value () const noexcept override |
Return a hash of this object. More... | |
table::RecordId | getExposureId () const |
get exposure ID More... | |
double | getExposureTime () const |
get exposure duration (shutter open time); (sec) More... | |
double | getDarkTime () const |
get time from CCD flush to exposure readout, including shutter open time (despite the name); (sec) More... | |
daf::base::DateTime | getDate () const |
get uniform date and time at middle of exposure More... | |
double | getUt1 () const |
get UT1 (universal time) MJD date at middle of exposure More... | |
lsst::geom::Angle | getEra () const |
get earth rotation angle at middle of exposure More... | |
lsst::geom::SpherePoint | getBoresightRaDec () const |
get ICRS RA/Dec position at the boresight (and at the middle of the exposure, if it varies with time) More... | |
lsst::geom::SpherePoint | getBoresightAzAlt () const |
get refracted apparent topocentric Az/Alt position at the boresight (and at the middle of the exposure, if it varies with time) More... | |
double | getBoresightAirmass () const |
get airmass at the boresight, relative to zenith at sea level (and at the middle of the exposure, if it varies with time) More... | |
lsst::geom::Angle | getBoresightRotAngle () const |
Get rotation angle at boresight at middle of exposure. More... | |
RotType | getRotType () const |
get rotation type of boresightRotAngle More... | |
coord::Observatory | getObservatory () const |
get observatory longitude, latitude and elevation More... | |
coord::Weather | getWeather () const |
get basic weather information More... | |
bool | isPersistable () const noexcept override |
Return true if this particular object can be persisted using afw::table::io. More... | |
lsst::geom::Angle | getLocalEra () const |
lsst::geom::Angle | getBoresightHourAngle () const |
std::string | getInstrumentLabel () const |
lsst::geom::Angle | getBoresightParAngle () const |
Get parallactic angle at the boresight. More... | |
std::shared_ptr< typehandling::Storable > | cloneStorable () const override |
Create a new VisitInfo that is a copy of this one. More... | |
std::string | toString () const override |
Create a string representation of this object. More... | |
bool | equals (typehandling::Storable const &other) const noexcept override |
Compare this object to another Storable. More... | |
void | writeFits (std::string const &fileName, std::string const &mode="w") const |
Write the object to a regular FITS file. More... | |
void | writeFits (fits::MemFileManager &manager, std::string const &mode="w") const |
Write the object to a FITS image in memory. More... | |
void | writeFits (fits::Fits &fitsfile) const |
Write the object to an already-open FITS object. More... | |
Static Public Member Functions | |
static std::shared_ptr< VisitInfo > | readFits (fits::Fits &fitsfile) |
Read an object from an already open FITS object. More... | |
static std::shared_ptr< VisitInfo > | readFits (std::string const &fileName, int hdu=fits::DEFAULT_HDU) |
Read an object from a regular FITS file. More... | |
static std::shared_ptr< VisitInfo > | readFits (fits::MemFileManager &manager, int hdu=fits::DEFAULT_HDU) |
Read an object from a FITS file in memory. More... | |
static std::shared_ptr< VisitInfo > | dynamicCast (std::shared_ptr< Persistable > const &ptr) |
Dynamically cast a shared_ptr. More... | |
Protected Types | |
typedef io::OutputArchiveHandle | OutputArchiveHandle |
Protected Member Functions | |
std::string | getPersistenceName () const override |
Return the unique name used to persist this object and look up its factory. More... | |
void | write (OutputArchiveHandle &handle) const override |
Write the object to one or more catalogs. More... | |
virtual std::string | getPythonModule () const |
Return the fully-qualified Python module that should be imported to guarantee that its factory is registered. More... | |
Static Protected Member Functions | |
template<class T > | |
static bool | singleClassEquals (T const &lhs, Storable const &rhs) |
Test if a Storable is of a particular class and equal to another object. More... | |
Related Functions | |
(Note that these are not member functions.) | |
std::ostream & | operator<< (std::ostream &os, Storable const &storable) |
Output operator for Storable. More... | |
Information about a single exposure of an imaging camera.
Includes exposure duration and date, and telescope pointing and orientation.
All information is for the middle of the exposure and at the boresight (center of the focal plane). Thus for a mosaic camera VisitInfo is the same for all detectors in the mosaic.
VisitInfo is immutable.
Definition at line 68 of file VisitInfo.h.
|
protectedinherited |
Definition at line 108 of file Persistable.h.
|
inlineexplicit |
Construct a VisitInfo.
[in] | exposureId | exposure ID |
[in] | exposureTime | exposure duration (shutter open time); (sec) |
[in] | darkTime | time from CCD flush to readout, including shutter open time (despite the name); (sec) |
[in] | date | TAI (international atomic time) MJD date at middle of exposure |
[in] | ut1 | UT1 (universal time) MJD date at middle of exposure |
[in] | era | earth rotation angle at middle of exposure |
[in] | boresightRaDec | ICRS RA/Dec of boresight at middle of exposure |
[in] | boresightAzAlt | refracted apparent topocentric Az/Alt of boresight at middle of exposure |
[in] | boresightAirmass | airmass at the boresight, relative to zenith at sea level |
[in] | boresightRotAngle | rotation angle at boresight at middle of exposure; see getBoresightRotAngle for details |
[in] | rotType | rotation type |
[in] | observatory | observatory longitude, latitude and altitude |
[in] | weather | basic weather information for computing air mass |
[in] | instrumentLabel | The short name of the instrument that took this data (e.g. "HSC") |
Definition at line 90 of file VisitInfo.h.
|
explicit |
Definition at line 386 of file VisitInfo.cc.
|
overridedefault |
|
default |
|
default |
|
overridevirtual |
Create a new VisitInfo that is a copy of this one.
Reimplemented from lsst::afw::typehandling::Storable.
Definition at line 521 of file VisitInfo.cc.
|
staticinherited |
Dynamically cast a shared_ptr.
Dynamically cast a shared pointer and raise on failure.
You must provide an explicit template instantiation in the .cc file for each class that inherits from PersistableFacade. Designed to work around RTTI issues on macOS with hidden symbols;
lsst::pex::exceptions::LogicError | if the cast fails |
param[in] ptr The pointer to be cast.
lsst::pex::exceptions::TypeError | If the dynamic cast fails. |
Definition at line 218 of file Persistable.cc.
|
overridevirtualnoexcept |
Compare this object to another Storable.
*this == other
if other
is a VisitInfo; otherwise false
. Reimplemented from lsst::afw::typehandling::Storable.
Definition at line 525 of file VisitInfo.cc.
|
inline |
get airmass at the boresight, relative to zenith at sea level (and at the middle of the exposure, if it varies with time)
Definition at line 155 of file VisitInfo.h.
|
inline |
get refracted apparent topocentric Az/Alt position at the boresight (and at the middle of the exposure, if it varies with time)
Definition at line 151 of file VisitInfo.h.
lsst::geom::Angle lsst::afw::image::VisitInfo::getBoresightHourAngle | ( | ) | const |
Definition at line 505 of file VisitInfo.cc.
lsst::geom::Angle lsst::afw::image::VisitInfo::getBoresightParAngle | ( | ) | const |
Get parallactic angle at the boresight.
Equal to the angle between the North celestial pole and Zenith at the boresight. Or, the angular separation between two great circle arcs that meet at the object: One passing through the North celestial pole, and the other through zenith. For an object on the meridian the angle is zero if it is South of zenith and pi if it is North of zenith The angle is positive for objects East of the meridian, and negative for objects to the West.
Compute the parallactic angle. Defined as the angle between the North celestial pole and Zenith at the boresight.
Definition at line 507 of file VisitInfo.cc.
|
inline |
get ICRS RA/Dec position at the boresight (and at the middle of the exposure, if it varies with time)
Definition at line 147 of file VisitInfo.h.
|
inline |
Get rotation angle at boresight at middle of exposure.
The meaning of rotation angle depends on rotType. For example, if rotType
is SKY the angle is the position angle of the focal plane +Y with respect to North.
Definition at line 163 of file VisitInfo.h.
|
inline |
get time from CCD flush to exposure readout, including shutter open time (despite the name); (sec)
Definition at line 134 of file VisitInfo.h.
|
inline |
get uniform date and time at middle of exposure
Definition at line 137 of file VisitInfo.h.
|
inline |
get earth rotation angle at middle of exposure
Definition at line 143 of file VisitInfo.h.
|
inline |
|
inline |
get exposure duration (shutter open time); (sec)
Definition at line 131 of file VisitInfo.h.
|
inline |
Definition at line 182 of file VisitInfo.h.
lsst::geom::Angle lsst::afw::image::VisitInfo::getLocalEra | ( | ) | const |
Definition at line 503 of file VisitInfo.cc.
|
inline |
get observatory longitude, latitude and elevation
Definition at line 169 of file VisitInfo.h.
|
overrideprotectedvirtual |
Return the unique name used to persist this object and look up its factory.
Must be less than ArchiveIndexSchema::MAX_NAME_LENGTH characters.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 471 of file VisitInfo.cc.
|
protectedvirtualinherited |
Return the fully-qualified Python module that should be imported to guarantee that its factory is registered.
Must be less than ArchiveIndexSchema::MAX_MODULE_LENGTH characters.
Will be ignored if empty.
Reimplemented in lsst::meas::modelfit::Mixture, lsst::meas::algorithms::KernelPsf, lsst::meas::algorithms::CoaddPsf, lsst::meas::algorithms::CoaddBoundedField, lsst::afw::typehandling::StorableHelper< Base >, lsst::afw::math::TransformBoundedField, lsst::afw::math::ProductBoundedField, lsst::afw::math::PixelAreaBoundedField, lsst::afw::math::Kernel, lsst::afw::math::Function< ReturnT >, lsst::afw::math::ChebyshevBoundedField, lsst::afw::image::TransmissionCurve, lsst::afw::image::CoaddInputs, lsst::afw::geom::Transform< FromEndpoint, ToEndpoint >, lsst::afw::geom::Transform< afw::geom::Point2Endpoint, afw::geom::GenericEndpoint >, lsst::afw::geom::SkyWcs, lsst::afw::detection::GaussianPsf, lsst::afw::detection::Footprint, lsst::afw::cameraGeom::DetectorCollection, lsst::afw::image::FilterLabel, and lsst::meas::extensions::psfex::PsfexPsf.
Definition at line 36 of file Persistable.cc.
|
inline |
get rotation type of boresightRotAngle
Definition at line 166 of file VisitInfo.h.
|
inline |
get UT1 (universal time) MJD date at middle of exposure
Definition at line 140 of file VisitInfo.h.
|
inline |
|
overridevirtualnoexcept |
Return a hash of this object.
Reimplemented from lsst::afw::typehandling::Storable.
Definition at line 464 of file VisitInfo.cc.
|
inlineoverridevirtualnoexcept |
Return true if this particular object can be persisted using afw::table::io.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 174 of file VisitInfo.h.
|
inline |
Definition at line 122 of file VisitInfo.h.
bool lsst::afw::image::VisitInfo::operator== | ( | VisitInfo const & | other | ) | const |
Definition at line 454 of file VisitInfo.cc.
|
inlinestaticinherited |
Read an object from an already open FITS object.
[in] | fitsfile | FITS object to read from, already positioned at the desired HDU. |
Definition at line 183 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a FITS file in memory.
[in] | manager | Manager for the memory to read from. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 205 of file Persistable.h.
|
inlinestaticinherited |
Read an object from a regular FITS file.
[in] | fileName | Name of the file to read. |
[in] | hdu | HDU to read, where 0 is the primary. The special value of afw::fits::DEFAULT_HDU skips the primary HDU if it is empty. |
Definition at line 194 of file Persistable.h.
|
inlinestaticprotectedinherited |
Test if a Storable is of a particular class and equal to another object.
This method template simplifies implementations of equals that delegate to operator==
without supporting cross-class comparisons.
T | The class expected of the two objects to be compared. |
lhs,rhs | The objects to compare. Note that rhs need not be a T , while lhs must be. |
true
if rhs
is a T
and lhs == rhs
; false
otherwise.operator==
. Most implementations of operator==
do not throw.operator==
with both arguments of compile-time type T const&
. Its use is not recommended if there would be any ambiguity as to which operator==
gets picked by overload resolution.This method template is typically called from equals as:
bool MyType::equals(Storable const& other) const noexcept { return singleClassEquals(*this, other); }
Definition at line 151 of file Storable.h.
|
overridevirtual |
Create a string representation of this object.
Reimplemented from lsst::afw::typehandling::Storable.
Definition at line 529 of file VisitInfo.cc.
|
overrideprotectedvirtual |
Write the object to one or more catalogs.
The handle object passed to this function provides an interface for adding new catalogs and adding nested objects to the same archive (while checking for duplicates). See OutputArchiveHandle for more information.
Reimplemented from lsst::afw::table::io::Persistable.
Definition at line 473 of file VisitInfo.cc.
|
inherited |
Write the object to an already-open FITS object.
[in] | fitsfile | Open FITS object to write to. |
Definition at line 18 of file Persistable.cc.
|
inherited |
Write the object to a FITS image in memory.
[in] | manager | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 29 of file Persistable.cc.
|
inherited |
Write the object to a regular FITS file.
[in] | fileName | Name of the file to write to. |
[in] | mode | If "w", any existing file with the given name will be overwritten. If "a", new HDUs will be appended to an existing file. |
Definition at line 24 of file Persistable.cc.
|
related |
Output operator for Storable.
os | the desired output stream |
storable | the object to print |
os
UnsupportedOperationException | Thrown if storable does not have an implementation of Storable::toString. |
Definition at line 174 of file Storable.h.