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
Ellipse.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_Ellipse_h_INCLUDED
26 #define LSST_AFW_GEOM_ELLIPSES_Ellipse_h_INCLUDED
27 
28 /*
29  * Forward declarations, typedefs, and definitions for Ellipse.
30  *
31  * Note: do not include directly; use the main ellipse header file.
32  */
33 
35 #include "lsst/geom/Box.h"
37 
38 namespace lsst {
39 namespace afw {
40 namespace geom {
41 namespace ellipses {
42 
51 class Ellipse {
52 public:
53  class Transformer;
54  class GridTransform;
55  class Convolution;
56 
57  using ParameterVector = Eigen::Matrix<double, 5, 1>;
58 
59  enum ParameterEnum { X = 3, Y = 4 };
60 
62  lsst::geom::Point2D const& getCenter() const { return _center; }
63 
65  lsst::geom::Point2D& getCenter() { return _center; }
66 
68  void setCenter(lsst::geom::Point2D const& center) { _center = center; }
69 
71  BaseCore const& getCore() const { return *_core; }
72 
74  BaseCore& getCore() { return *_core; }
75 
77  std::shared_ptr<BaseCore const> getCorePtr() const { return _core; }
78 
81 
83  void setCore(BaseCore const& core) { *_core = core; }
84 
86  void normalize() { _core->normalize(); }
87 
89  void grow(double buffer) { _core->grow(buffer); }
90 
92  void scale(double factor) { _core->scale(factor); }
93 
95  void shift(lsst::geom::Extent2D const& offset) { _center += offset; }
96 
98  ParameterVector const getParameterVector() const;
99 
101  void setParameterVector(ParameterVector const& vector);
102 
103  void readParameters(double const* iter);
104 
105  void writeParameters(double* iter) const;
106 
115  Transformer transform(lsst::geom::AffineTransform const& transform);
116  Transformer const transform(lsst::geom::AffineTransform const& transform) const;
118 
123  Convolution convolve(Ellipse const& other);
124  Convolution const convolve(Ellipse const& other) const;
126 
133  GridTransform const getGridTransform() const;
134 
137 
143  Ellipse& operator=(Ellipse const& other);
144  Ellipse& operator=(Ellipse&& other);
145 
151  bool operator==(Ellipse const& other) const {
152  return getCenter() == other.getCenter() && getCore() == other.getCore();
153  }
154 
160  bool operator!=(Ellipse const& other) const { return !operator==(other); }
161 
162  virtual ~Ellipse() = default;
163 
164  explicit Ellipse(BaseCore const& core, lsst::geom::Point2D const& center = lsst::geom::Point2D())
165  : _core(core.clone()), _center(center) {}
166 
168  lsst::geom::Point2D const& center = lsst::geom::Point2D())
169  : _core(core->clone()), _center(center) {}
170 
171  Ellipse(Transformer const& other);
172  Ellipse(Convolution const& other);
173 
174  Ellipse(Ellipse const& other) : _core(other.getCore().clone()), _center(other.getCenter()) {}
175  // Delegate to copy-constructor for backwards compatibility
176  Ellipse(Ellipse&& other) : Ellipse(other) {}
177 
178 private:
180  lsst::geom::Point2D _center;
181 };
182 } // namespace ellipses
183 } // namespace geom
184 } // namespace afw
185 } // namespace lsst
186 
187 #endif // !LSST_AFW_GEOM_ELLIPSES_Ellipse_h_INCLUDED
A base class for parametrizations of the "core" of an ellipse - the ellipticity and size.
Definition: BaseCore.h:55
A temporary-only expression object representing an lsst::geom::AffineTransform that maps the Ellipse ...
Definition: GridTransform.h:82
A temporary-only expression object for ellipse transformations.
Definition: Transformer.h:86
An ellipse defined by an arbitrary BaseCore and a center point.
Definition: Ellipse.h:51
ParameterVector const getParameterVector() const
Return the ellipse parameters as a vector.
Definition: Ellipse.cc:31
void grow(double buffer)
Increase the major and minor radii of the ellipse by the given buffer.
Definition: Ellipse.h:89
void writeParameters(double *iter) const
Definition: Ellipse.cc:49
Ellipse(Ellipse const &other)
Return the transform that maps the ellipse to the unit circle.
Definition: Ellipse.h:174
BaseCore & getCore()
Return the ellipse core.
Definition: Ellipse.h:74
void shift(lsst::geom::Extent2D const &offset)
Move the ellipse center by the given offset.
Definition: Ellipse.h:95
lsst::geom::Point2D const & getCenter() const
Return the center point.
Definition: Ellipse.h:62
void scale(double factor)
Scale the size of the ellipse by the given factor.
Definition: Ellipse.h:92
Ellipse & operator=(Ellipse const &other)
Set the parameters of this ellipse from another.
Definition: Ellipse.cc:60
virtual ~Ellipse()=default
Return the transform that maps the ellipse to the unit circle.
bool operator!=(Ellipse const &other) const
Compare two ellipses for inequality.
Definition: Ellipse.h:160
BaseCore const & getCore() const
Return the ellipse core.
Definition: Ellipse.h:71
Ellipse(std::shared_ptr< BaseCore const > const &core, lsst::geom::Point2D const &center=lsst::geom::Point2D())
Return the transform that maps the ellipse to the unit circle.
Definition: Ellipse.h:167
lsst::geom::Box2D computeBBox() const
Return the bounding box of the ellipse.
Definition: Ellipse.cc:55
bool operator==(Ellipse const &other) const
Compare two ellipses for equality.
Definition: Ellipse.h:151
GridTransform const getGridTransform() const
Return the transform that maps the ellipse to the unit circle.
std::shared_ptr< BaseCore const > getCorePtr() const
Return the ellipse core.
Definition: Ellipse.h:77
Ellipse(BaseCore const &core, lsst::geom::Point2D const &center=lsst::geom::Point2D())
Return the transform that maps the ellipse to the unit circle.
Definition: Ellipse.h:164
void normalize()
Put the parameters in a standard form.
Definition: Ellipse.h:86
Transformer transform(lsst::geom::AffineTransform const &transform)
Definition: Transformer.h:124
void setCenter(lsst::geom::Point2D const &center)
Set the center point.
Definition: Ellipse.h:68
void readParameters(double const *iter)
Definition: Ellipse.cc:43
lsst::geom::Point2D & getCenter()
Return the center point.
Definition: Ellipse.h:65
void setParameterVector(ParameterVector const &vector)
Set the ellipse parameters from a vector.
Definition: Ellipse.cc:38
Convolution convolve(Ellipse const &other)
Return the transform that maps the ellipse to the unit circle.
Definition: Convolution.h:99
Ellipse(Ellipse &&other)
Return the transform that maps the ellipse to the unit circle.
Definition: Ellipse.h:176
void setCore(BaseCore const &core)
Set the ellipse core; the type of the core is not changed.
Definition: Ellipse.h:83
Eigen::Matrix< double, 5, 1 > ParameterVector
Parameter vector type.
Definition: Ellipse.h:57
std::shared_ptr< BaseCore > getCorePtr()
Return the ellipse core.
Definition: Ellipse.h:80
An affine coordinate transformation consisting of a linear transformation and an offset.
A floating-point coordinate rectangle geometry.
Definition: Box.h:413
A base class for image defects.