LSSTApplications  18.1.0
LSSTDataManagementBasePackage
FunctorKeys.h
Go to the documentation of this file.
1 // -*- LSST-C++ -*-
2 /*
3  * LSST Data Management System
4  * Copyright 2008-2014 LSST Corporation.
5  *
6  * This product includes software developed by the
7  * LSST Project (http://www.lsst.org/).
8  *
9  * This program is free software: you can redistribute it and/or modify
10  * it under the terms of the GNU General Public License as published by
11  * the Free Software Foundation, either version 3 of the License, or
12  * (at your option) any later version.
13  *
14  * This program is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17  * GNU General Public License for more details.
18  *
19  * You should have received a copy of the LSST License Statement and
20  * the GNU General Public License along with this program. If not,
21  * see <http://www.lsstcorp.org/LegalNotices/>.
22  */
23 
24 #ifndef LSST_AFW_MATH_SHAPELETS_FunctorKeys_h_INCLUDED
25 #define LSST_AFW_MATH_SHAPELETS_FunctorKeys_h_INCLUDED
26 
29 #include "lsst/afw/table/arrays.h"
32 
33 namespace lsst { namespace shapelet {
34 
45 class ShapeletFunctionKey : public afw::table::FunctorKey< ShapeletFunction > {
46 public:
47 
65  std::string const & name,
66  std::string const & doc,
67  std::string const & ellipseUnit,
68  std::string const & coeffUnit,
69  int order,
70  BasisTypeEnum basisType=HERMITE
71  );
72 
74  ShapeletFunctionKey() : _ellipseKey(), _coefficientsKey(), _order(-1), _basisType(HERMITE) {}
75 
80  BasisTypeEnum basisType=HERMITE
81  ) :
82  _ellipseKey(ellipse),
83  _coefficientsKey(coefficients),
84  _order(computeOrder(coefficients.getSize())),
85  _basisType(basisType)
86  {}
87 
98  _ellipseKey(s), _coefficientsKey(s),
99  _order(computeOrder(_coefficientsKey.getSize())),
100  _basisType(basisType)
101  {}
102 
104  virtual ShapeletFunction get(afw::table::BaseRecord const & record) const;
105 
107  virtual void set(afw::table::BaseRecord & record, ShapeletFunction const & value) const;
108 
110  bool operator==(ShapeletFunctionKey const & other) const {
112  return _order == other._order && _ellipseKey == other._ellipseKey
113  && _coefficientsKey == other._coefficientsKey;
114  }
115  bool operator!=(ShapeletFunctionKey const & other) const { return !(*this == other); }
117 
119  bool isValid() const { return _ellipseKey.isValid() && _coefficientsKey.isValid(); }
120 
122  afw::table::EllipseKey const & getEllipse() const { return _ellipseKey; }
123 
125  afw::table::ArrayKey<double> const & getCoefficients() const { return _coefficientsKey; }
126 
128  int getOrder() const { return _order; }
129 
131  BasisTypeEnum getBasisType() const { return _basisType; }
132 
133 private:
134  afw::table::EllipseKey _ellipseKey;
135  afw::table::ArrayKey<double> _coefficientsKey;
136  int _order;
137  BasisTypeEnum _basisType;
138 };
139 
140 
161 class MultiShapeletFunctionKey : public afw::table::FunctorKey< MultiShapeletFunction > {
162 public:
163 
181  std::string const & name,
182  std::string const & doc,
183  std::string const & ellipseUnit,
184  std::string const & coeffUnit,
185  std::vector<int> const & orders,
186  BasisTypeEnum basisType=HERMITE
187  );
188 
191 
194  _components(components)
195  {}
196 
207 
209  virtual MultiShapeletFunction get(afw::table::BaseRecord const & record) const;
210 
212  virtual void set(afw::table::BaseRecord & record, MultiShapeletFunction const & value) const;
213 
215  bool operator==(MultiShapeletFunctionKey const & other) const;
217  bool operator!=(MultiShapeletFunctionKey const & other) const { return !(*this == other); }
219 
221  bool isValid() const;
222 
224  PTR(ShapeletFunctionKey) operator[](int n) { return _components[n]; }
225 
227  PTR(ShapeletFunctionKey const) operator[](int n) const { return _components[n]; }
228 
229 private:
231 };
232 
233 }} // namespace lsst::shapelet
234 
235 #endif // !defined(LSST_AFW_MATH_SHAPELETS_FunctorKeys_h_INCLUDED)
table::Key< table::Array< int > > components
Defines the fields and offsets for a table.
Definition: Schema.h:50
BasisTypeEnum getBasisType() const
Return the type of the shapelet basis.
Definition: FunctorKeys.h:131
boost::shared_ptr< ShapeletFunctionKey const > operator[](int n) const
Return a FunctorKey to the nth component.
Definition: FunctorKeys.h:227
A proxy type for name lookups in a Schema.
Definition: Schema.h:360
#define PTR(...)
Definition: base.h:41
Class that maps ShapeletFunction objects to fields in afw::table objects.
Definition: FunctorKeys.h:45
Class that maps MultiShapeletFunction objects to fields in afw::table objects.
Definition: FunctorKeys.h:161
bool operator==(ShapeletFunctionKey const &other) const
Compare the FunctorKey for equality with another, using the underlying Ixx, Iyy, Ixy Keys...
Definition: FunctorKeys.h:111
bool isValid() const noexcept
Return True if all the constituent Keys are valid.
Definition: aggregates.h:418
bool operator!=(MultiShapeletFunctionKey const &other) const
Compare the FunctorKey for equality with another, using the underlying Ixx, Iyy, Ixy Keys...
Definition: FunctorKeys.h:217
MultiShapeletFunctionKey()
Default constructor; instance will not be usuable unless subsequently assigned to.
Definition: FunctorKeys.h:190
bool isValid() const
Return True if all the constituent Keys are valid.
Definition: FunctorKeys.h:119
bool operator!=(ShapeletFunctionKey const &other) const
Compare the FunctorKey for equality with another, using the underlying Ixx, Iyy, Ixy Keys...
Definition: FunctorKeys.h:115
static ShapeletFunctionKey addFields(afw::table::Schema &schema, std::string const &name, std::string const &doc, std::string const &ellipseUnit, std::string const &coeffUnit, int order, BasisTypeEnum basisType=HERMITE)
Add the necessary fields for saving a ShapeletFunction to a Schema.
STL class.
A base class for image defects.
MultiShapeletFunctionKey(std::vector< boost::shared_ptr< ShapeletFunctionKey >> const &components)
Construct from individual Keys/FunctorKeys.
Definition: FunctorKeys.h:193
A multi-scale shapelet function.
int computeOrder(int size)
Infer the order of a shapelet expansion from the number of coefficients.
Definition: constants.h:104
table::Schema schema
Definition: Camera.cc:161
afw::table::ArrayKey< double > const & getCoefficients() const
Return a FunctorKey that extracts just the coefficients.
Definition: FunctorKeys.h:125
ShapeletFunctionKey(afw::table::EllipseKey const &ellipse, afw::table::ArrayKey< double > const &coefficients, BasisTypeEnum basisType=HERMITE)
Construct from individual Keys/FunctorKeys.
Definition: FunctorKeys.h:77
Cartesian shapelets or Gauss-Hermite functions, as defined in Refregier, 2003.
Definition: constants.h:53
solver_t * s
ShapeletFunctionKey(afw::table::SubSchema const &s, BasisTypeEnum basisType=HERMITE)
Construct from a subschema, assuming the necesary subfields.
Definition: FunctorKeys.h:97
afw::table::EllipseKey const & getEllipse() const
Return a FunctorKey that extracts just the Ellipse.
Definition: FunctorKeys.h:122
Base class for all records.
Definition: BaseRecord.h:31
int getOrder() const
Return the shapelet order.
Definition: FunctorKeys.h:128
ItemVariant const * other
Definition: Schema.cc:56
A FunctorKey used to get or set a geom::ellipses::Ellipse from an (xx,yy,xy,x,y) tuple of Keys...
Definition: aggregates.h:360
Convenience base class that combines the OutputFunctorKey and InputFunctorKey.
Definition: FunctorKey.h:74
boost::shared_ptr< ShapeletFunctionKey > operator[](int n)
Return a FunctorKey to the nth component.
Definition: FunctorKeys.h:224
A 2-d function defined by an expansion onto a Gauss-Laguerre or Gauss-Hermite basis.
ShapeletFunctionKey()
Default constructor; instance will not be usuable unless subsequently assigned to.
Definition: FunctorKeys.h:74
bool isValid() const noexcept
Return True if the FunctorKey contains valid scalar keys.
Definition: arrays.h:137
ndarray::Array< double const, 2, 2 > coefficients