LSST Applications  21.0.0+c4f5df5339,21.0.0+e70536a077,21.0.0-1-ga51b5d4+7c60f8a6ea,21.0.0-10-g560fb7b+411cd868f8,21.0.0-10-gcf60f90+8c49d86aa0,21.0.0-13-gc485e61d+38156233bf,21.0.0-16-g7a993c7b9+1041c3824f,21.0.0-2-g103fe59+d9ceee3e5a,21.0.0-2-g1367e85+0b2f7db15a,21.0.0-2-g45278ab+e70536a077,21.0.0-2-g5242d73+0b2f7db15a,21.0.0-2-g7f82c8f+feb9862f5e,21.0.0-2-g8f08a60+9c9a9cfcc8,21.0.0-2-ga326454+feb9862f5e,21.0.0-2-gde069b7+bedfc5e1fb,21.0.0-2-gecfae73+417509110f,21.0.0-2-gfc62afb+0b2f7db15a,21.0.0-3-g21c7a62+a91f7c0b59,21.0.0-3-g357aad2+062581ff1a,21.0.0-3-g4be5c26+0b2f7db15a,21.0.0-3-g65f322c+85aa0ead76,21.0.0-3-g7d9da8d+c4f5df5339,21.0.0-3-gaa929c8+411cd868f8,21.0.0-3-gc44e71e+fd4029fd48,21.0.0-3-ge02ed75+5d9b90b8aa,21.0.0-38-g070523fc+44fda2b515,21.0.0-4-g591bb35+5d9b90b8aa,21.0.0-4-g88306b8+3cdc83ea97,21.0.0-4-gc004bbf+d52368b591,21.0.0-4-gccdca77+a5c54364a0,21.0.0-5-g7ebb681+81e2098694,21.0.0-5-gdf36809+87b8d260e6,21.0.0-6-g2d4f3f3+e70536a077,21.0.0-6-g4e60332+5d9b90b8aa,21.0.0-6-g5ef7dad+3f4e29eeae,21.0.0-7-gc8ca178+0f5e56d48f,21.0.0-9-g9eb8d17+cc2c7a81aa,master-gac4afde19b+5d9b90b8aa,w.2021.07
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  typedef Eigen::Matrix<double, 5, 1> ParameterVector;
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);
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
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
ItemVariant const * other
Definition: Schema.cc:56
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
Eigen::Matrix< double, 5, 1 > ParameterVector
Proxy return type for Ellipse::convolve().
Definition: Ellipse.h:55
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:101
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
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.