LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
LSSTDataManagementBasePackage
RandomImage.cc
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 /*
26  * Fill Images with Random numbers
27  */
28 #include "lsst/afw/image/Image.h"
30 #include "lsst/afw/math/Random.h"
31 
32 namespace lsst {
33 namespace afw {
34 namespace math {
35 
36 namespace {
37 
38 template <typename T>
39 struct do_random : public lsst::afw::image::pixelOp0<T> {
40  do_random(Random &rand) : _rand(rand) {}
41 
42 protected:
43  Random &_rand;
44 };
45 
46 template <typename T>
47 struct do_uniform : public do_random<T> {
48  do_uniform(Random &rand) : do_random<T>(rand) {}
49 
50  T operator()() const override { return do_random<T>::_rand.uniform(); }
51 };
52 
53 template <typename T>
54 struct do_uniformPos : public do_random<T> {
55  do_uniformPos(Random &rand) : do_random<T>(rand) {}
56 
57  T operator()() const override { return do_random<T>::_rand.uniformPos(); }
58 };
59 
60 template <typename T>
61 struct do_uniformInt : public do_random<T> {
62  do_uniformInt(Random &rand, unsigned long n) : do_random<T>(rand), _n(n) {}
63 
64  T operator()() const override { return do_random<T>::_rand.uniformInt(_n); }
65 
66 private:
67  unsigned long _n;
68 };
69 
70 template <typename T>
71 struct do_flat : public do_random<T> {
72  do_flat(Random &rand, double const a, double const b) : do_random<T>(rand), _a(a), _b(b) {}
73 
74  T operator()() const override { return do_random<T>::_rand.flat(_a, _b); }
75 
76 private:
77  double const _a;
78  double const _b;
79 };
80 
81 template <typename T>
82 struct do_gaussian : public do_random<T> {
83  do_gaussian(Random &rand) : do_random<T>(rand) {}
84 
85  T operator()() const override { return do_random<T>::_rand.gaussian(); }
86 };
87 
88 template <typename T>
89 struct do_chisq : public do_random<T> {
90  do_chisq(Random &rand, double nu) : do_random<T>(rand), _nu(nu) {}
91 
92  T operator()() const override { return do_random<T>::_rand.chisq(_nu); }
93 
94 private:
95  double const _nu;
96 };
97 
98 template <typename T>
99 struct do_poisson : public do_random<T> {
100  do_poisson(Random &rand, double mu) : do_random<T>(rand), _mu(mu) {}
101 
102  T operator()() const override { return do_random<T>::_rand.poisson(_mu); }
103 
104 private:
105  double const _mu;
106 };
107 } // namespace
108 
109 template <typename ImageT>
110 void randomUniformImage(ImageT *image, Random &rand) {
111  lsst::afw::image::for_each_pixel(*image, do_uniform<typename ImageT::Pixel>(rand));
112 }
113 
114 template <typename ImageT>
115 void randomUniformPosImage(ImageT *image, Random &rand) {
116  lsst::afw::image::for_each_pixel(*image, do_uniformPos<typename ImageT::Pixel>(rand));
117 }
118 
119 template <typename ImageT>
120 void randomUniformIntImage(ImageT *image, Random &rand, unsigned long n) {
121  lsst::afw::image::for_each_pixel(*image, do_uniformInt<typename ImageT::Pixel>(rand, n));
122 }
123 
124 template <typename ImageT>
125 void randomFlatImage(ImageT *image, Random &rand, double const a, double const b) {
126  lsst::afw::image::for_each_pixel(*image, do_flat<typename ImageT::Pixel>(rand, a, b));
127 }
128 
129 template <typename ImageT>
130 void randomGaussianImage(ImageT *image, Random &rand) {
131  lsst::afw::image::for_each_pixel(*image, do_gaussian<typename ImageT::Pixel>(rand));
132 }
133 
134 template <typename ImageT>
135 void randomChisqImage(ImageT *image, Random &rand, double const nu) {
136  lsst::afw::image::for_each_pixel(*image, do_chisq<typename ImageT::Pixel>(rand, nu));
137 }
138 
139 template <typename ImageT>
140 void randomPoissonImage(ImageT *image, Random &rand, double const mu) {
141  lsst::afw::image::for_each_pixel(*image, do_poisson<typename ImageT::Pixel>(rand, mu));
142 }
143 
144 //
145 // Explicit instantiations
146 //
148 #define INSTANTIATE(T) \
149  template void randomUniformImage(lsst::afw::image::Image<T> *image, Random &rand); \
150  template void randomUniformPosImage(lsst::afw::image::Image<T> *image, Random &rand); \
151  template void randomUniformIntImage(lsst::afw::image::Image<T> *image, Random &rand, unsigned long n); \
152  template void randomFlatImage(lsst::afw::image::Image<T> *image, Random &rand, double const a, \
153  double const b); \
154  template void randomGaussianImage(lsst::afw::image::Image<T> *image, Random &rand); \
155  template void randomChisqImage(lsst::afw::image::Image<T> *image, Random &rand, double const nu); \
156  template void randomPoissonImage(lsst::afw::image::Image<T> *image, Random &rand, double const mu);
157 
158 INSTANTIATE(double)
159 INSTANTIATE(float)
161 } // namespace math
162 } // namespace afw
163 } // namespace lsst
lsst::afw::image
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
Definition: imageAlgorithm.dox:1
ImageAlgorithm.h
lsst::afw
Definition: imageAlgorithm.dox:1
INSTANTIATE
#define INSTANTIATE(FROMSYS, TOSYS)
Definition: Detector.cc:484
Image.h
lsst::afw::math::randomFlatImage
void randomFlatImage(ImageT *image, Random &rand, double const a, double const b)
Set image to random numbers uniformly distributed in the range [a, b)
Definition: RandomImage.cc:125
lsst::afw::image::pixelOp0
A functor class equivalent to std::function<ValT ()>, but with a virtual operator()
Definition: ImageAlgorithm.h:52
_rand
Random & _rand
Definition: RandomImage.cc:43
lsst::afw::math::randomUniformPosImage
void randomUniformPosImage(ImageT *image, Random &rand)
Set image to random numbers uniformly distributed in the range (0, 1)
Definition: RandomImage.cc:115
lsst::afw::math::randomGaussianImage
void randomGaussianImage(ImageT *image, Random &rand)
Set image to random numbers with a gaussian N(0, 1) distribution.
Definition: RandomImage.cc:130
b
table::Key< int > b
Definition: TransmissionCurve.cc:467
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
std::rand
T rand(T... args)
lsst::afw::image::for_each_pixel
void for_each_pixel(Image< LhsT > &lhs, pixelOp0< LhsT > const &func)
Set each pixel in an Image<LhsT> to func()
Definition: ImageAlgorithm.h:97
lsst::afw::math::randomChisqImage
void randomChisqImage(ImageT *image, Random &rand, double const nu)
Set image to random numbers with a chi^2_{nu} distribution.
Definition: RandomImage.cc:135
lsst::afw::math::Random
A class that can be used to generate sequences of random numbers according to a number of different a...
Definition: Random.h:57
a
table::Key< int > a
Definition: TransmissionCurve.cc:466
lsst::afw::math::randomUniformIntImage
void randomUniformIntImage(ImageT *image, Random &rand, unsigned long n)
Set image to random integers uniformly distributed in the range 0 ...
Definition: RandomImage.cc:120
Random.h
lsst::afw::math::randomUniformImage
void randomUniformImage(ImageT *image, Random &rand)
Set image to random numbers uniformly distributed in the range [0, 1)
Definition: RandomImage.cc:110
lsst::afw::math::randomPoissonImage
void randomPoissonImage(ImageT *image, Random &rand, double const mu)
Set image to random numbers with a Poisson distribution with mean mu (n.b.
Definition: RandomImage.cc:140