LSST Applications g0b6bd0c080+a72a5dd7e6,g1182afd7b4+2a019aa3bb,g17e5ecfddb+2b8207f7de,g1d67935e3f+06cf436103,g38293774b4+ac198e9f13,g396055baef+6a2097e274,g3b44f30a73+6611e0205b,g480783c3b1+98f8679e14,g48ccf36440+89c08d0516,g4b93dc025c+98f8679e14,g5c4744a4d9+a302e8c7f0,g613e996a0d+e1c447f2e0,g6c8d09e9e7+25247a063c,g7271f0639c+98f8679e14,g7a9cd813b8+124095ede6,g9d27549199+a302e8c7f0,ga1cf026fa3+ac198e9f13,ga32aa97882+7403ac30ac,ga786bb30fb+7a139211af,gaa63f70f4e+9994eb9896,gabf319e997+ade567573c,gba47b54d5d+94dc90c3ea,gbec6a3398f+06cf436103,gc6308e37c7+07dd123edb,gc655b1545f+ade567573c,gcc9029db3c+ab229f5caf,gd01420fc67+06cf436103,gd877ba84e5+06cf436103,gdb4cecd868+6f279b5b48,ge2d134c3d5+cc4dbb2e3f,ge448b5faa6+86d1ceac1d,gecc7e12556+98f8679e14,gf3ee170dca+25247a063c,gf4ac96e456+ade567573c,gf9f5ea5b4d+ac198e9f13,gff490e6085+8c2580be5c,w.2022.27
LSST Data Management Base Package
photometryModels.cc
Go to the documentation of this file.
1// -*- LSST-C++ -*-
2/*
3 * This file is part of jointcal.
4 *
5 * Developed for the LSST Data Management System.
6 * This product includes software developed by the LSST Project
7 * (https://www.lsst.org).
8 * See the COPYRIGHT file at the top-level directory of this distribution
9 * for details of code ownership.
10 *
11 * This program is free software: you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation, either version 3 of the License, or
14 * (at your option) any later version.
15 *
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
20 *
21 * You should have received a copy of the GNU General Public License
22 * along with this program. If not, see <https://www.gnu.org/licenses/>.
23 */
24
25#include "pybind11/pybind11.h"
26#include "pybind11/eigen.h"
27#include "pybind11/stl.h"
28#include "ndarray/pybind11.h"
29#include "ndarray/eigen.h"
30#include "Eigen/Core"
31
32#include "lsst/utils/python.h"
33
36#include "lsst/jointcal/Point.h"
39
40namespace py = pybind11;
41using namespace pybind11::literals;
42
43namespace lsst {
44namespace jointcal {
45namespace {
46
47void declarePhotometryModel(py::module &mod) {
48 py::class_<PhotometryModel, std::shared_ptr<PhotometryModel>> cls(mod, "PhotometryModel");
49
50 cls.def("assignIndices", &PhotometryModel::assignIndices);
51 cls.def("freezeErrorTransform", &PhotometryModel::freezeErrorTransform);
52
53 cls.def("offsetParams", &PhotometryModel::offsetParams);
54 cls.def("offsetFittedStar", &PhotometryModel::offsetFittedStar);
55
56 cls.def("transform", &PhotometryModel::transform);
57 cls.def("transformError", &PhotometryModel::transformError);
58 cls.def("computeResidual", &PhotometryModel::computeResidual);
59
60 cls.def("getRefError", &PhotometryModel::getRefError);
61 cls.def("computeRefResidual", &PhotometryModel::computeRefResidual);
62
63 cls.def("checkPositiveOnBBox", &PhotometryModel::checkPositiveOnBBox);
64 cls.def("validate", &PhotometryModel::validate);
65
66 cls.def("getMappingIndices", &PhotometryModel::getMappingIndices);
67 cls.def("computeParameterDerivatives",
68 [](PhotometryModel const &self, MeasuredStar const &star, CcdImage const &ccdImage) {
69 Eigen::VectorXd derivatives(self.getNpar(ccdImage));
70 self.computeParameterDerivatives(star, ccdImage, derivatives);
71 return derivatives;
72 });
73
74 cls.def("getNpar", &PhotometryModel::getNpar);
75 cls.def("toPhotoCalib", &PhotometryModel::toPhotoCalib);
76 cls.def("getMapping", &PhotometryModel::getMapping, py::return_value_policy::reference_internal);
77 cls.def("getTotalParameters", &PhotometryModel::getTotalParameters);
78
79 utils::python::addOutputOp(cls, "__repr__");
80 cls.def("__str__", [](PhotometryModel const &self) { return "PhotometryModel"; });
81}
82
83void declareSimplePhotometryModel(py::module &mod) {
84 py::class_<SimplePhotometryModel, std::shared_ptr<SimplePhotometryModel>, PhotometryModel> cls(
85 mod, "SimplePhotometryModel");
86 cls.def("__str__", [](SimplePhotometryModel const &self) { return "SimplePhotometryModel"; });
87}
88
89void declareSimpleFluxModel(py::module &mod) {
90 py::class_<SimpleFluxModel, std::shared_ptr<SimpleFluxModel>, SimplePhotometryModel, PhotometryModel> cls(
91 mod, "SimpleFluxModel");
92 cls.def(py::init<CcdImageList const &, double>(), "ccdImageList"_a, "errorPedestal"_a = 0);
93
94 cls.def("__str__", [](SimpleFluxModel const &self) { return "SimpleFluxModel"; });
95}
96
97void declareSimpleMagnitudeModel(py::module &mod) {
98 py::class_<SimpleMagnitudeModel, std::shared_ptr<SimpleMagnitudeModel>, SimplePhotometryModel,
99 PhotometryModel>
100 cls(mod, "SimpleMagnitudeModel");
101 cls.def(py::init<CcdImageList const &, double>(), "ccdImageList"_a, "errorPedestal"_a = 0);
102
103 cls.def("__str__", [](SimpleMagnitudeModel const &self) { return "SimpleMagnitudeModel"; });
104}
105
106void declareConstrainedPhotometryModel(py::module &mod) {
107 py::class_<ConstrainedPhotometryModel, std::shared_ptr<ConstrainedPhotometryModel>, PhotometryModel> cls(
108 mod, "ConstrainedPhotometryModel");
109 cls.def("__str__", [](ConstrainedPhotometryModel const &self) { return "ConstrainedPhotometryModel"; });
110}
111
112void declareConstrainedFluxModel(py::module &mod) {
113 py::class_<ConstrainedFluxModel, std::shared_ptr<ConstrainedFluxModel>, PhotometryModel> cls(
114 mod, "ConstrainedFluxModel");
115 cls.def(py::init<CcdImageList const &, lsst::geom::Box2D const &, int, double>(), "CcdImageList"_a,
116 "bbox"_a, "visitOrder"_a = 7, "errorPedestal"_a = 0);
117 cls.def("__str__", [](ConstrainedFluxModel const &self) { return "ConstrainedFluxModel"; });
118}
119
120void declareConstrainedMagnitudeModel(py::module &mod) {
121 py::class_<ConstrainedMagnitudeModel, std::shared_ptr<ConstrainedMagnitudeModel>, PhotometryModel> cls(
122 mod, "ConstrainedMagnitudeModel");
123 cls.def(py::init<CcdImageList const &, lsst::geom::Box2D const &, int, double>(), "CcdImageList"_a,
124 "bbox"_a, "visitOrder"_a = 7, "errorPedestal"_a = 0);
125 cls.def("__str__", [](ConstrainedMagnitudeModel const &self) { return "ConstrainedMagnitudeModel"; });
126}
127
128PYBIND11_MODULE(photometryModels, mod) {
129 py::module::import("lsst.jointcal.ccdImage");
130 py::module::import("lsst.jointcal.photometryTransform");
131 py::module::import("lsst.jointcal.star");
132 declarePhotometryModel(mod);
133 declareSimplePhotometryModel(mod);
134 declareSimpleFluxModel(mod);
135 declareSimpleMagnitudeModel(mod);
136 declareConstrainedPhotometryModel(mod);
137 declareConstrainedFluxModel(mod);
138 declareConstrainedMagnitudeModel(mod);
139}
140} // namespace
141} // namespace jointcal
142} // namespace lsst
virtual std::size_t getTotalParameters() const =0
Return the total number of parameters in this model.
virtual Eigen::Index assignIndices(std::string const &whatToFit, Eigen::Index firstIndex)=0
Assign indices in the full matrix to the parameters being fit in the mappings, starting at firstIndex...
virtual void offsetParams(Eigen::VectorXd const &delta)=0
Offset the parameters by the provided amounts (by -delta).
virtual double transform(CcdImage const &ccdImage, MeasuredStar const &measuredStar) const =0
Return the on-sky transformed flux for measuredStar on ccdImage.
virtual double getRefError(RefStar const &refStar) const =0
Return the refStar error appropriate for this model (e.g. fluxErr or magErr).
bool validate(CcdImageList const &ccdImageList, int ndof) const
Return true if this is a "reasonable" model.
PhotometryMappingBase const & getMapping(CcdImage const &ccdImage) const
Get the mapping associated with ccdImage.
virtual void offsetFittedStar(FittedStar &fittedStar, double delta) const =0
Offset the appropriate flux or magnitude (by -delta).
virtual void freezeErrorTransform()=0
Once this routine has been called, the error transform is not modified by offsetParams().
virtual double computeResidual(CcdImage const &ccdImage, MeasuredStar const &measuredStar) const =0
Compute the residual between the model applied to a star and its associated fittedStar.
std::size_t getNpar(CcdImage const &ccdImage) const
Return the number of parameters in the mapping of CcdImage.
virtual void getMappingIndices(CcdImage const &ccdImage, IndexVector &indices) const =0
Get how this set of parameters (of length Npar()) map into the "grand" fit.
virtual std::shared_ptr< afw::image::PhotoCalib > toPhotoCalib(CcdImage const &ccdImage) const =0
Return the mapping of ccdImage represented as a PhotoCalib.
bool checkPositiveOnBBox(CcdImage const &ccdImage) const
Check that the model is positive on the ccdImage bbox.
virtual double computeRefResidual(FittedStar const &fittedStar, RefStar const &refStar) const =0
Return the fittedStar - refStar residual appropriate for this model (e.g. flux - flux or mag - mag).
virtual double transformError(CcdImage const &ccdImage, MeasuredStar const &measuredStar) const =0
Return the on-sky transformed flux uncertainty for measuredStar on ccdImage.
PYBIND11_MODULE(_cameraGeom, mod)
Definition: _cameraGeom.cc:38
void addOutputOp(PyClass &cls, std::string const &method)
Add __str__ or __repr__ method implemented by operator<<.
Definition: python.h:87
A base class for image defects.