LSSTApplications  21.0.0+1b62c9342b,21.0.0+45a059f35e,21.0.0-1-ga51b5d4+ceb9cf20a3,21.0.0-10-g68cce58c5+c7d3cce47e,21.0.0-2-g103fe59+c1ca725317,21.0.0-2-g1367e85+a1c2f7fe71,21.0.0-2-g2909d54+45a059f35e,21.0.0-2-g45278ab+1b62c9342b,21.0.0-2-g4bc9b9f+b2e40a4e47,21.0.0-2-g5242d73+a1c2f7fe71,21.0.0-2-g54e2caa+c00cf99ed0,21.0.0-2-g66bcc37+27b9d7859a,21.0.0-2-g7f82c8f+203cf74700,21.0.0-2-g8dde007+b0df52bfdd,21.0.0-2-g8f08a60+73884b2cf5,21.0.0-2-ga326454+203cf74700,21.0.0-2-ga63a54e+eec04437aa,21.0.0-2-gc738bc1+59028256f4,21.0.0-2-gde069b7+5a8f2956b8,21.0.0-2-ge17e5af+a1c2f7fe71,21.0.0-2-ge712728+9ad031c87e,21.0.0-2-gecfae73+d3766aec80,21.0.0-2-gfc62afb+a1c2f7fe71,21.0.0-20-g4449a12+38dfb87bce,21.0.0-22-gf0532904+afb8e7912b,21.0.0-3-g4c5b185+a403cb96fd,21.0.0-3-g6d51c4a+27b9d7859a,21.0.0-3-g8076721+e873df194c,21.0.0-3-gaa929c8+df5d87f43a,21.0.0-3-gd222c45+afc8332dbe,21.0.0-4-g1383c07+27b9d7859a,21.0.0-4-g3300ddd+1b62c9342b,21.0.0-4-g5873dc9+9a92674037,21.0.0-4-g8a80011+f67daf2f53,21.0.0-5-gcff38f6+bce43c5818,21.0.0-6-g463d161+44134145d4,21.0.0-6-gd3283ba+df5d87f43a,21.0.0-8-g19111d86+d6551531e4,w.2021.04
LSSTDataManagementBasePackage
Angle.h
Go to the documentation of this file.
1 /*
2  * LSST Data Management System
3  * Copyright 2014-2015 AURA/LSST.
4  *
5  * This product includes software developed by the
6  * LSST Project (http://www.lsst.org/).
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the LSST License Statement and
19  * the GNU General Public License along with this program. If not,
20  * see <https://www.lsstcorp.org/LegalNotices/>.
21  */
22 
23 #ifndef LSST_SPHGEOM_ANGLE_H_
24 #define LSST_SPHGEOM_ANGLE_H_
25 
28 
29 #include <cmath>
30 #include <algorithm>
31 #include <iosfwd>
32 #include <limits>
33 
34 #include "constants.h"
35 
36 
37 namespace lsst {
38 namespace sphgeom {
39 
43 class Angle {
44 public:
45  static Angle nan() {
47  }
48 
49  static Angle fromDegrees(double a) { return Angle(a * RAD_PER_DEG); }
50 
51  static Angle fromRadians(double a) { return Angle(a); }
52 
54  Angle() : _rad(0.0) {}
55 
57  explicit Angle(double a) : _rad(a) {}
58 
59  // Comparison operators
60  bool operator==(Angle const & a) const { return _rad == a._rad; }
61  bool operator!=(Angle const & a) const { return _rad != a._rad; }
62  bool operator<(Angle const & a) const { return _rad < a._rad; }
63  bool operator>(Angle const & a) const { return _rad > a._rad; }
64  bool operator<=(Angle const & a) const { return _rad <= a._rad; }
65  bool operator>=(Angle const & a) const { return _rad >= a._rad; }
66 
67  // Arithmetic operators
68  Angle operator-() const { return Angle(-_rad); }
69  Angle operator+(Angle const & a) const { return Angle(_rad + a._rad); }
70  Angle operator-(Angle const & a) const { return Angle(_rad - a._rad); }
71  Angle operator*(double a) const { return Angle(_rad * a); }
72  Angle operator/(double a) const { return Angle(_rad / a); }
73  double operator/(Angle const & a) const { return _rad / a._rad; }
74 
75  // In-place arithmetic operators
76  Angle & operator+=(Angle const & a) { *this = *this + a; return *this; }
77  Angle & operator-=(Angle const & a) { *this = *this - a; return *this; }
78  Angle & operator*=(double a) { *this = *this * a; return *this; }
79  Angle & operator/=(double a) { *this = *this / a; return *this; }
80 
82  double asDegrees() const { return _rad * DEG_PER_RAD; }
83 
85  double asRadians() const { return _rad; }
86 
88  bool isNormalized() const { return _rad >= 0.0 && _rad <= 2.0 * PI; }
89 
91  bool isNan() const { return std::isnan(_rad); }
92 
93 private:
94  double _rad;
95 };
96 
97 
98 inline Angle operator*(double a, Angle const & b) { return b * a; }
99 
101 
102 inline double sin(Angle const & a) { return std::sin(a.asRadians()); }
103 inline double cos(Angle const & a) { return std::cos(a.asRadians()); }
104 inline double tan(Angle const & a) { return std::tan(a.asRadians()); }
105 
106 inline Angle abs(Angle const & a) { return Angle(std::fabs(a.asRadians())); }
107 
108 }} // namespace lsst::sphgeom
109 
110 #endif // LSST_SPHGEOM_ANGLE_H_
lsst::sphgeom::Angle::operator/
double operator/(Angle const &a) const
Definition: Angle.h:73
std::tan
T tan(T... args)
lsst::sphgeom::Angle::operator*=
Angle & operator*=(double a)
Definition: Angle.h:78
lsst::sphgeom::sin
double sin(Angle const &a)
Definition: Angle.h:102
lsst::sphgeom::PI
constexpr double PI
Definition: constants.h:36
std::fabs
T fabs(T... args)
lsst::sphgeom::Angle::Angle
Angle()
This constructor creates an Angle with a value of zero.
Definition: Angle.h:54
lsst::sphgeom::Angle::operator+
Angle operator+(Angle const &a) const
Definition: Angle.h:69
lsst::sphgeom::Angle::operator<
bool operator<(Angle const &a) const
Definition: Angle.h:62
lsst::sphgeom::Angle::asRadians
double asRadians() const
asRadians returns the value of this angle in units of radians.
Definition: Angle.h:85
std::cos
T cos(T... args)
lsst::sphgeom::Angle::isNan
bool isNan() const
isNan returns true if the angle value is NaN.
Definition: Angle.h:91
lsst::sphgeom::abs
Angle abs(Angle const &a)
Definition: Angle.h:106
lsst::sphgeom::Angle::operator*
Angle operator*(double a) const
Definition: Angle.h:71
lsst::sphgeom::Angle::operator-
Angle operator-(Angle const &a) const
Definition: Angle.h:70
lsst::sphgeom::RAD_PER_DEG
constexpr double RAD_PER_DEG
Definition: constants.h:38
lsst::sphgeom::Angle::nan
static Angle nan()
Definition: Angle.h:45
std::isnan
T isnan(T... args)
lsst::sphgeom::Angle::operator>
bool operator>(Angle const &a) const
Definition: Angle.h:63
lsst::afw::table::Angle
lsst::geom::Angle Angle
Definition: misc.h:33
lsst::sphgeom::Angle::operator!=
bool operator!=(Angle const &a) const
Definition: Angle.h:61
std::ostream
STL class.
lsst::sphgeom::Angle::operator+=
Angle & operator+=(Angle const &a)
Definition: Angle.h:76
lsst::sphgeom::tan
double tan(Angle const &a)
Definition: Angle.h:104
lsst::sphgeom::Angle::isNormalized
bool isNormalized() const
isNormalized returns true if this angle lies in the range [0, 2π).
Definition: Angle.h:88
lsst::sphgeom::Angle::fromRadians
static Angle fromRadians(double a)
Definition: Angle.h:51
lsst::sphgeom::Angle::operator-=
Angle & operator-=(Angle const &a)
Definition: Angle.h:77
lsst::sphgeom::Angle::operator-
Angle operator-() const
Definition: Angle.h:68
lsst::sphgeom::Angle::operator>=
bool operator>=(Angle const &a) const
Definition: Angle.h:65
b
table::Key< int > b
Definition: TransmissionCurve.cc:467
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
std::sin
T sin(T... args)
lsst::sphgeom::DEG_PER_RAD
constexpr double DEG_PER_RAD
Definition: constants.h:39
lsst::sphgeom::Angle::Angle
Angle(double a)
This constructor creates an Angle with the given value in radians.
Definition: Angle.h:57
lsst::sphgeom::operator*
Angle operator*(double a, Angle const &b)
Definition: Angle.h:98
a
table::Key< int > a
Definition: TransmissionCurve.cc:466
lsst::sphgeom::Angle::asDegrees
double asDegrees() const
asDegrees returns the value of this angle in units of degrees.
Definition: Angle.h:82
lsst::sphgeom::Angle::operator==
bool operator==(Angle const &a) const
Definition: Angle.h:60
lsst::sphgeom::Angle::operator<=
bool operator<=(Angle const &a) const
Definition: Angle.h:64
lsst::sphgeom::Angle
Angle represents an angle in radians.
Definition: Angle.h:43
constants.h
This file contains common constants.
lsst::sphgeom::operator<<
std::ostream & operator<<(std::ostream &, Angle const &)
Definition: Angle.cc:34
lsst::sphgeom::Angle::fromDegrees
static Angle fromDegrees(double a)
Definition: Angle.h:49
std::numeric_limits
lsst::sphgeom::Angle::operator/=
Angle & operator/=(double a)
Definition: Angle.h:79
lsst::sphgeom::Angle::operator/
Angle operator/(double a) const
Definition: Angle.h:72
lsst::sphgeom::cos
double cos(Angle const &a)
Definition: Angle.h:103