Loading [MathJax]/extensions/tex2jax.js
LSST Applications g04a91732dc+a3f7a6a005,g07dc498a13+5ab4d22ec3,g0fba68d861+870ee37b31,g1409bbee79+5ab4d22ec3,g1a7e361dbc+5ab4d22ec3,g1fd858c14a+11200c7927,g20f46db602+25d63fd678,g35bb328faa+fcb1d3bbc8,g4d2262a081+cc8af5cafb,g4d39ba7253+6b9d64fe03,g4e0f332c67+5d362be553,g53246c7159+fcb1d3bbc8,g60b5630c4e+6b9d64fe03,g78460c75b0+2f9a1b4bcd,g786e29fd12+cf7ec2a62a,g7b71ed6315+fcb1d3bbc8,g8048e755c2+a1301e4c20,g8852436030+a750987b4a,g89139ef638+5ab4d22ec3,g89e1512fd8+a86d53a4aa,g8d6b6b353c+6b9d64fe03,g9125e01d80+fcb1d3bbc8,g989de1cb63+5ab4d22ec3,g9f33ca652e+38ca901d1a,ga9baa6287d+6b9d64fe03,gaaedd4e678+5ab4d22ec3,gabe3b4be73+1e0a283bba,gb1101e3267+aa269f591c,gb58c049af0+f03b321e39,gb90eeb9370+af74afe682,gc741bbaa4f+7f5db660ea,gcf25f946ba+a750987b4a,gd315a588df+b78635c672,gd6cbbdb0b4+c8606af20c,gd9a9a58781+fcb1d3bbc8,gde0f65d7ad+5839af1903,ge278dab8ac+932305ba37,ge82c20c137+76d20ab76d,w.2025.11
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
_psf.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 <memory>
25
26#include <pybind11/pybind11.h>
27
30
33#include "lsst/geom/Point.h"
35#include "lsst/afw/table/io/python.h" // for addPersistableMethods
39
40namespace py = pybind11;
41using namespace pybind11::literals;
42
44
45namespace lsst {
46namespace afw {
47namespace detection {
48
49
51 wrappers.addInheritanceDependency("lsst.afw.typehandling");
52 wrappers.addSignatureDependency("lsst.afw.geom.ellipses");
53 wrappers.addSignatureDependency("lsst.afw.image");
54 wrappers.addSignatureDependency("lsst.afw.fits");
55
56 auto cls = wrappers.wrapException<InvalidPsfError, pex::exceptions::InvalidParameterError>("InvalidPsfError",
57 "InvalidParameterError");
58 cls.def(py::init<std::string const &>());
59
60 auto clsPsf = wrappers.wrapType(
62 wrappers.module, "Psf"
63 ),
64 [](auto& mod, auto& cls) {
65 table::io::python::addPersistableMethods<Psf>(cls);
66 cls.def(py::init<bool, size_t>(), "isFixed"_a=false, "capacity"_a=100); // Constructor for pure-Python subclasses
67 cls.def("clone", &Psf::clone);
68 cls.def("resized", &Psf::resized, "width"_a, "height"_a);
69
70 cls.def("computeImage",
71 &Psf::computeImage,
72 "position"_a,
73 "color"_a = image::Color(),
74 "owner"_a = Psf::ImageOwnerEnum::COPY
75 );
76 cls.def("computeKernelImage",
77 &Psf::computeKernelImage,
78 "position"_a,
79 "color"_a = image::Color(),
80 "owner"_a = Psf::ImageOwnerEnum::COPY
81 );
82 cls.def("computePeak",
83 &Psf::computePeak,
84 "position"_a,
85 "color"_a = image::Color()
86 );
87 cls.def("computeApertureFlux",
88 &Psf::computeApertureFlux,
89 "radius"_a,
90 "position"_a,
91 "color"_a = image::Color()
92 );
93 cls.def("computeShape",
94 &Psf::computeShape,
95 "position"_a,
96 "color"_a = image::Color()
97 );
98 cls.def("computeBBox",
99 &Psf::computeBBox,
100 "position"_a,
101 "color"_a = image::Color()
102 );
103 cls.def("computeImageBBox",
104 &Psf::computeImageBBox,
105 "position"_a,
106 "color"_a = image::Color()
107 );
108 cls.def("computeKernelBBox",
109 &Psf::computeKernelBBox,
110 "position"_a,
111 "color"_a = image::Color()
112 );
113 cls.def("getLocalKernel",
114 &Psf::getLocalKernel,
115 "position"_a,
116 "color"_a = image::Color()
117 );
118
119 cls.def("getAverageColor", &Psf::getAverageColor);
120 cls.def("getAveragePosition", &Psf::getAveragePosition);
121 cls.def_static("recenterKernelImage", &Psf::recenterKernelImage, "im"_a, "position"_a,
122 "warpAlgorithm"_a = "lanczos5", "warpBuffer"_a = 5);
123 cls.def("getCacheCapacity", &Psf::getCacheCapacity);
124 cls.def("setCacheCapacity", &Psf::setCacheCapacity);
125 }
126 );
127
128 wrappers.wrapType(py::enum_<Psf::ImageOwnerEnum>(clsPsf, "ImageOwnerEnum"), [](auto& mod, auto& enm) {
129 enm.value("COPY", Psf::ImageOwnerEnum::COPY);
130 enm.value("INTERNAL", Psf::ImageOwnerEnum::INTERNAL);
131 enm.export_values();
132 });
133}
134
135} // namespace detection
136} // namespace afw
137} // namespace lsst
An exception thrown when we have an invalid PSF.
Definition Psf.h:52
A polymorphic base class for representing an image's Point Spread Function.
Definition Psf.h:82
@ COPY
The image will be copied before returning; caller will own it.
Definition Psf.h:93
@ INTERNAL
An internal image will be returned without copying.
Definition Psf.h:94
"Trampoline" for Psf to let it be used as a base class in Python.
Definition python.h:50
Interface supporting iteration over heterogenous containers.
Definition Storable.h:58
A shared pointer that tracks both a C++ object and its associated PyObject.
Definition PySharedPtr.h:49
A helper class for subdividing pybind11 module across multiple translation units (i....
Definition python.h:242
void addSignatureDependency(std::string const &name)
Indicate an external module that provides a type used in function/method signatures.
Definition python.h:357
void addInheritanceDependency(std::string const &name)
Indicate an external module that provides a base class for a subsequent addType call.
Definition python.h:343
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
pybind11::module module
The module object passed to the PYBIND11_MODULE block that contains this WrapperCollection.
Definition python.h:448
auto wrapException(std::string const &pyName, std::string const &pyBase, bool setModuleName=true)
Wrap a C++ exception as a Python exception.
Definition python.h:421
Reports invalid arguments.
Definition Runtime.h:66
void wrapPsf(WrapperCollection &)
Definition _psf.cc:50