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
radii.h
Go to the documentation of this file.
1 // -*- lsst-c++ -*-
2 
3 /*
4  * LSST Data Management System
5  * Copyright 2008, 2009, 2010 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 #ifndef LSST_AFW_GEOM_ELLIPSES_radii_h_INCLUDED
26 #define LSST_AFW_GEOM_ELLIPSES_radii_h_INCLUDED
27 
28 /*
29  * Helper classes defining radii for Separable core.
30  *
31  * Note: do not include directly; use the main ellipse header file.
32  */
33 
36 #include <complex>
37 
38 namespace lsst {
39 namespace afw {
40 namespace geom {
41 namespace ellipses {
42 
43 template <typename Ellipticity_, typename Radius_>
44 class Separable;
45 
46 class DeterminantRadius;
47 class TraceRadius;
48 class LogDeterminantRadius;
49 class LogTraceRadius;
50 
58 public:
59  void normalize() {
60  if (_value < 0)
62  "Ellipse radius cannot be negative.");
63  }
64 
65  static std::string getName() { return "DeterminantRadius"; }
66 
67  explicit DeterminantRadius(double value = 1.0) : _value(value) {}
68 
69  explicit DeterminantRadius(LogDeterminantRadius const &other);
70 
73  ~DeterminantRadius() = default;
74 
75  operator double const &() const { return _value; }
76 
77  operator double &() { return _value; }
78 
79  DeterminantRadius &operator=(double value) {
80  _value = value;
81  return *this;
82  }
83 
87 
92 
93 private:
94  template <typename T1, typename T2>
95  friend class Separable;
96 
97  void assignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
98 
99  BaseCore::Jacobian dAssignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
100 
101  void assignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy, double &ixy) const;
102 
103  BaseCore::Jacobian dAssignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy,
104  double &ixy) const;
105 
106  double _value;
107 };
108 
115 public:
116  void normalize() {
117  if (_value < 0)
119  "Ellipse radius cannot be negative.");
120  }
121 
122  static std::string getName() { return "TraceRadius"; }
123 
124  explicit TraceRadius(double value = 1.0) : _value(value) {}
125 
126  explicit TraceRadius(LogTraceRadius const &other);
127 
128  TraceRadius(TraceRadius const &) = default;
129  TraceRadius(TraceRadius &&) = default;
130  ~TraceRadius() = default;
131 
132  operator double const &() const { return _value; }
133 
134  operator double &() { return _value; }
135 
136  TraceRadius &operator=(double value) {
137  _value = value;
138  return *this;
139  }
140 
141  TraceRadius &operator=(LogTraceRadius const &other);
142  TraceRadius &operator=(TraceRadius const &) = default;
144 
149 
150 private:
151  template <typename T1, typename T2>
152  friend class Separable;
153 
154  void assignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
155 
156  BaseCore::Jacobian dAssignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
157 
158  void assignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy, double &ixy) const;
159 
160  BaseCore::Jacobian dAssignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy,
161  double &ixy) const;
162 
163  double _value;
164 };
165 
170 public:
171  void normalize() {}
172 
173  static std::string getName() { return "LogDeterminantRadius"; }
174 
175  explicit LogDeterminantRadius(double value = 0.0) : _value(value) {}
176 
177  explicit LogDeterminantRadius(DeterminantRadius const &other);
178 
182 
183  operator double const &() const { return _value; }
184 
185  operator double &() { return _value; }
186 
188  _value = value;
189  return *this;
190  }
191 
195 
200 
201 private:
202  template <typename T1, typename T2>
203  friend class Separable;
204 
205  void assignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
206 
207  BaseCore::Jacobian dAssignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
208 
209  void assignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy, double &ixy) const;
210 
211  BaseCore::Jacobian dAssignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy,
212  double &ixy) const;
213 
214  double _value;
215 };
216 
221 public:
222  void normalize() {}
223 
224  static std::string getName() { return "LogTraceRadius"; }
225 
226  explicit LogTraceRadius(double value = 0.0) : _value(value) {}
227 
228  explicit LogTraceRadius(TraceRadius const &other);
229 
230  LogTraceRadius(LogTraceRadius const &) = default;
232  ~LogTraceRadius() = default;
233 
234  operator double const &() const { return _value; }
235 
236  operator double &() { return _value; }
237 
238  LogTraceRadius &operator=(double value) {
239  _value = value;
240  return *this;
241  }
242 
243  LogTraceRadius &operator=(TraceRadius const &value);
246 
251 
252 private:
253  template <typename T1, typename T2>
254  friend class Separable;
255 
256  void assignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
257 
258  BaseCore::Jacobian dAssignFromQuadrupole(double ixx, double iyy, double ixy, Distortion &distortion);
259 
260  void assignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy, double &ixy) const;
261 
262  BaseCore::Jacobian dAssignToQuadrupole(Distortion const &distortion, double &ixx, double &iyy,
263  double &ixy) const;
264 
265  double _value;
266 };
267 
268 inline DeterminantRadius::DeterminantRadius(LogDeterminantRadius const &other) : _value(std::exp(other)) {}
269 inline TraceRadius::TraceRadius(LogTraceRadius const &other) : _value(std::exp(other)) {}
270 inline LogDeterminantRadius::LogDeterminantRadius(DeterminantRadius const &other) : _value(std::log(other)) {}
271 inline LogTraceRadius::LogTraceRadius(TraceRadius const &other) : _value(std::log(other)) {}
272 
274  _value = std::exp(other);
275  return *this;
276 }
277 
279  _value = std::exp(other);
280  return *this;
281 }
282 
284  _value = std::log(other);
285  return *this;
286 }
287 
289  _value = std::log(other);
290  return *this;
291 }
292 } // namespace ellipses
293 } // namespace geom
294 } // namespace afw
295 } // namespace lsst
296 
297 #endif // !LSST_AFW_GEOM_ELLIPSES_radii_h_INCLUDED
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
Eigen::Matrix3d Jacobian
Parameter Jacobian matrix type.
Definition: BaseCore.h:64
The radius defined as the 4th root of the determinant of the quadrupole matrix.
Definition: radii.h:57
DeterminantRadius(DeterminantRadius &&)=default
DeterminantRadius & operator=(double value)
Definition: radii.h:79
DeterminantRadius & operator=(TraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
DeterminantRadius(DeterminantRadius const &)=default
DeterminantRadius & operator=(LogTraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
DeterminantRadius & operator=(DeterminantRadius &&)=default
DeterminantRadius & operator=(DeterminantRadius const &)=default
A complex ellipticity with magnitude .
Definition: Distortion.h:44
The natural logarithm of the DeterminantRadius.
Definition: radii.h:169
LogDeterminantRadius & operator=(LogTraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
LogDeterminantRadius & operator=(LogDeterminantRadius &&)=default
LogDeterminantRadius(LogDeterminantRadius &&)=default
LogDeterminantRadius & operator=(LogDeterminantRadius const &)=default
LogDeterminantRadius & operator=(double value)
Definition: radii.h:187
LogDeterminantRadius & operator=(TraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
LogDeterminantRadius(LogDeterminantRadius const &)=default
The natural logarithm of the TraceRadius.
Definition: radii.h:220
LogTraceRadius(LogTraceRadius &&)=default
LogTraceRadius(LogTraceRadius const &)=default
LogTraceRadius & operator=(LogTraceRadius const &)=default
LogTraceRadius & operator=(LogTraceRadius &&)=default
LogTraceRadius & operator=(DeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
LogTraceRadius & operator=(LogDeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
LogTraceRadius & operator=(double value)
Definition: radii.h:238
An ellipse core with a complex ellipticity and radius parameterization.
Definition: Separable.h:50
The radius defined as .
Definition: radii.h:114
TraceRadius(TraceRadius const &)=default
TraceRadius & operator=(DeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
TraceRadius(TraceRadius &&)=default
TraceRadius & operator=(TraceRadius const &)=default
TraceRadius & operator=(TraceRadius &&)=default
static std::string getName()
Definition: radii.h:122
TraceRadius & operator=(double value)
Definition: radii.h:136
TraceRadius & operator=(LogDeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
Reports invalid arguments.
Definition: Runtime.h:66
T exp(T... args)
T log(T... args)
class[[deprecated("Removed with no replacement (but see lsst::afw::image::TransmissionCurve). Will be " "removed after v22.")]] FilterProperty final
Describe the properties of a Filter (e.g.
Definition: Filter.h:53
A base class for image defects.
STL namespace.