LSST Applications  21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
Threshold.cc
Go to the documentation of this file.
1 /*
2  * LSST Data Management System
3  * Copyright 2008, 2009, 2010 LSST Corporation.
4  *
5  * This product includes software developed by the
6  * LSST Project (http://www.lsst.org/).
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the LSST License Statement and
19  * the GNU General Public License along with this program. If not,
20  * see <http://www.lsstcorp.org/LegalNotices/>.
21  */
22 #include <cstdint>
23 #include <cmath>
24 #include <string>
25 #include <boost/format.hpp>
26 #include "lsst/pex/exceptions.h"
27 #include "lsst/log/Log.h"
29 #include "lsst/afw/image/Image.h"
32 
33 namespace lsst {
34 namespace afw {
35 namespace detection {
36 
38  if (typeStr.compare("bitmask") == 0) {
39  return Threshold::BITMASK;
40  } else if (typeStr.compare("value") == 0) {
41  return Threshold::VALUE;
42  } else if (typeStr.compare("stdev") == 0) {
43  return Threshold::STDEV;
44  } else if (typeStr.compare("variance") == 0) {
45  return Threshold::VARIANCE;
46  } else if (typeStr.compare("pixel_stdev") == 0) {
48  } else {
50  (boost::format("Unsupported Threshold type: %s") % typeStr).str());
51  }
52 }
53 
55  if (type == VALUE) {
56  return "value";
57  } else if (type == STDEV) {
58  return "stdev";
59  } else if (type == VARIANCE) {
60  return "variance";
61  } else {
63  (boost::format("Unsopported Threshold type: %d") % type).str());
64  }
65 }
66 
67 double Threshold::getValue(const double param) const {
68  switch (_type) {
69  case STDEV:
70  if (param <= 0) {
72  (boost::format("St. dev. must be > 0: %g") % param).str());
73  }
74  return _value * param;
75  case VALUE:
76  case BITMASK:
77  case PIXEL_STDEV:
78  return _value;
79  case VARIANCE:
80  if (param <= 0) {
82  (boost::format("Variance must be > 0: %g") % param).str());
83  }
84  return _value * std::sqrt(param);
85  default:
87  (boost::format("Unsupported type: %d") % _type).str());
88  }
89 }
90 
91 template <typename ImageT>
92 double Threshold::getValue(ImageT const& image) const {
93  double param = -1; // Parameter for getValue()
94  if (_type == STDEV || _type == VARIANCE) {
96  double const sd = stats.getValue(math::STDEVCLIP);
97 
98  LOGL_DEBUG("lsst.afw.detection.threshold", "St. Dev = %g", sd);
99 
100  if (_type == VARIANCE) {
101  param = sd * sd;
102  } else {
103  param = sd;
104  }
105  }
106  return getValue(param);
107 }
108 
109 Threshold createThreshold(double const value, std::string const typeStr, bool const polarity) {
110  return Threshold(value, Threshold::parseTypeString(typeStr), polarity);
111 }
112 
113 //
114 // Explicit instantiations
115 //
116 #define INSTANTIATE(TYPE) \
117  template double Threshold::getValue(image::TYPE<unsigned short> const&) const; \
118  template double Threshold::getValue(image::TYPE<int> const&) const; \
119  template double Threshold::getValue(image::TYPE<float> const&) const; \
120  template double Threshold::getValue(image::TYPE<double> const&) const; \
121  template double Threshold::getValue(image::TYPE<std::uint64_t> const&) const;
122 
123 #ifndef DOXYGEN
124 INSTANTIATE(Image);
125 INSTANTIATE(MaskedImage);
126 #endif
127 } // namespace detection
128 } // namespace afw
129 } // namespace lsst
table::Key< int > type
Definition: Detector.cc:163
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
LSST DM logging module built on log4cxx.
#define LOGL_DEBUG(logger, message...)
Log a debug-level message using a varargs/printf style interface.
Definition: Log.h:515
#define INSTANTIATE(TYPE)
Definition: Threshold.cc:116
A Threshold is used to pass a threshold value to detection algorithms.
Definition: Threshold.h:43
static std::string getTypeString(ThresholdType const &type)
Definition: Threshold.cc:54
static ThresholdType parseTypeString(std::string const &typeStr)
Definition: Threshold.cc:37
double getValue(const double param=-1) const
return value of threshold, to be interpreted via type
Definition: Threshold.cc:67
ThresholdType
Types of threshold:
Definition: Threshold.h:46
@ VARIANCE
Use number of sigma given variance.
Definition: Threshold.h:50
@ VALUE
Use pixel value.
Definition: Threshold.h:47
@ PIXEL_STDEV
Use number of sigma given per-pixel s.d.
Definition: Threshold.h:51
@ STDEV
Use number of sigma given s.d.
Definition: Threshold.h:49
@ BITMASK
Use (pixels & (given mask))
Definition: Threshold.h:48
A class to evaluate image statistics.
Definition: Statistics.h:220
double getValue(Property const prop=NOTHING) const
Return the value of the desired property (if specified in the constructor)
Definition: Statistics.cc:1047
Reports invalid arguments.
Definition: Runtime.h:66
T compare(T... args)
Threshold createThreshold(const double value, const std::string type="value", const bool polarity=true)
Factory method for creating Threshold objects.
Definition: Threshold.cc:109
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
Statistics makeStatistics(lsst::afw::image::Image< Pixel > const &img, lsst::afw::image::Mask< image::MaskPixel > const &msk, int const flags, StatisticsControl const &sctrl=StatisticsControl())
Handle a watered-down front-end to the constructor (no variance)
Definition: Statistics.h:359
@ STDEVCLIP
estimate sample N-sigma clipped stdev (N set in StatisticsControl, default=3)
Definition: Statistics.h:72
def format(config, name=None, writeSourceLine=True, prefix="", verbose=False)
Definition: history.py:174
A base class for image defects.
T sqrt(T... args)