LSST Applications  21.0.0-147-g0e635eb1+1acddb5be5,22.0.0+052faf71bd,22.0.0+1ea9a8b2b2,22.0.0+6312710a6c,22.0.0+729191ecac,22.0.0+7589c3a021,22.0.0+9f079a9461,22.0.1-1-g7d6de66+b8044ec9de,22.0.1-1-g87000a6+536b1ee016,22.0.1-1-g8e32f31+6312710a6c,22.0.1-10-gd060f87+016f7cdc03,22.0.1-12-g9c3108e+df145f6f68,22.0.1-16-g314fa6d+c825727ab8,22.0.1-19-g93a5c75+d23f2fb6d8,22.0.1-19-gb93eaa13+aab3ef7709,22.0.1-2-g8ef0a89+b8044ec9de,22.0.1-2-g92698f7+9f079a9461,22.0.1-2-ga9b0f51+052faf71bd,22.0.1-2-gac51dbf+052faf71bd,22.0.1-2-gb66926d+6312710a6c,22.0.1-2-gcb770ba+09e3807989,22.0.1-20-g32debb5+b8044ec9de,22.0.1-23-gc2439a9a+fb0756638e,22.0.1-3-g496fd5d+09117f784f,22.0.1-3-g59f966b+1e6ba2c031,22.0.1-3-g849a1b8+f8b568069f,22.0.1-3-gaaec9c0+c5c846a8b1,22.0.1-32-g5ddfab5d3+60ce4897b0,22.0.1-4-g037fbe1+64e601228d,22.0.1-4-g8623105+b8044ec9de,22.0.1-5-g096abc9+d18c45d440,22.0.1-5-g15c806e+57f5c03693,22.0.1-7-gba73697+57f5c03693,master-g6e05de7fdc+c1283a92b8,master-g72cdda8301+729191ecac,w.2021.39
LSST Data Management Base Package
simpleShape.h
Go to the documentation of this file.
1 // -*- lsst-c++ -*-
2 /*
3  * LSST Data Management System
4  * Copyright 2008-2013 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 #ifndef LSST_MEAS_EXTENSIONS_simpleShape_h_INCLUDED
24 #define LSST_MEAS_EXTENSIONS_simpleShape_h_INCLUDED
25 
26 #include <bitset>
27 
28 #include "lsst/pex/config.h"
29 #include "lsst/geom.h"
30 #include "lsst/afw/geom/ellipses.h"
31 #include "lsst/afw/table.h"
32 #include "lsst/afw/image.h"
34 #include "lsst/meas/base.h"
35 
36 namespace lsst { namespace meas { namespace extensions { namespace simpleShape {
37 
38 class SimpleShapeResult;
39 
45  public:
46  LSST_CONTROL_FIELD(sigma, double, "Sigma of circular Gaussian used as weight function, in pixels");
47  LSST_CONTROL_FIELD(nSigmaRegion, double, "Maximum radius for pixels to include, in units of sigma");
48 
50 };
51 
52 class SimpleShapeResultKey : public afw::table::FunctorKey<SimpleShapeResult> {
53  public:
56  std::string const & name
57  );
58 
59  // Default constructor
61 
72 
73  virtual SimpleShapeResult get(afw::table::BaseRecord const & record) const;
74  virtual void set(afw::table::BaseRecord & record, SimpleShapeResult const & value) const;
75 
77  bool operator==(SimpleShapeResultKey const & other) const;
79  bool operator!=(SimpleShapeResultKey const & other) const { return !(*this == other); }
81 
83  bool isValid() const;
84 
85  lsst::meas::base::FlagHandler const & getFlagHandler() const { return _flagHandler; }
86 
87  private:
89  lsst::afw::table::Point2DKey _centroidResult;
91  lsst::meas::base::FlagHandler _flagHandler;
92 };
93 
94 
96 public:
97 
98  // Structures and routines to manage flaghandler
100  static unsigned int const N_FLAGS = 1;
102 
104 
105  SimpleShape(Control const & ctrl, std::string const & name, afw::table::Schema & schema);
106 
117  template <typename T>
121  double nSigmaRegion=3.0
122  );
123 
151  static Eigen::Matrix<double,5,6> convertRawMoments(
152  Eigen::Matrix<double,6,1> const & q,
153  afw::geom::ellipses::Quadrupole & quadrupole,
154  geom::Point2D & center
155  );
156 
179  static Eigen::Matrix<double, 5, 5> correctWeightedMoments(
182  geom::Point2D & center
183  );
184 
185  virtual void measure(
186  afw::table::SourceRecord & measRecord,
187  afw::image::Exposure<float> const & exposure
188  ) const;
189 
190  virtual void fail(
191  afw::table::SourceRecord & measRecord,
193  ) const;
194 
195  private:
196  Control _ctrl;
197  SimpleShapeResultKey _resultKey;
198  lsst::meas::base::SafeCentroidExtractor _centroidExtractor;
199 };
200 
205  public:
208  Eigen::Matrix<double,5,5> covariance;
209 
210 #ifndef SWIG
212 #endif
213 
214  // Flag getter for Swig which doesn't understand std::bitset
215  bool getFlag(int index) const { return flags[index]; }
216 
218 };
219 
220 
221 }}}} // namespace lsst::meas::extensions::simpleShape
222 
223 #endif // !LSST_MEAS_EXTENSIONS_simpleShape_h_INCLUDED
table::Schema schema
Definition: python.h:134
An ellipse defined by an arbitrary BaseCore and a center point.
Definition: Ellipse.h:51
An ellipse core with quadrupole moments as parameters.
Definition: Quadrupole.h:47
A class to manipulate images, masks, and variance as a single object.
Definition: MaskedImage.h:73
Base class for all records.
Definition: BaseRecord.h:31
Convenience base class that combines the OutputFunctorKey and InputFunctorKey.
Definition: FunctorKey.h:74
A FunctorKey used to get or set a geom::ellipses::Quadrupole from a tuple of constituent Keys.
Definition: aggregates.h:282
Defines the fields and offsets for a table.
Definition: Schema.h:51
Record class that contains measurements made on a single exposure.
Definition: Source.h:78
A proxy type for name lookups in a Schema.
Definition: Schema.h:367
vector-type utility class to build a collection of FlagDefinitions
Definition: FlagHandler.h:60
Utility class for handling flag fields that indicate the failure modes of an algorithm.
Definition: FlagHandler.h:148
Exception to be thrown when a measurement algorithm experiences a known failure mode.
Definition: exceptions.h:48
Utility class for measurement algorithms that extracts a position from the Centroid slot and handles ...
An abstract base classes for which the same implementation can be used for both SingleFrameAlgorithm ...
Definition: Algorithm.h:170
A C++ control class to handle SdssShapeAlgorithm's configuration.
Definition: simpleShape.h:44
double sigma
"Sigma of circular Gaussian used as weight function, in pixels" ;
Definition: simpleShape.h:46
double nSigmaRegion
"Maximum radius for pixels to include, in units of sigma" ;
Definition: simpleShape.h:47
SimpleShape(Control const &ctrl, std::string const &name, afw::table::Schema &schema)
Definition: simpleShape.cc:378
static Eigen::Matrix< double, 5, 5 > correctWeightedMoments(afw::geom::ellipses::Quadrupole const &weight, afw::geom::ellipses::Quadrupole &ellipse, geom::Point2D &center)
Correct moments measured with a Gaussian weight function by assuming the data was also an elliptical ...
Definition: simpleShape.cc:234
static SimpleShapeResult computeMoments(afw::geom::ellipses::Ellipse const &weight, afw::image::MaskedImage< T > const &image, double nSigmaRegion=3.0)
Compute the Gaussian-weighted moments of an image.
Definition: simpleShape.cc:161
virtual void fail(afw::table::SourceRecord &measRecord, lsst::meas::base::MeasurementError *error=NULL) const
Handle an exception thrown by the current algorithm by setting flags in the given record.
Definition: simpleShape.cc:399
static base::FlagDefinitionList const & getFlagDefinitions()
Definition: simpleShape.cc:37
static base::FlagDefinition const FAILURE
Definition: simpleShape.h:101
static Eigen::Matrix< double, 5, 6 > convertRawMoments(Eigen::Matrix< double, 6, 1 > const &q, afw::geom::ellipses::Quadrupole &quadrupole, geom::Point2D &center)
Convert linear raw moments into an ellipse and centroid, and return the derivative of the conversion.
Definition: simpleShape.cc:203
virtual void measure(afw::table::SourceRecord &measRecord, afw::image::Exposure< float > const &exposure) const
Called to measure a single child source in an image.
Definition: simpleShape.cc:388
Struct to hold the results of SimpleShape when we don't run it as a plugin.
Definition: simpleShape.h:204
geom::Point2D center
Measured first moments, or the input center if !recentroid.
Definition: simpleShape.h:207
SimpleShapeResult()
Constructor; initializes everything to Nan.
Definition: simpleShape.cc:310
Eigen::Matrix< double, 5, 5 > covariance
Matrix of uncertainties; ordered Ixx, Iyy, Ixy, Ix, Iy.
Definition: simpleShape.h:208
std::bitset< SimpleShape::N_FLAGS > flags
Definition: simpleShape.h:211
afw::geom::ellipses::Quadrupole ellipse
Measured second moments.
Definition: simpleShape.h:206
virtual void set(afw::table::BaseRecord &record, SimpleShapeResult const &value) const
Definition: simpleShape.cc:354
virtual SimpleShapeResult get(afw::table::BaseRecord const &record) const
Definition: simpleShape.cc:343
bool operator!=(SimpleShapeResultKey const &other) const
Definition: simpleShape.h:79
bool isValid() const
Return True if the key is valid.
Definition: simpleShape.cc:370
bool operator==(SimpleShapeResultKey const &other) const
Compare the FunctorKey for equality with another, using the underlying Keys.
Definition: simpleShape.cc:363
static SimpleShapeResultKey addFields(afw::table::Schema &schema, std::string const &name)
Definition: simpleShape.cc:319
lsst::meas::base::FlagHandler const & getFlagHandler() const
Definition: simpleShape.h:85
#define LSST_CONTROL_FIELD(NAME, TYPE, DOC)
A preprocessor macro used to define fields in C++ "control object" structs.
Definition: config.h:43
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
A base class for image defects.
afw::table::Key< double > weight
Simple class used to define and document flags The name and doc constitute the identity of the FlagDe...
Definition: FlagHandler.h:40