LSSTApplications  20.0.0
LSSTDataManagementBasePackage
Observatory.h
Go to the documentation of this file.
1 // -*- lsst-c++ -*-
2 
3 /*
4  * LSST Data Management System
5  * Copyright 2008-2016 LSST Corporation.
6  *
7  * This product includes software developed by the
8  * LSST Project (http://www.lsst.org/).
9  *
10  * This program is free software: you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation, either version 3 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the LSST License Statement and
21  * the GNU General Public License along with this program. If not,
22  * see <http://www.lsstcorp.org/LegalNotices/>.
23  */
24 
25 #if !defined(LSST_AFW_COORD_OBSERVATORY_H)
26 #define LSST_AFW_COORD_OBSERVATORY_H
27 /*
28  * Class to hold observatory/telescope location
29  */
30 
31 #include <iostream>
32 
33 #include "lsst/utils/hashCombine.h"
34 #include "lsst/geom/Angle.h"
35 
36 namespace lsst {
37 namespace afw {
38 namespace coord {
39 
43 class Observatory final {
44 public:
53 
63 
64  ~Observatory() noexcept;
65  Observatory(Observatory const&) noexcept;
66  Observatory(Observatory&&) noexcept;
67  Observatory& operator=(Observatory const&) noexcept;
68  Observatory& operator=(Observatory&&) noexcept;
69 
71  void setLongitude(lsst::geom::Angle const longitude);
73  void setLatitude(lsst::geom::Angle const latitude);
75  void setElevation(double const elevation);
76 
78  lsst::geom::Angle getLongitude() const noexcept;
80  lsst::geom::Angle getLatitude() const noexcept;
82  double getElevation() const noexcept { return _elevation; }
83 
85  std::string toString() const;
86 
87  bool operator==(Observatory const& rhs) const noexcept {
88  auto deltaLongitude = (_latitude - rhs.getLatitude()).wrapCtr();
89  auto deltaLatitude = (_longitude - rhs.getLongitude()).wrapCtr();
90  return (deltaLongitude == 0.0 * lsst::geom::degrees) &&
91  (deltaLatitude == 0.0 * lsst::geom::degrees) && ((_elevation - rhs._elevation) == 0.0);
92  }
93  bool operator!=(Observatory const& rhs) const noexcept { return !(*this == rhs); }
94 
96  std::size_t hash_value() const noexcept {
97  // Completely arbitrary seed
98  return utils::hashCombine(17, _latitude.wrapCtr(), _longitude.wrapCtr(), _elevation);
99  }
100 
101 private:
102  lsst::geom::Angle _latitude;
103  lsst::geom::Angle _longitude;
104  double _elevation;
105 };
106 
113 std::ostream& operator<<(std::ostream& os, Observatory const& obs);
114 } // namespace coord
115 } // namespace afw
116 } // namespace lsst
117 
118 namespace std {
119 template <>
120 struct hash<lsst::afw::coord::Observatory> {
123  size_t operator()(argument_type const& obj) const noexcept { return obj.hash_value(); }
124 };
125 } // namespace std
126 
127 #endif
lsst::geom::degrees
constexpr AngleUnit degrees
constant with units of degrees
Definition: Angle.h:109
lsst::afw::coord::Observatory::getLongitude
lsst::geom::Angle getLongitude() const noexcept
get telescope longitude (positive values are E of Greenwich)
Definition: Observatory.cc:48
lsst::afw::coord::Observatory::setElevation
void setElevation(double const elevation)
set telescope elevation (meters above reference spheroid)
Definition: Observatory.cc:56
lsst::geom::Angle::wrapCtr
Angle wrapCtr() const noexcept
Wrap this angle to the range [-π, π).
Definition: Angle.h:412
std::string
STL class.
lsst::afw::coord::Observatory::~Observatory
~Observatory() noexcept
lsst::afw::coord::Observatory::hash_value
std::size_t hash_value() const noexcept
Return a hash of this object.
Definition: Observatory.h:96
lsst::afw::coord::Observatory::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.
Definition: Observatory.cc:37
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::coord::Observatory::toString
std::string toString() const
get string representation
Definition: Observatory.cc:58
std::hash< lsst::afw::coord::Observatory >::operator()
size_t operator()(argument_type const &obj) const noexcept
Definition: Observatory.h:123
lsst::afw::coord::Observatory::getElevation
double getElevation() const noexcept
get telescope elevation (meters above reference spheroid)
Definition: Observatory.h:82
elevation
table::Key< double > elevation
Definition: VisitInfo.cc:173
hashCombine.h
lsst::afw::table::Angle
lsst::geom::Angle Angle
Definition: misc.h:33
Angle.h
lsst::afw::coord::Observatory::operator==
bool operator==(Observatory const &rhs) const noexcept
Definition: Observatory.h:87
std::ostream
STL class.
lsst::afw::coord::Observatory::getLatitude
lsst::geom::Angle getLatitude() const noexcept
get telescope latitude
Definition: Observatory.cc:50
lsst::afw::coord::Observatory
Hold the location of an observatory.
Definition: Observatory.h:43
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
lsst::geom
Definition: geomOperators.dox:4
os
std::ostream * os
Definition: Schema.cc:746
lsst::utils::hashCombine
std::size_t hashCombine(std::size_t seed) noexcept
Combine hashes.
Definition: hashCombine.h:35
std
STL namespace.
lsst::afw::coord::operator<<
std::ostream & operator<<(std::ostream &os, Observatory const &obs)
Print an Observatory to the stream.
Definition: Observatory.cc:64
lsst::afw::coord::Observatory::Observatory
Observatory(std::string const &longitude, std::string const &latitude, double const elevation)
Construct an Observatory with longitude and latitude specified as sexagesimal strings.
lsst::geom::Angle
A class representing an angle.
Definition: Angle.h:127
lsst::afw::coord::Observatory::operator!=
bool operator!=(Observatory const &rhs) const noexcept
Definition: Observatory.h:93
std::size_t
longitude
table::Key< lsst::geom::Angle > longitude
Definition: VisitInfo.cc:172
latitude
table::Key< lsst::geom::Angle > latitude
Definition: VisitInfo.cc:171
lsst::afw::coord::Observatory::setLatitude
void setLatitude(lsst::geom::Angle const latitude)
set telescope latitude (positive values are E of Greenwich)
Definition: Observatory.cc:52
lsst::afw::coord::Observatory::setLongitude
void setLongitude(lsst::geom::Angle const longitude)
set telescope longitude
Definition: Observatory.cc:54
std::hash