LSSTApplications  20.0.0
LSSTDataManagementBasePackage
Axes.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_Axes_h_INCLUDED
26 #define LSST_AFW_GEOM_ELLIPSES_Axes_h_INCLUDED
27 
28 /*
29  * Definitions and inlines for Axes.
30  *
31  * Note: do not include directly; use the main ellipse header file.
32  */
33 
38 
39 namespace lsst {
40 namespace afw {
41 namespace geom {
42 namespace ellipses {
43 
47 class Axes : public BaseCore {
48 public:
49  enum ParameterEnum { A = 0, B = 1, THETA = 2 };
50 
51  double const getA() const { return _vector[A]; }
52  void setA(double a) { _vector[A] = a; }
53 
54  double const getB() const { return _vector[B]; }
55  void setB(double b) { _vector[B] = b; }
56 
57  double const getTheta() const { return _vector[THETA]; }
58  void setTheta(double theta) { _vector[THETA] = theta; }
59 
61  std::shared_ptr<Axes> clone() const { return std::static_pointer_cast<Axes>(_clone()); }
62 
64  std::string getName() const override;
65 
70  void normalize() override;
71 
72  void readParameters(double const* iter) override;
73 
74  void writeParameters(double* iter) const override;
75 
77  Axes& operator=(Axes const& other) {
78  _vector = other._vector;
79  return *this;
80  }
81  // Delegate to copy-assignment for backwards compatibility
82  Axes& operator=(Axes&& other) { return *this = other; }
83 
87  return *this;
88  }
89 
91  explicit Axes(double a = 1.0, double b = 1.0, double theta = 0.0, bool normalize = false)
92  : _vector(a, b, theta) {
93  if (normalize) this->normalize();
94  }
95 
97  explicit Axes(BaseCore::ParameterVector const& vector, bool normalize = false) : _vector(vector) {
98  if (normalize) this->normalize();
99  }
100 
102  Axes(Axes const& other) : _vector(other._vector) {}
103  // Delegate to copy-constructor for backwards compatibility
105  ~Axes() override = default;
106 
108  Axes(BaseCore const& other) { *this = other; }
109 
111  Axes(BaseCore::Transformer const& transformer) { transformer.apply(*this); }
112 
114  Axes(BaseCore::Convolution const& convolution) { convolution.apply(*this); }
115 
116 protected:
117  std::shared_ptr<BaseCore> _clone() const override { return std::make_shared<Axes>(*this); }
118 
119  void _assignToQuadrupole(double& ixx, double& iyy, double& ixy) const override;
120  void _assignFromQuadrupole(double ixx, double iyy, double ixy) override;
121 
122  void _assignToAxes(double& a, double& b, double& theta) const override;
123  void _assignFromAxes(double a, double b, double theta) override;
124 
125  Jacobian _dAssignToQuadrupole(double& ixx, double& iyy, double& ixy) const override;
126  Jacobian _dAssignFromQuadrupole(double ixx, double iyy, double ixy) override;
127 
128  Jacobian _dAssignToAxes(double& a, double& b, double& theta) const override;
129  Jacobian _dAssignFromAxes(double a, double b, double theta) override;
130 
131 private:
132  static Registrar<Axes> registrar;
133 
134  ParameterVector _vector;
135 };
136 } // namespace ellipses
137 } // namespace geom
138 } // namespace afw
139 } // namespace lsst
140 
141 #endif // !LSST_AFW_GEOM_ELLIPSES_Axes_h_INCLUDED
lsst::afw::geom::ellipses::Axes::getName
std::string getName() const override
Return a string that identifies this parametrization.
Definition: Axes.cc:34
lsst::afw::geom::ellipses::BaseCore::Transformer
A temporary-only expression object for ellipse core transformations.
Definition: Transformer.h:49
lsst::afw::geom::ellipses::Axes::readParameters
void readParameters(double const *iter) override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:49
std::string
STL class.
std::shared_ptr
STL class.
ellipses
lsst::afw::geom::ellipses::Axes::getB
double const getB() const
Definition: Axes.h:54
lsst::afw::geom::ellipses::Axes::normalize
void normalize() override
Put the parameters into a "standard form", if possible, and throw InvalidParameterError if they canno...
Definition: Axes.cc:36
lsst::afw::geom::ellipses::Axes::_assignFromQuadrupole
void _assignFromQuadrupole(double ixx, double iyy, double ixy) override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:82
lsst::afw::geom::ellipses::Axes::_dAssignToAxes
Jacobian _dAssignToAxes(double &a, double &b, double &theta) const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:75
lsst::afw::geom::ellipses::Axes::writeParameters
void writeParameters(double *iter) const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:55
lsst::afw::geom::ellipses::Axes::_assignToQuadrupole
void _assignToQuadrupole(double &ixx, double &iyy, double &ixy) const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:61
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::geom::ellipses::Axes::getTheta
double const getTheta() const
Definition: Axes.h:57
GridTransform.h
lsst::afw::geom::ellipses::Axes::~Axes
~Axes() override=default
lsst::afw::geom::ellipses::Axes
An ellipse core for the semimajor/semiminor axis and position angle parametrization (a,...
Definition: Axes.h:47
lsst::afw::geom::ellipses::Axes::THETA
@ THETA
Definition: Axes.h:49
lsst::afw::geom::ellipses::Axes::Axes
Axes(Axes const &other)
Copy constructor.
Definition: Axes.h:102
lsst::afw::geom::ellipses::Axes::A
@ A
Definition: Axes.h:49
lsst::afw::geom::ellipses::Axes::clone
std::shared_ptr< Axes > clone() const
Deep copy the ellipse core.
Definition: Axes.h:61
lsst::afw::geom::ellipses::Axes::getA
double const getA() const
Definition: Axes.h:51
lsst::afw::geom::ellipses::BaseCore::Transformer::apply
void apply(BaseCore &result) const
Definition: Transformer.cc:41
lsst::afw::geom::ellipses::Axes::_dAssignToQuadrupole
Jacobian _dAssignToQuadrupole(double &ixx, double &iyy, double &ixy) const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:65
lsst::afw::geom::ellipses::Axes::Axes
Axes(Axes &&other)
Definition: Axes.h:104
lsst::afw::geom::ellipses::BaseCore
A base class for parametrizations of the "core" of an ellipse - the ellipticity and size.
Definition: BaseCore.h:55
other
ItemVariant const * other
Definition: Schema.cc:56
lsst::afw::geom::ellipses::Axes::_dAssignFromAxes
Jacobian _dAssignFromAxes(double a, double b, double theta) override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:98
lsst::afw::geom::ellipses::BaseCore::ParameterVector
Eigen::Vector3d ParameterVector
Parameter vector type.
Definition: BaseCore.h:61
lsst::afw::geom::ellipses::Axes::_clone
std::shared_ptr< BaseCore > _clone() const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.h:117
Transformer.h
lsst::afw::geom::ellipses::Axes::Axes
Axes(BaseCore::Transformer const &transformer)
Converting copy constructor.
Definition: Axes.h:111
lsst::afw::geom::ellipses::Axes::Axes
Axes(double a=1.0, double b=1.0, double theta=0.0, bool normalize=false)
Construct from parameter values.
Definition: Axes.h:91
b
table::Key< int > b
Definition: TransmissionCurve.cc:467
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
lsst::afw::geom::ellipses::Axes::setA
void setA(double a)
Definition: Axes.h:52
lsst::afw::geom::ellipses::Axes::setTheta
void setTheta(double theta)
Definition: Axes.h:58
lsst::afw::geom::ellipses::BaseCore::Convolution::apply
void apply(BaseCore &result) const
Definition: Convolution.cc:50
lsst::geom
Definition: geomOperators.dox:4
lsst::afw::geom::ellipses::BaseCore::Jacobian
Eigen::Matrix3d Jacobian
Parameter Jacobian matrix type.
Definition: BaseCore.h:64
a
table::Key< int > a
Definition: TransmissionCurve.cc:466
lsst::afw::geom::ellipses::Axes::setB
void setB(double b)
Definition: Axes.h:55
lsst::afw::geom::ellipses::Axes::operator=
Axes & operator=(BaseCore const &other)
Converting assignment.
Definition: Axes.h:85
lsst::afw::geom::ellipses::Axes::Axes
Axes(BaseCore::Convolution const &convolution)
Converting copy constructor.
Definition: Axes.h:114
lsst::afw::geom::ellipses::Axes::Axes
Axes(BaseCore::ParameterVector const &vector, bool normalize=false)
Construct from a parameter vector.
Definition: Axes.h:97
lsst::afw::geom::ellipses::Axes::ParameterEnum
ParameterEnum
Definition: Axes.h:49
lsst::afw::geom::ellipses::BaseCore::operator=
BaseCore & operator=(BaseCore const &other)
Set the parameters of this ellipse core from another.
Definition: BaseCore.cc:156
lsst::afw::geom::ellipses::Axes::_dAssignFromQuadrupole
Jacobian _dAssignFromQuadrupole(double ixx, double iyy, double ixy) override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:87
lsst::afw::geom::ellipses::Axes::_assignFromAxes
void _assignFromAxes(double a, double b, double theta) override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:92
lsst::afw::geom::ellipses::Axes::Axes
Axes(BaseCore const &other)
Converting copy constructor.
Definition: Axes.h:108
astshim.fitsChanContinued.iter
def iter(self)
Definition: fitsChanContinued.py:88
BaseCore.h
lsst::afw::geom::ellipses::Axes::_assignToAxes
void _assignToAxes(double &a, double &b, double &theta) const override
Return the size of the bounding box for the ellipse core.
Definition: Axes.cc:69
Convolution.h
lsst::afw::geom::ellipses::Axes::operator=
Axes & operator=(Axes const &other)
Standard assignment.
Definition: Axes.h:77
lsst::afw::geom::ellipses::Axes::B
@ B
Definition: Axes.h:49
lsst::afw::geom::ellipses::BaseCore::Convolution
A temporary-only expression object for ellipse core convolution.
Definition: Convolution.h:46
lsst::afw::geom::ellipses::Axes::operator=
Axes & operator=(Axes &&other)
Definition: Axes.h:82