LSST Applications  21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
Public Member Functions | List of all members
lsst::afw::coord::Observatory Class Referencefinal

Hold the location of an observatory. More...

#include <Observatory.h>

Public Member Functions

 Observatory (lsst::geom::Angle const longitude, lsst::geom::Angle const latitude, double const elevation)
 Construct an Observatory with longitude and latitude specified as lsst::geom::Angle. More...
 
 Observatory (std::string const &longitude, std::string const &latitude, double const elevation)
 Construct an Observatory with longitude and latitude specified as sexagesimal strings. More...
 
 ~Observatory () noexcept
 
 Observatory (Observatory const &) noexcept
 
 Observatory (Observatory &&) noexcept
 
Observatoryoperator= (Observatory const &) noexcept
 
Observatoryoperator= (Observatory &&) noexcept
 
void setLongitude (lsst::geom::Angle const longitude)
 set telescope longitude More...
 
void setLatitude (lsst::geom::Angle const latitude)
 set telescope latitude (positive values are E of Greenwich) More...
 
void setElevation (double const elevation)
 set telescope elevation (meters above reference spheroid) More...
 
lsst::geom::Angle getLongitude () const noexcept
 get telescope longitude (positive values are E of Greenwich) More...
 
lsst::geom::Angle getLatitude () const noexcept
 get telescope latitude More...
 
double getElevation () const noexcept
 get telescope elevation (meters above reference spheroid) More...
 
std::string toString () const
 get string representation More...
 
bool operator== (Observatory const &rhs) const noexcept
 
bool operator!= (Observatory const &rhs) const noexcept
 
std::size_t hash_value () const noexcept
 Return a hash of this object. More...
 

Detailed Description

Hold the location of an observatory.

Definition at line 43 of file Observatory.h.

Constructor & Destructor Documentation

◆ Observatory() [1/4]

lsst::afw::coord::Observatory::Observatory ( lsst::geom::Angle const  longitude,
lsst::geom::Angle const  latitude,
double const  elevation 
)

Construct an Observatory with longitude and latitude specified as lsst::geom::Angle.

Parameters
[in]longitudetelescope longitude (positive values are E of Greenwich)
[in]latitudetelescope latitude
[in]elevationtelescope elevation (meters above reference spheroid)

Definition at line 37 of file Observatory.cc.

39  : _latitude(latitude), _longitude(longitude), _elevation(elevation) {}
table::Key< lsst::geom::Angle > longitude
Definition: VisitInfo.cc:213
table::Key< lsst::geom::Angle > latitude
Definition: VisitInfo.cc:212
table::Key< double > elevation
Definition: VisitInfo.cc:214

◆ Observatory() [2/4]

lsst::afw::coord::Observatory::Observatory ( std::string const &  longitude,
std::string const &  latitude,
double const  elevation 
)

Construct an Observatory with longitude and latitude specified as sexagesimal strings.

Parameters
[in]longitudetelescope longitude (dd:mm:ss.s, positive values are E of Greenwich)
[in]latitudetelescope latitude (dd:mm:ss.s)
[in]elevationtelescope elevation (meters above reference spheroid)

◆ ~Observatory()

lsst::afw::coord::Observatory::~Observatory ( )
defaultnoexcept

◆ Observatory() [3/4]

lsst::afw::coord::Observatory::Observatory ( Observatory const &  )
defaultnoexcept

◆ Observatory() [4/4]

lsst::afw::coord::Observatory::Observatory ( Observatory &&  )
defaultnoexcept

Member Function Documentation

◆ getElevation()

double lsst::afw::coord::Observatory::getElevation ( ) const
inlinenoexcept

get telescope elevation (meters above reference spheroid)

Definition at line 82 of file Observatory.h.

82 { return _elevation; }

◆ getLatitude()

lsst::geom::Angle lsst::afw::coord::Observatory::getLatitude ( ) const
noexcept

get telescope latitude

Definition at line 50 of file Observatory.cc.

50 { return _latitude; }

◆ getLongitude()

lsst::geom::Angle lsst::afw::coord::Observatory::getLongitude ( ) const
noexcept

get telescope longitude (positive values are E of Greenwich)

Definition at line 48 of file Observatory.cc.

48 { return _longitude; }

◆ hash_value()

std::size_t lsst::afw::coord::Observatory::hash_value ( ) const
inlinenoexcept

Return a hash of this object.

Definition at line 103 of file Observatory.h.

103  {
104  // Completely arbitrary seed
105  return utils::hashCombine(17, _latitude.wrapCtr(), _longitude.wrapCtr(), _elevation);
106  }
Angle wrapCtr() const noexcept
Wrap this angle to the range [-π, π).
Definition: Angle.h:412
std::size_t hashCombine(std::size_t seed) noexcept
Combine hashes.
Definition: hashCombine.h:35

◆ operator!=()

bool lsst::afw::coord::Observatory::operator!= ( Observatory const &  rhs) const
inlinenoexcept

Definition at line 100 of file Observatory.h.

100 { return !(*this == rhs); }

◆ operator=() [1/2]

Observatory & lsst::afw::coord::Observatory::operator= ( Observatory &&  )
defaultnoexcept

◆ operator=() [2/2]

Observatory & lsst::afw::coord::Observatory::operator= ( Observatory const &  )
defaultnoexcept

◆ operator==()

bool lsst::afw::coord::Observatory::operator== ( Observatory const &  rhs) const
inlinenoexcept

Definition at line 87 of file Observatory.h.

87  {
88  // Observatory may be initialized to NaN values as a placeholder, or to indicate "unknown".
89  auto deltaLongitude = std::isnan(_latitude.asRadians()) && std::isnan(rhs._latitude.asRadians())
90  ? 0.0 * lsst::geom::degrees
91  : (_latitude - rhs._latitude).wrapCtr();
92  auto deltaLatitude = std::isnan(_longitude.asRadians()) && std::isnan(rhs._longitude.asRadians())
93  ? 0.0 * lsst::geom::degrees
94  : (_longitude - rhs._longitude).wrapCtr();
95  return (deltaLongitude == 0.0 * lsst::geom::degrees) &&
96  (deltaLatitude == 0.0 * lsst::geom::degrees) &&
97  ((std::isnan(_elevation) && std::isnan(rhs._elevation)) ||
98  (_elevation - rhs._elevation) == 0.0);
99  }
constexpr double asRadians() const noexcept
Return an Angle's value in radians.
Definition: Angle.h:166
T isnan(T... args)
constexpr AngleUnit degrees
constant with units of degrees
Definition: Angle.h:109

◆ setElevation()

void lsst::afw::coord::Observatory::setElevation ( double const  elevation)

set telescope elevation (meters above reference spheroid)

Definition at line 56 of file Observatory.cc.

56 { _elevation = elevation; }

◆ setLatitude()

void lsst::afw::coord::Observatory::setLatitude ( lsst::geom::Angle const  latitude)

set telescope latitude (positive values are E of Greenwich)

Definition at line 52 of file Observatory.cc.

52 { _latitude = latitude; }

◆ setLongitude()

void lsst::afw::coord::Observatory::setLongitude ( lsst::geom::Angle const  longitude)

set telescope longitude

Definition at line 54 of file Observatory.cc.

54 { _longitude = longitude; }

◆ toString()

std::string lsst::afw::coord::Observatory::toString ( ) const

get string representation

Definition at line 58 of file Observatory.cc.

58  {
59  return (boost::format("%gW, %gN %g") % getLongitude().asDegrees() % getLatitude().asDegrees() %
60  getElevation())
61  .str();
62 }
double getElevation() const noexcept
get telescope elevation (meters above reference spheroid)
Definition: Observatory.h:82
lsst::geom::Angle getLatitude() const noexcept
get telescope latitude
Definition: Observatory.cc:50
lsst::geom::Angle getLongitude() const noexcept
get telescope longitude (positive values are E of Greenwich)
Definition: Observatory.cc:48
def format(config, name=None, writeSourceLine=True, prefix="", verbose=False)
Definition: history.py:174

The documentation for this class was generated from the following files: