LSST Applications  21.0.0+04719a4bac,21.0.0-1-ga51b5d4+4b710797af,21.0.0-1-gfc31b0f+3b24369756,21.0.0-10-g2408eff+50e97f2f47,21.0.0-10-g560fb7b+0803ad37c5,21.0.0-10-g5daeb2b+f9b8dc6d5a,21.0.0-10-g8d1d15d+77a6b82ebf,21.0.0-10-gcf60f90+c961be884d,21.0.0-11-g25eff31+7692554667,21.0.0-17-g6590b197+a14a01c114,21.0.0-2-g103fe59+b79afc2051,21.0.0-2-g1367e85+1003a3501c,21.0.0-2-g45278ab+04719a4bac,21.0.0-2-g5242d73+1003a3501c,21.0.0-2-g7f82c8f+c2a1919b98,21.0.0-2-g8f08a60+fd0b970de5,21.0.0-2-ga326454+c2a1919b98,21.0.0-2-gde069b7+ca45a81b40,21.0.0-2-gecfae73+afcaaec585,21.0.0-2-gfc62afb+1003a3501c,21.0.0-21-g5d80ea29e+5e3c9a3766,21.0.0-3-g357aad2+c67f36f878,21.0.0-3-g4be5c26+1003a3501c,21.0.0-3-g65f322c+02b1f88459,21.0.0-3-g7d9da8d+3b24369756,21.0.0-3-ge02ed75+a423c2ae7a,21.0.0-4-g591bb35+a423c2ae7a,21.0.0-4-g65b4814+0803ad37c5,21.0.0-4-g88306b8+199c7497e5,21.0.0-4-gccdca77+a631590478,21.0.0-4-ge8a399c+b923ff878e,21.0.0-5-gd00fb1e+d8b1e95daa,21.0.0-53-ge728e5d5+3cb64fea8e,21.0.0-6-g2d4f3f3+04719a4bac,21.0.0-7-g04766d7+8d320c19d5,21.0.0-7-g98eecf7+205433fbda,21.0.0-9-g39e06b5+a423c2ae7a,master-gac4afde19b+a423c2ae7a,w.2021.11
LSST Data Management Base Package
filter.cc
Go to the documentation of this file.
1 /*
2  * This file is part of afw.
3  *
4  * Developed for the LSST Data Management System.
5  * This product includes software developed by the LSST Project
6  * (https://www.lsst.org).
7  * See the COPYRIGHT file at the top-level directory of this distribution
8  * for details of code ownership.
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 GNU General Public License
21  * along with this program. If not, see <https://www.gnu.org/licenses/>.
22  */
23 
24 #include "pybind11/pybind11.h"
25 #include "pybind11/stl.h"
26 #include "lsst/utils/python.h"
27 
28 #include <cmath>
31 #include "lsst/afw/image/Filter.h"
32 
33 namespace py = pybind11;
34 using namespace pybind11::literals;
35 
36 namespace lsst {
37 namespace afw {
38 namespace image {
39 namespace {
40 
41 using PyFilterProperty = py::class_<FilterProperty, std::shared_ptr<FilterProperty>>;
42 
43 using PyFilter = py::class_<Filter, std::shared_ptr<Filter>, typehandling::Storable>;
44 
45 void wrapFilterProperty(lsst::utils::python::WrapperCollection &wrappers) {
46  wrappers.wrapType(PyFilterProperty(wrappers.module, "FilterProperty"), [](auto &mod,
47  auto &clsFilterProperty) {
48  clsFilterProperty.def(py::init<std::string const &, double, double, double, bool>(), "name"_a,
49  "lambdaEff"_a, "lambdaMin"_a = NAN, "lambdaMax"_a = NAN, "force"_a = false);
50  // note: metadata should be defaulted with "metadata"_a=daf::base::PropertySet()
51  // but that causes an error about copying when the Python extension is imported
52  clsFilterProperty.def(py::init<std::string const &, daf::base::PropertySet const &, bool>(), "name"_a,
53  "metadata"_a, "force"_a = false);
54  clsFilterProperty.def(
55  "__eq__",
56  [](FilterProperty const &self, FilterProperty const &other) { return self == other; },
57  py::is_operator());
58  clsFilterProperty.def(
59  "__ne__",
60  [](FilterProperty const &self, FilterProperty const &other) { return self != other; },
61  py::is_operator());
62  clsFilterProperty.def("getName", &FilterProperty::getName);
63  clsFilterProperty.def("getLambdaEff", &FilterProperty::getLambdaEff);
64  clsFilterProperty.def("getLambdaMin", &FilterProperty::getLambdaMin);
65  clsFilterProperty.def("getLambdaMax", &FilterProperty::getLambdaMax);
66  clsFilterProperty.def_static("reset", &FilterProperty::reset);
67  clsFilterProperty.def_static("lookup", &FilterProperty::lookup, "name"_a);
68  });
69 }
70 void wrapFilter(lsst::utils::python::WrapperCollection &wrappers) {
71  wrappers.wrapType(PyFilter(wrappers.module, "Filter"), [](auto &mod, auto &clsFilter) {
72  clsFilter.def(py::init<std::string const &, bool const>(), "name"_a, "force"_a = false);
73  clsFilter.def(py::init<int>(), "id"_a = Filter::UNKNOWN);
74  clsFilter.def(py::init<std::shared_ptr<daf::base::PropertySet const>, bool const>(), "metadata"_a,
75  "force"_a = false);
76  clsFilter.def(
77  "__eq__", [](Filter const &self, Filter const &other) { return self == other; },
78  py::is_operator());
79  clsFilter.def(
80  "__ne__", [](Filter const &self, Filter const &other) { return self != other; },
81  py::is_operator());
82  clsFilter.def_readonly_static("AUTO", &Filter::AUTO);
83  clsFilter.def_readonly_static("UNKNOWN", &Filter::UNKNOWN);
84  clsFilter.def("getId", &Filter::getId);
85  clsFilter.def("getName", &Filter::getName);
86  clsFilter.def("getCanonicalName", &Filter::getCanonicalName);
87  clsFilter.def("getAliases", &Filter::getAliases);
88  clsFilter.def("getFilterProperty", &Filter::getFilterProperty);
89  clsFilter.def_static("reset", &Filter::reset);
90  clsFilter.def_static("define", &Filter::define, "filterProperty"_a, "id"_a = Filter::AUTO,
91  "force"_a = false);
92  clsFilter.def_static("defineAlias", &Filter::defineAlias, "oldName"_a, "newName"_a,
93  "force"_a = false);
94  clsFilter.def_static("getNames", &Filter::getNames);
95  });
96 }
97 
98 PYBIND11_MODULE(filter, mod) {
99  lsst::utils::python::WrapperCollection wrappers(mod, "lsst.afw.image.filter");
100  wrappers.addSignatureDependency("lsst.daf.base");
101  wrappers.addInheritanceDependency("lsst.afw.typehandling");
102  wrapFilterProperty(wrappers);
103  wrapFilter(wrappers);
104  wrappers.wrap(
105  [](auto &mod) { mod.def("stripFilterKeywords", &detail::stripFilterKeywords, "metadata"_a); });
106  wrappers.finish();
107 }
108 } // namespace
109 } // namespace image
110 } // namespace afw
111 } // namespace lsst
ItemVariant const * other
Definition: Schema.cc:56
A helper class for subdividing pybind11 module across multiple translation units (i....
Definition: python.h:242
pybind11::module module
The module object passed to the PYBIND11_MODULE block that contains this WrapperCollection.
Definition: python.h:448
void finish()
Invoke all deferred wrapper-declaring callables.
Definition: python.h:435
PyType wrapType(PyType cls, ClassWrapperCallback function, bool setModuleName=true)
Add a type (class or enum) wrapper, deferring method and other attribute definitions until finish() i...
Definition: python.h:391
void addInheritanceDependency(std::string const &name)
Indicate an external module that provides a base class for a subsequent addType call.
Definition: python.h:343
void wrap(WrapperCallback function)
Add a set of wrappers without defining a class.
Definition: python.h:369
void addSignatureDependency(std::string const &name)
Indicate an external module that provides a type used in function/method signatures.
Definition: python.h:357
PYBIND11_MODULE(imageUtils, mod)
Definition: imageUtils.cc:33
int stripFilterKeywords(std::shared_ptr< lsst::daf::base::PropertySet > metadata)
Remove Filter-related keywords from the metadata.
Definition: Filter.cc:132
Backwards-compatibility support for depersisting the old Calib (FluxMag0/FluxMag0Err) objects.
double getLambdaMin() const noexcept
Return the filter's minimum wavelength (nm) where the transmission is above 1% of the maximum.
Definition: Filter.h:86
std::string const & getName() const noexcept
Return a filter's name.
Definition: Filter.h:78
double getLambdaEff() const noexcept
Return the filter's effective wavelength (nm)
Definition: Filter.h:82
double getLambdaMax() const noexcept
Return the filter's maximum wavelength (nm) where the transmission is above 1% of the maximum.
Definition: Filter.h:90
FilterProperty(FilterProperty const &)=default
A base class for image defects.