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
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.