LSST Applications g070148d5b3+33e5256705,g0d53e28543+25c8b88941,g0da5cf3356+2dd1178308,g1081da9e2a+62d12e78cb,g17e5ecfddb+7e422d6136,g1c76d35bf8+ede3a706f7,g295839609d+225697d880,g2e2c1a68ba+cc1f6f037e,g2ffcdf413f+853cd4dcde,g38293774b4+62d12e78cb,g3b44f30a73+d953f1ac34,g48ccf36440+885b902d19,g4b2f1765b6+7dedbde6d2,g5320a0a9f6+0c5d6105b6,g56b687f8c9+ede3a706f7,g5c4744a4d9+ef6ac23297,g5ffd174ac0+0c5d6105b6,g6075d09f38+66af417445,g667d525e37+2ced63db88,g670421136f+2ced63db88,g71f27ac40c+2ced63db88,g774830318a+463cbe8d1f,g7876bc68e5+1d137996f1,g7985c39107+62d12e78cb,g7fdac2220c+0fd8241c05,g96f01af41f+368e6903a7,g9ca82378b8+2ced63db88,g9d27549199+ef6ac23297,gabe93b2c52+e3573e3735,gb065e2a02a+3dfbe639da,gbc3249ced9+0c5d6105b6,gbec6a3398f+0c5d6105b6,gc9534b9d65+35b9f25267,gd01420fc67+0c5d6105b6,geee7ff78d7+a14128c129,gf63283c776+ede3a706f7,gfed783d017+0c5d6105b6,w.2022.47
LSST Data Management Base Package
Loading...
Searching...
No Matches
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