LSSTApplications  20.0.0
LSSTDataManagementBasePackage
boundedField.cc
Go to the documentation of this file.
1 /*
2  * LSST Data Management System
3  * Copyright 2008-2016 AURA/LSST.
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 <https://www.lsstcorp.org/LegalNotices/>.
21  */
22 
23 #include <pybind11/pybind11.h>
24 #include <pybind11/stl.h>
25 
26 #include <memory>
27 
28 #include "ndarray/pybind11.h"
29 
30 #include "lsst/utils/python.h"
31 
33 #include "lsst/geom/Point.h"
35 #include "lsst/afw/table/io/python.h" // for addPersistableMethods
36 
37 namespace py = pybind11;
38 
39 using namespace lsst::afw::math;
40 using namespace py::literals;
41 
42 namespace lsst {
43 namespace afw {
44 namespace math {
45 namespace {
46 
47 using PyClass = py::class_<BoundedField, std::shared_ptr<BoundedField>>;
48 
49 template <typename PixelT>
51  cls.def("fillImage", &BoundedField::fillImage<PixelT>,
52  "image"_a, "overlapOnly"_a = false, "xStep"_a = 1, "yStep"_a = 1);
53  cls.def("addToImage", &BoundedField::addToImage<PixelT>, "image"_a, "scaleBy"_a = 1.0,
54  "overlapOnly"_a = false, "xStep"_a = 1, "yStep"_a = 1);
55  cls.def("multiplyImage", &BoundedField::multiplyImage<PixelT>,
56  "image"_a, "overlapOnly"_a = false, "xStep"_a = 1, "yStep"_a = 1);
57  cls.def("divideImage", &BoundedField::divideImage<PixelT>,
58  "image"_a, "overlapOnly"_a = false, "xStep"_a = 1, "yStep"_a = 1);
59 }
60 
61 PYBIND11_MODULE(boundedField, mod) {
62  PyClass cls(mod, "BoundedField");
63 
64  table::io::python::addPersistableMethods<BoundedField>(cls);
65 
66  cls.def("__rmul__", [](BoundedField &bf, double const scale) { return bf * scale; }, py::is_operator());
67  cls.def("__mul__", &BoundedField::operator*, py::is_operator());
68  cls.def("__truediv__", &BoundedField::operator/, py::is_operator());
69  cls.def("__eq__", &BoundedField::operator==, py::is_operator());
70  cls.def("__ne__", &BoundedField::operator!=, py::is_operator());
71 
72  cls.def("evaluate", (double (BoundedField::*)(double, double) const) & BoundedField::evaluate);
73  cls.def("evaluate",
74  (ndarray::Array<double, 1, 1> (BoundedField::*)(ndarray::Array<double const, 1> const &,
75  ndarray::Array<double const, 1> const &) const) &
77  cls.def("evaluate",
78  (double (BoundedField::*)(lsst::geom::Point2D const &) const) & BoundedField::evaluate);
79  cls.def("integrate", &BoundedField::integrate);
80  cls.def("mean", &BoundedField::mean);
81  cls.def("getBBox", &BoundedField::getBBox);
82 
83  // Pybind11 resolves overloads by picking the first one that might work
84  declareTemplates<double>(cls);
85  declareTemplates<float>(cls);
86 
87  utils::python::addOutputOp(cls, "__str__");
88  cls.def("__repr__", [](BoundedField const &self) {
90  os << "BoundedField(" << self << ")";
91  return os.str();
92  });
93 }
94 
95 } // <anonymous>
96 } // math
97 } // afw
98 } // lsst
lsst::utils::python::addOutputOp
void addOutputOp(PyClass &cls, std::string const &method)
Add __str__ or __repr__ method implemented by operator<<.
Definition: python.h:87
lsst::afw::math::BoundedField
An abstract base class for 2-d functions defined on an integer bounding boxes.
Definition: BoundedField.h:55
declareTemplates
void declareTemplates(ClsField &cls)
Definition: chebyshevBoundedField.cc:44
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::math::PYBIND11_MODULE
PYBIND11_MODULE(approximate, mod)
Definition: approximate.cc:56
lsst::afw::geom.transform.transformContinued.cls
cls
Definition: transformContinued.py:33
lsst::afw::math::BoundedField::mean
virtual double mean() const
Compute the mean of this function over its bounding-box.
Definition: BoundedField.cc:51
PyClass
py::class_< ProductBoundedField, std::shared_ptr< ProductBoundedField >, BoundedField > PyClass
Definition: productBoundedField.cc:32
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
python.h
lsst::afw::math::BoundedField::evaluate
virtual double evaluate(lsst::geom::Point2D const &position) const =0
Evaluate the field at the given point.
lsst::afw::math::BoundedField::getBBox
lsst::geom::Box2I getBBox() const
Return the bounding box that defines the region where the field is valid.
Definition: BoundedField.h:112
std::ostringstream
STL class.
os
std::ostream * os
Definition: Schema.cc:746
python.h
Persistable.h
lsst::afw::math
Definition: statistics.dox:6
lsst::geom::Point< double, 2 >
lsst::afw.display.ds9.scale
def scale(algorithm, min, max=None, frame=None)
Definition: ds9.py:109
pybind11
Definition: _GenericMap.cc:40
Point.h
BoundedField.h
lsst::afw::math::BoundedField::integrate
virtual double integrate() const
Compute the integral of this function over its bounding-box.
Definition: BoundedField.cc:49