LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
LSSTDataManagementBasePackage
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;
49 class LogTraceRadius;
50 
57 class DeterminantRadius final {
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 
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 
114 class TraceRadius final {
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 
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 
169 class LogDeterminantRadius final {
170 public:
171  void normalize() {}
172 
173  static std::string getName() { return "LogDeterminantRadius"; }
174 
175  explicit LogDeterminantRadius(double value = 0.0) : _value(value) {}
176 
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 
220 class LogTraceRadius final {
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 
269 inline TraceRadius::TraceRadius(LogTraceRadius const &other) : _value(std::exp(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
lsst::afw::geom::ellipses::DeterminantRadius::DeterminantRadius
DeterminantRadius(double value=1.0)
Definition: radii.h:67
lsst::afw::geom::ellipses::DeterminantRadius
The radius defined as the 4th root of the determinant of the quadrupole matrix.
Definition: radii.h:57
lsst::afw::geom::ellipses::TraceRadius::operator=
TraceRadius & operator=(TraceRadius const &)=default
lsst::afw::geom::ellipses::LogDeterminantRadius::normalize
void normalize()
Definition: radii.h:171
lsst::afw::geom::ellipses::LogDeterminantRadius
The natural logarithm of the DeterminantRadius.
Definition: radii.h:169
std::string
STL class.
lsst::afw::geom::ellipses::DeterminantRadius::~DeterminantRadius
~DeterminantRadius()=default
lsst::afw::geom::ellipses::LogDeterminantRadius::operator=
LogDeterminantRadius & operator=(LogTraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::LogTraceRadius::LogTraceRadius
LogTraceRadius(double value=0.0)
Definition: radii.h:226
ellipses
lsst::afw::geom::ellipses::DeterminantRadius::normalize
void normalize()
Definition: radii.h:59
Distortion.h
lsst::afw::geom::ellipses::DeterminantRadius::DeterminantRadius
DeterminantRadius(DeterminantRadius const &)=default
lsst::afw::geom::ellipses::LogDeterminantRadius::operator=
LogDeterminantRadius & operator=(TraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::TraceRadius::operator=
TraceRadius & operator=(double value)
Definition: radii.h:136
lsst::afw::geom::ellipses::LogTraceRadius::operator=
LogTraceRadius & operator=(LogDeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::geom::ellipses::DeterminantRadius::operator=
DeterminantRadius & operator=(DeterminantRadius &&)=default
lsst::afw::geom::ellipses::TraceRadius::getName
static std::string getName()
Definition: radii.h:122
lsst::afw::geom::ellipses::DeterminantRadius::operator=
DeterminantRadius & operator=(double value)
Definition: radii.h:79
lsst::afw::geom::ellipses::LogDeterminantRadius::operator=
LogDeterminantRadius & operator=(LogDeterminantRadius const &)=default
lsst::afw::geom::ellipses::DeterminantRadius::DeterminantRadius
DeterminantRadius(DeterminantRadius &&)=default
lsst::afw::geom::ellipses::TraceRadius::TraceRadius
TraceRadius(double value=1.0)
Definition: radii.h:124
lsst::afw::geom::ellipses::LogTraceRadius::getName
static std::string getName()
Definition: radii.h:224
lsst::afw::geom::ellipses::LogTraceRadius::LogTraceRadius
LogTraceRadius(LogTraceRadius const &)=default
lsst::afw::geom::ellipses::LogDeterminantRadius::operator=
LogDeterminantRadius & operator=(LogDeterminantRadius &&)=default
lsst::afw::geom::ellipses::LogTraceRadius::operator=
LogTraceRadius & operator=(DeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::DeterminantRadius::getName
static std::string getName()
Definition: radii.h:65
std::log
T log(T... args)
lsst::afw::geom::ellipses::LogDeterminantRadius::operator=
LogDeterminantRadius & operator=(double value)
Definition: radii.h:187
lsst::afw::geom::ellipses::LogDeterminantRadius::LogDeterminantRadius
LogDeterminantRadius(LogDeterminantRadius const &)=default
lsst::afw::geom::ellipses::Separable
An ellipse core with a complex ellipticity and radius parameterization.
Definition: radii.h:44
lsst::afw::geom::ellipses::TraceRadius::TraceRadius
TraceRadius(TraceRadius const &)=default
lsst::afw::geom::ellipses::LogTraceRadius::operator=
LogTraceRadius & operator=(LogTraceRadius const &)=default
lsst::base.packages.log
log
Definition: packages.py:38
other
ItemVariant const * other
Definition: Schema.cc:56
lsst::afw::geom::ellipses::LogTraceRadius
The natural logarithm of the TraceRadius.
Definition: radii.h:220
lsst::afw::geom::ellipses::TraceRadius::operator=
TraceRadius & operator=(DeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::LogDeterminantRadius::LogDeterminantRadius
LogDeterminantRadius(LogDeterminantRadius &&)=default
lsst::afw::geom::ellipses::LogDeterminantRadius::getName
static std::string getName()
Definition: radii.h:173
lsst::afw::geom::ellipses::TraceRadius::TraceRadius
TraceRadius(TraceRadius &&)=default
lsst::afw::geom::ellipses::DeterminantRadius::operator=
DeterminantRadius & operator=(TraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::LogDeterminantRadius::LogDeterminantRadius
LogDeterminantRadius(double value=0.0)
Definition: radii.h:175
lsst::afw::geom::ellipses::TraceRadius::operator=
TraceRadius & operator=(TraceRadius &&)=default
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
lsst::afw::geom::ellipses::LogTraceRadius::~LogTraceRadius
~LogTraceRadius()=default
LSST_EXCEPT
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
lsst::geom
Definition: AffineTransform.h:36
lsst::afw::geom::ellipses::BaseCore::Jacobian
Eigen::Matrix3d Jacobian
Parameter Jacobian matrix type.
Definition: BaseCore.h:64
lsst::afw::geom::ellipses::TraceRadius::operator=
TraceRadius & operator=(LogDeterminantRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::LogTraceRadius::normalize
void normalize()
Definition: radii.h:222
lsst::afw::geom::ellipses::DeterminantRadius::operator=
DeterminantRadius & operator=(DeterminantRadius const &)=default
lsst.pex::exceptions::InvalidParameterError
Reports invalid arguments.
Definition: Runtime.h:66
lsst::afw::geom::ellipses::TraceRadius::normalize
void normalize()
Definition: radii.h:116
std::exp
T exp(T... args)
lsst::afw::geom::ellipses::LogTraceRadius::operator=
LogTraceRadius & operator=(double value)
Definition: radii.h:238
std
STL namespace.
lsst::afw::geom::ellipses::DeterminantRadius::operator=
DeterminantRadius & operator=(LogTraceRadius const &)=delete
Conversion between trace and determinant radii requires ellipticity.
lsst::afw::geom::ellipses::TraceRadius::~TraceRadius
~TraceRadius()=default
lsst::afw::geom::ellipses::LogTraceRadius::LogTraceRadius
LogTraceRadius(LogTraceRadius &&)=default
lsst::afw::geom::ellipses::LogTraceRadius::operator=
LogTraceRadius & operator=(LogTraceRadius &&)=default
lsst::afw::geom::ellipses::Distortion
A complex ellipticity with magnitude .
Definition: Distortion.h:44
lsst::afw::geom::ellipses::TraceRadius
The radius defined as .
Definition: radii.h:114
BaseCore.h
lsst::afw::geom::ellipses::LogDeterminantRadius::~LogDeterminantRadius
~LogDeterminantRadius()=default