LSST Applications g0b6bd0c080+a72a5dd7e6,g1182afd7b4+2a019aa3bb,g17e5ecfddb+2b8207f7de,g1d67935e3f+06cf436103,g38293774b4+ac198e9f13,g396055baef+6a2097e274,g3b44f30a73+6611e0205b,g480783c3b1+98f8679e14,g48ccf36440+89c08d0516,g4b93dc025c+98f8679e14,g5c4744a4d9+a302e8c7f0,g613e996a0d+e1c447f2e0,g6c8d09e9e7+25247a063c,g7271f0639c+98f8679e14,g7a9cd813b8+124095ede6,g9d27549199+a302e8c7f0,ga1cf026fa3+ac198e9f13,ga32aa97882+7403ac30ac,ga786bb30fb+7a139211af,gaa63f70f4e+9994eb9896,gabf319e997+ade567573c,gba47b54d5d+94dc90c3ea,gbec6a3398f+06cf436103,gc6308e37c7+07dd123edb,gc655b1545f+ade567573c,gcc9029db3c+ab229f5caf,gd01420fc67+06cf436103,gd877ba84e5+06cf436103,gdb4cecd868+6f279b5b48,ge2d134c3d5+cc4dbb2e3f,ge448b5faa6+86d1ceac1d,gecc7e12556+98f8679e14,gf3ee170dca+25247a063c,gf4ac96e456+ade567573c,gf9f5ea5b4d+ac198e9f13,gff490e6085+8c2580be5c,w.2022.27
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
38namespace lsst {
39namespace afw {
40namespace geom {
41namespace ellipses {
42
51class Ellipse {
52public:
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
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
99
101 void setParameterVector(ParameterVector const& vector);
102
103 void readParameters(double const* iter);
104
105 void writeParameters(double* iter) const;
106
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
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
178private:
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
void shift(lsst::geom::Extent2D const &offset)
Move the ellipse center by the given offset.
Definition: Ellipse.h:95
lsst::geom::Point2D & getCenter()
Return the center point.
Definition: Ellipse.h:65
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
lsst::geom::Point2D const & getCenter() const
Return the center point.
Definition: Ellipse.h:62
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
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
BaseCore const & getCore() const
Return the ellipse core.
Definition: Ellipse.h:71
std::shared_ptr< BaseCore > getCorePtr()
Return the ellipse core.
Definition: Ellipse.h:80
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.
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
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
BaseCore & getCore()
Return the ellipse core.
Definition: Ellipse.h:74
std::shared_ptr< BaseCore const > getCorePtr() const
Return the ellipse core.
Definition: Ellipse.h:77
Eigen::Matrix< double, 5, 1 > ParameterVector
Parameter vector type.
Definition: Ellipse.h:57
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.