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
ImageAlgorithm.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 /*
26  * Support for functors over Image's pixels
27  */
28 #ifndef LSST_AFW_IMAGE_IMAGE_ALGORITHM_H
29 #define LSST_AFW_IMAGE_IMAGE_ALGORITHM_H
30 
31 #include <list>
32 #include <map>
33 #include <string>
34 #include <utility>
35 #include <functional>
36 
37 #include "boost/format.hpp"
38 #include <memory>
39 
40 #include "lsst/pex/exceptions.h"
41 
42 namespace lsst {
43 namespace afw {
44 namespace image {
48 template <typename ValT>
49 struct pixelOp0 : public std::function<ValT()> {
50  virtual ~pixelOp0() {}
51  virtual ValT operator()() const = 0;
52 };
53 
57 template <typename ValT>
58 struct pixelOp1 : public std::function<ValT(ValT)> {
59  virtual ~pixelOp1() {}
60  virtual ValT operator()(ValT lhs) const = 0;
61 };
62 
66 template <typename ValT>
67 struct pixelOp1XY : public std::function<ValT(int, int, ValT)> {
68  virtual ~pixelOp1XY() {}
69  virtual ValT operator()(int x, int y, ValT lhs) const = 0;
70 };
71 
75 template <typename LhsT, typename RhsT>
76 struct pixelOp2 : public std::function<LhsT(LhsT, RhsT)> {
77  virtual ~pixelOp2() {}
78  virtual LhsT operator()(LhsT lhs, RhsT rhs) const = 0;
79 };
80 
84 template <typename LhsT, typename RhsT>
85 struct pixelOp2XY : public std::function<LhsT(int, int, LhsT, RhsT)> {
86  virtual ~pixelOp2XY() {}
87  virtual LhsT operator()(int x, int y, LhsT lhs, RhsT rhs) const = 0;
88 };
89 
93 template <typename LhsT>
95  pixelOp0<LhsT> const& func
96 ) {
97  for (int y = 0; y != lhs.getHeight(); ++y) {
98  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
99  lhsPtr != lhsEnd; ++lhsPtr) {
100  *lhsPtr = func();
101  }
102  }
103 }
104 
108 template <typename LhsT>
110  pixelOp1<LhsT> const& func
111 ) {
112  for (int y = 0; y != lhs.getHeight(); ++y) {
113  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
114  lhsPtr != lhsEnd; ++lhsPtr) {
115  *lhsPtr = func(*lhsPtr);
116  }
117  }
118 }
119 
125 template <typename LhsT>
127  pixelOp1XY<LhsT> const& func
128 ) {
129  for (int y = 0; y != lhs.getHeight(); ++y) {
130  int x = lhs.getX0();
131  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
132  lhsPtr != lhsEnd; ++lhsPtr, ++x) {
133  *lhsPtr = func(x, y + lhs.getY0(), *lhsPtr);
134  }
135  }
136 }
137 
141 template <typename LhsT, typename RhsT>
143  Image<RhsT> const& rhs,
144  pixelOp1<RhsT> const& func
145 ) {
146  if (lhs.getDimensions() != rhs.getDimensions()) {
148  (boost::format("Images are of different size, %dx%d v %dx%d") % lhs.getWidth() %
149  lhs.getHeight() % rhs.getWidth() % rhs.getHeight())
150  .str());
151  }
152 
153  for (int y = 0; y != lhs.getHeight(); ++y) {
154  typename Image<RhsT>::const_x_iterator rhsPtr = rhs.row_begin(y);
155 
156  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
157  lhsPtr != lhsEnd; ++rhsPtr, ++lhsPtr) {
158  *lhsPtr = func(*rhsPtr);
159  }
160  }
161 }
162 
166 template <typename LhsT, typename RhsT>
168  Image<RhsT> const& rhs,
169  pixelOp2<LhsT, RhsT> const& func
170 ) {
171  if (lhs.getDimensions() != rhs.getDimensions()) {
173  (boost::format("Images are of different size, %dx%d v %dx%d") % lhs.getWidth() %
174  lhs.getHeight() % rhs.getWidth() % rhs.getHeight())
175  .str());
176  }
177 
178  for (int y = 0; y != lhs.getHeight(); ++y) {
179  typename Image<RhsT>::const_x_iterator rhsPtr = rhs.row_begin(y);
180 
181  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
182  lhsPtr != lhsEnd; ++rhsPtr, ++lhsPtr) {
183  *lhsPtr = func(*lhsPtr, *rhsPtr);
184  }
185  }
186 }
192 template <typename LhsT, typename RhsT>
194  Image<RhsT> const& rhs,
195  pixelOp2XY<LhsT, RhsT> const& func
196 ) {
197  if (lhs.getDimensions() != rhs.getDimensions()) {
199  (boost::format("Images are of different size, %dx%d v %dx%d") % lhs.getWidth() %
200  lhs.getHeight() % rhs.getWidth() % rhs.getHeight())
201  .str());
202  }
203 
204  for (int y = 0; y != lhs.getHeight(); ++y) {
205  typename Image<RhsT>::const_x_iterator rhsPtr = rhs.row_begin(y);
206  int x = lhs.getX0();
207  for (typename Image<LhsT>::x_iterator lhsPtr = lhs.row_begin(y), lhsEnd = lhs.row_end(y);
208  lhsPtr != lhsEnd; ++rhsPtr, ++lhsPtr, ++x) {
209  *lhsPtr = func(x, y + lhs.getY0(), *lhsPtr, *rhsPtr);
210  }
211  }
212 }
213 } // namespace image
214 } // namespace afw
215 } // namespace lsst
216 
217 #endif
double x
#define LSST_EXCEPT(type,...)
Create an exception with a given type.
Definition: Exception.h:48
int y
Definition: SpanSet.cc:48
int getX0() const
Return the image's column-origin.
Definition: ImageBase.h:306
typename _const_view_t::x_iterator const_x_iterator
A const iterator for traversing the pixels in a row.
Definition: ImageBase.h:141
int getWidth() const
Return the number of columns in the image.
Definition: ImageBase.h:294
int getY0() const
Return the image's row-origin.
Definition: ImageBase.h:314
lsst::geom::Extent2I getDimensions() const
Return the image's size; useful for passing to constructors.
Definition: ImageBase.h:356
int getHeight() const
Return the number of rows in the image.
Definition: ImageBase.h:296
x_iterator row_begin(int y) const
Return an x_iterator to the start of the y'th row.
Definition: ImageBase.h:401
x_iterator row_end(int y) const
Return an x_iterator to the end of the y'th row.
Definition: ImageBase.h:404
typename _view_t::x_iterator x_iterator
An iterator for traversing the pixels in a row.
Definition: ImageBase.h:133
A class to represent a 2-dimensional array of pixels.
Definition: Image.h:51
Reports attempts to exceed implementation-defined length limits for some classes.
Definition: Runtime.h:76
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
void for_each_pixel(Image< LhsT > &lhs, pixelOp0< LhsT > const &func)
Set each pixel in an Image<LhsT> to func()
def format(config, name=None, writeSourceLine=True, prefix="", verbose=False)
Definition: history.py:174
A base class for image defects.
A functor class equivalent to std::function<ValT ()>, but with a virtual operator()
virtual ValT operator()() const =0
A functor class equivalent to std::function<ValT (ValT)>, but with a virtual operator()
virtual ValT operator()(ValT lhs) const =0
A functor class equivalent to std::function<ValT (int, int, ValT)>, but with a virtual operator()
virtual ValT operator()(int x, int y, ValT lhs) const =0
A functor class equivalent to std::function<LhsT (LhsT, RhsT)>, but with a virtual operator()
virtual LhsT operator()(LhsT lhs, RhsT rhs) const =0
A functor class equivalent to std::function<LhsT (int, int, LhsT, RhsT)>, but with a virtual operator...
virtual LhsT operator()(int x, int y, LhsT lhs, RhsT rhs) const =0