Loading [MathJax]/extensions/tex2jax.js
LSST Applications 28.0.0,g1653933729+a8ce1bb630,g1a997c3884+a8ce1bb630,g28da252d5a+5bd70b7e6d,g2bbee38e9b+638fca75ac,g2bc492864f+638fca75ac,g3156d2b45e+07302053f8,g347aa1857d+638fca75ac,g35bb328faa+a8ce1bb630,g3a166c0a6a+638fca75ac,g3e281a1b8c+7bbb0b2507,g4005a62e65+17cd334064,g414038480c+5b5cd4fff3,g41af890bb2+4ffae9de63,g4e1a3235cc+0f1912dca3,g6249c6f860+3c3976f90c,g80478fca09+46aba80bd6,g82479be7b0+77990446f6,g858d7b2824+78ba4d1ce1,g89c8672015+f667a5183b,g9125e01d80+a8ce1bb630,ga5288a1d22+2a6264e9ca,gae0086650b+a8ce1bb630,gb58c049af0+d64f4d3760,gc22bb204ba+78ba4d1ce1,gc28159a63d+638fca75ac,gcf0d15dbbd+32ddb6096f,gd6b7c0dfd1+3e339405e9,gda3e153d99+78ba4d1ce1,gda6a2b7d83+32ddb6096f,gdaeeff99f8+1711a396fd,gdd5a9049c5+b18c39e5e3,ge2409df99d+a5e4577cdc,ge33fd446bb+78ba4d1ce1,ge79ae78c31+638fca75ac,gf0baf85859+64e8883e75,gf5289d68f6+e1b046a8d7,gfa443fc69c+91d9ed1ecf,gfda6b12a05+8419469a56
LSST Data Management Base Package
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Modules Pages
Function2d.h
Go to the documentation of this file.
1// -*- LSST-C++ -*-
2/*
3 * Developed for the LSST Data Management System.
4 * This product includes software developed by the LSST Project
5 * (https://www.lsst.org).
6 * See the COPYRIGHT file at the top-level directory of this distribution
7 * for details of code ownership.
8 *
9 * This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation, either version 3 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program. If not, see <https://www.gnu.org/licenses/>.
21 */
22#ifndef LSST_AFW_MATH_POLYNOMIALS_Function2d_h_INCLUDED
23#define LSST_AFW_MATH_POLYNOMIALS_Function2d_h_INCLUDED
24
25#include "Eigen/Core"
28
29namespace lsst { namespace geom { namespace polynomials {
30
41template <typename Basis_>
42class Function2d {
43public:
44
45 using iterator = double *;
46 using const_iterator = double const *;
47
49 using Basis = Basis_;
50
52 using Workspace = typename Basis::Workspace;
53
55 explicit Function2d(Basis const & basis) :
56 _basis(basis),
57 _coefficients(Eigen::VectorXd::Zero(basis.size()))
58 {}
59
61 explicit Function2d(Basis const & basis, Eigen::VectorXd const & coefficients) :
62 _basis(basis),
63 _coefficients(coefficients)
64 {
65 assert(basis.size() == static_cast<std::size_t>(_coefficients.size()));
66 }
67
69 template <typename Iterator>
70 explicit Function2d(Basis const & basis, Iterator first, Iterator last) :
71 _basis(basis),
72 _coefficients(basis.size())
73 {
74 assert(std::distance(first, last) == static_cast<std::ptrdiff_t>(basis.size()));
75 std::copy(first, last, &_coefficients[0]);
76 }
77
79 Function2d(Function2d const &) = default;
80
82 Function2d(Function2d &&) = default;
83
85 Function2d & operator=(Function2d const &) = default;
86
89
91
92 iterator begin() { return _coefficients.data(); }
93 iterator end() { return begin() + size(); }
94 const_iterator cbegin() const { return _coefficients.data(); }
95 const_iterator cend() const { return begin() + size(); }
96 const_iterator begin() const { return _coefficients.data(); }
97 const_iterator end() const { return begin() + size(); }
99
101 Basis const & getBasis() const { return _basis; }
102
104 std::size_t size() const { return _basis.size(); }
105
107 Workspace makeWorkspace() const { return _basis.makeWorkspace(); }
108
110 double operator()(geom::Point2D const & point, SumMode mode=SumMode::FAST) const {
111 return _basis.sumWith(point, _coefficients, mode);
112 }
113
115 double operator()(geom::Point2D const & point, Workspace & workspace, SumMode mode=SumMode::FAST) const {
116 return _basis.sumWith(point, _coefficients, workspace, mode);
117 }
118
120
125 double & operator[](std::size_t n) { return begin()[n]; }
126 double const & operator[](std::size_t n) const { return begin()[n]; }
128
130
137 // Return a block view to ensure the caller only modify the values, not the size.
138 return _coefficients.head(size());
139 }
140 auto getCoefficients() const { return _coefficients.head(size()); }
142
147
148private:
149 Basis _basis;
150 Eigen::VectorXd _coefficients;
151};
152
154template <typename Basis>
155Function2d<Basis> makeFunction2d(Basis const & basis, Eigen::VectorXd const & coefficients) {
157}
158
160template <typename Basis, typename Iterator>
161Function2d<Basis> makeFunction2d(Basis const & basis, Iterator first, Iterator last) {
162 return Function2d<Basis>(basis, first, last);
163}
164
165}}} // namespace lsst::geom::polynomials
166
167#endif // !LSST_AFW_MATH_POLYNOMIALS_Function2d_h_INCLUDED
ndarray::Array< double const, 2, 2 > coefficients
table::Key< double > scaling
A 2-d function defined by a series expansion and its coefficients.
Function2d & operator=(Function2d const &)=default
Default copy assignment.
Function2d< typename Basis::Scaled > scaled(Scaling2d const &scaling) const
Return a new function that applies the given scaling to all points before evaluation.
Definition Function2d.h:144
Function2d(Basis const &basis)
Construct with zero-valued coefficients.
Definition Function2d.h:55
double & operator[](std::size_t n)
Return the coefficient associated with the nth basis function.
Definition Function2d.h:125
Basis const & getBasis() const
Return the associated Basis2d object.
Definition Function2d.h:101
double const & operator[](std::size_t n) const
Definition Function2d.h:126
const_iterator end() const
Definition Function2d.h:97
double operator()(geom::Point2D const &point, Workspace &workspace, SumMode mode=SumMode::FAST) const
Evaluate the function at the given point.
Definition Function2d.h:115
Function2d(Function2d const &)=default
Default copy constructor.
Function2d(Basis const &basis, Eigen::VectorXd const &coefficients)
Construct with coefficients from an Eigen object.
Definition Function2d.h:61
Function2d(Function2d &&)=default
Default move constructor.
const_iterator cbegin() const
Definition Function2d.h:94
const_iterator cend() const
Definition Function2d.h:95
Function2d(Basis const &basis, Iterator first, Iterator last)
Construct by copying coefficients from an STL iterator range.
Definition Function2d.h:70
Workspace makeWorkspace() const
Allocate workspace that can be passed to operator() to avoid repeated memory allocations.
Definition Function2d.h:107
auto getCoefficients()
Return the coefficient vector as an Eigen matrix-like object.
Definition Function2d.h:136
Basis_ Basis
The basis type used by this function.
Definition Function2d.h:49
iterator begin()
Iterators over coefficients.
Definition Function2d.h:92
typename Basis::Workspace Workspace
Type returned by makeWorkspace().
Definition Function2d.h:52
double operator()(geom::Point2D const &point, SumMode mode=SumMode::FAST) const
Evaluate the function at the given point.
Definition Function2d.h:110
const_iterator begin() const
Definition Function2d.h:96
std::size_t size() const
Return the number of coefficients.
Definition Function2d.h:104
Function2d & operator=(Function2d &&)=default
Default move assignment.
A 2-d separable affine transform that can be used to map one interval to another.
Definition Scaling2d.h:48
T copy(T... args)
T distance(T... args)
Function2d< Basis > makeFunction2d(Basis const &basis, Eigen::VectorXd const &coefficients)
Create a Function2d of the appropriate type from a Basis2d and an Eigen object containing coefficient...
Definition Function2d.h:155
SumMode
Enum used to control how to sum polynomial terms.
Definition SafeSum.h:32
@ FAST
Summation using regular floating-point addition.
table::Key< table::Array< double > > basis
Definition PsfexPsf.cc:365