LSSTApplications  20.0.0
LSSTDataManagementBasePackage
_peak.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 
26 #include <memory>
27 #include <sstream>
28 
29 #include "lsst/utils/python.h"
30 
36 
37 namespace py = pybind11;
38 using namespace py::literals;
39 
40 namespace lsst {
41 namespace afw {
42 namespace detection {
43 
44 namespace {
45 
46 using PyPeakRecord = py::class_<PeakRecord, std::shared_ptr<PeakRecord>, table::BaseRecord>;
47 using PyPeakTable = py::class_<PeakTable, std::shared_ptr<PeakTable>, table::BaseTable>;
48 
52 void declarePeakRecord(PyPeakRecord &cls) {
53  cls.def("getTable", &PeakRecord::getTable);
54  cls.def_property_readonly("table", &PeakRecord::getTable);
55  cls.def("getId", &PeakRecord::getId);
56  cls.def("setId", &PeakRecord::setId);
57  cls.def("getIx", &PeakRecord::getIx);
58  cls.def("getIy", &PeakRecord::getIy);
59  cls.def("setIx", &PeakRecord::setIx);
60  cls.def("setIy", &PeakRecord::setIy);
61  cls.def("getI", &PeakRecord::getI);
62  cls.def("getCentroid", (lsst::geom::Point2I(PeakRecord::*)(bool) const) & PeakRecord::getCentroid);
63  cls.def("getCentroid", (lsst::geom::Point2D(PeakRecord::*)() const) & PeakRecord::getCentroid);
64  cls.def("getFx", &PeakRecord::getFx);
65  cls.def("getFy", &PeakRecord::getFy);
66  cls.def("setFx", &PeakRecord::setFx);
67  cls.def("setFy", &PeakRecord::setFy);
68  cls.def("getF", &PeakRecord::getF);
69  cls.def("getPeakValue", &PeakRecord::getPeakValue);
70  cls.def("setPeakValue", &PeakRecord::setPeakValue);
71  utils::python::addOutputOp(cls, "__str__");
72  utils::python::addOutputOp(cls, "__repr__");
73 }
74 
78 void declarePeakTable(PyPeakTable &cls) {
79  cls.def_static("make", &PeakTable::make, "schema"_a, "forceNew"_a = false);
80  cls.def_static("makeMinimalSchema", &PeakTable::makeMinimalSchema);
81  cls.def_static("checkSchema", &PeakTable::checkSchema, "schema"_a);
82  cls.def("getIdFactory", (std::shared_ptr<table::IdFactory>(PeakTable::*)()) & PeakTable::getIdFactory);
83  cls.def("setIdFactory", &PeakTable::setIdFactory, "factory"_a);
84  cls.def_static("getIdKey", &PeakTable::getIdKey);
85  cls.def_static("getIxKey", &PeakTable::getIxKey);
86  cls.def_static("getIyKey", &PeakTable::getIyKey);
87  cls.def_static("getFxKey", &PeakTable::getFxKey);
88  cls.def_static("getFyKey", &PeakTable::getFyKey);
89  cls.def_static("getPeakValueKey", &PeakTable::getPeakValueKey);
90  cls.def("clone", &PeakTable::clone);
91  cls.def("makeRecord", &PeakTable::makeRecord);
92  cls.def("copyRecord", (std::shared_ptr<PeakRecord>(PeakTable::*)(afw::table::BaseRecord const &)) &
93  PeakTable::copyRecord);
94  cls.def("copyRecord", (std::shared_ptr<PeakRecord>(PeakTable::*)(afw::table::BaseRecord const &,
95  afw::table::SchemaMapper const &)) &
96  PeakTable::copyRecord);
97 }
98 
99 } // namespace
100 
102  wrappers.addInheritanceDependency("lsst.afw.table");
103 
104  auto clsPeakRecord = wrappers.wrapType(PyPeakRecord(wrappers.module, "PeakRecord"),
105  [](auto &mod, auto &cls) { declarePeakRecord(cls); });
106  auto clsPeakTable = wrappers.wrapType(PyPeakTable(wrappers.module, "PeakTable"),
107  [](auto &mod, auto &cls) { declarePeakTable(cls); });
108 
109  auto clsPeakColumnView = table::python::declareColumnView<PeakRecord>(wrappers, "Peak");
110  auto clsPeakCatalog = table::python::declareCatalog<PeakRecord>(wrappers, "Peak");
111 
112  clsPeakRecord.attr("Table") = clsPeakTable;
113  clsPeakRecord.attr("ColumnView") = clsPeakColumnView;
114  clsPeakRecord.attr("Catalog") = clsPeakCatalog;
115  clsPeakTable.attr("Record") = clsPeakRecord;
116  clsPeakTable.attr("ColumnView") = clsPeakColumnView;
117  clsPeakTable.attr("Catalog") = clsPeakCatalog;
118  clsPeakCatalog.attr("Record") = clsPeakRecord;
119  clsPeakCatalog.attr("Table") = clsPeakTable;
120  clsPeakCatalog.attr("ColumnView") = clsPeakColumnView;
121 }
122 
123 } // namespace detection
124 } // namespace afw
125 } // namespace 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
std::shared_ptr
STL class.
lsst::utils::python::WrapperCollection::addInheritanceDependency
void addInheritanceDependency(std::string const &name)
Indicate an external module that provides a base class for a subsequent addType call.
Definition: python.h:343
lsst::afw
Definition: imageAlgorithm.dox:1
lsst::afw::geom.transform.transformContinued.cls
cls
Definition: transformContinued.py:33
BaseRecord.h
lsst::utils::python::WrapperCollection::wrapType
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
columnView.h
lsst::utils::python::WrapperCollection
A helper class for subdividing pybind11 module across multiple translation units (i....
Definition: python.h:242
catalog.h
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
python.h
Peak.h
lsst::geom::Point< int, 2 >
BaseTable.h
pybind11
Definition: _GenericMap.cc:40
lsst::utils::python::WrapperCollection::module
pybind11::module module
The module object passed to the PYBIND11_MODULE block that contains this WrapperCollection.
Definition: python.h:448
lsst::afw::image.slicing.clone
clone
Definition: slicing.py:257
lsst::afw::detection::wrapPeak
void wrapPeak(WrapperCollection &)
Definition: _peak.cc:101