LSSTApplications
18.0.0+106,18.0.0+50,19.0.0,19.0.0+1,19.0.0+10,19.0.0+11,19.0.0+13,19.0.0+17,19.0.0+2,19.0.0-1-g20d9b18+6,19.0.0-1-g425ff20,19.0.0-1-g5549ca4,19.0.0-1-g580fafe+6,19.0.0-1-g6fe20d0+1,19.0.0-1-g7011481+9,19.0.0-1-g8c57eb9+6,19.0.0-1-gb5175dc+11,19.0.0-1-gdc0e4a7+9,19.0.0-1-ge272bc4+6,19.0.0-1-ge3aa853,19.0.0-10-g448f008b,19.0.0-12-g6990b2c,19.0.0-2-g0d9f9cd+11,19.0.0-2-g3d9e4fb2+11,19.0.0-2-g5037de4,19.0.0-2-gb96a1c4+3,19.0.0-2-gd955cfd+15,19.0.0-3-g2d13df8,19.0.0-3-g6f3c7dc,19.0.0-4-g725f80e+11,19.0.0-4-ga671dab3b+1,19.0.0-4-gad373c5+3,19.0.0-5-ga2acb9c+2,19.0.0-5-gfe96e6c+2,w.2020.01
LSSTDataManagementBasePackage
|
A basis formed from a linear combination of shapelet bases that differ only in radius. More...
#include <MultiShapeletBasis.h>
Public Types | |
typedef MultiShapeletBasisComponent | Component |
typedef std::vector< Component > | ComponentVector |
typedef ComponentVector::const_iterator | Iterator |
Public Member Functions | |
MultiShapeletBasis (int size) | |
Construct a MultiShapeletBasis with the given number of elements (i.e. free amplitudes). More... | |
int | getSize () const |
Return the number of elements (i.e. free amplitudes) in the MultiShapeletBasis. More... | |
int | getComponentCount () const |
Return the number of components (distinct shapelet bases) in the MultiShapeletBasis. More... | |
void | addComponent (double radius, int order, ndarray::Array< double const, 2, 2 > const &matrix) |
Add a new component (shapelet basis) to the MultiShapeletBasis. More... | |
void | scale (double factor) |
Multiply the radius of all basis elements by the given factor. More... | |
void | normalize () |
Rescale all matrices so each element has unit flux. More... | |
void | merge (MultiShapeletBasis const &other) |
Combine the given basis with this (in place), by appending its elements. More... | |
MultiShapeletFunction | makeFunction (afw::geom::ellipses::Ellipse const &ellipse, ndarray::Array< double const, 1, 1 > const &coefficients) const |
Create a MultiShapeletFunction from the basis. More... | |
Iterator | begin () const |
Iterator over the components (distinct shapelet bases) of the MultiShapeletBasis. More... | |
Iterator | end () const |
Iterator over the components (distinct shapelet bases) of the MultiShapeletBasis. More... | |
A basis formed from a linear combination of shapelet bases that differ only in radius.
A MultiShapeletBasis can have many "components" (shapelet bases with different orders and radii), which are mapped via matrices into one or more "elements". It's common for a basis to have only one or two elements, representing a galaxy model that is a linear combination of one or two radial profiles. It's also common for most components to be zeroth order (Gaussians), as higher- order shapelet terms don't provide much of an advantage when approximating axisymmetric functions.
MultiShapeletBasis itself provides the interface to define these multi-Gaussian approximations and combine and refine them, and delegates the work of defining them to MultiShapeletFunction (via the makeFunction() method) and the MultiShapeletMatrixBuilder class. MultiShapeletFunction is a more user-friendly and versatile approach, intended for debugging and testing, while the MultiShapletMatrixBuilder approach is intended for performance-critical evaluation of PSF-convolved MultiShapeletBasis objects.
Definition at line 93 of file MultiShapeletBasis.h.
Definition at line 95 of file MultiShapeletBasis.h.
Definition at line 96 of file MultiShapeletBasis.h.
typedef ComponentVector::const_iterator lsst::shapelet::MultiShapeletBasis::Iterator |
Definition at line 97 of file MultiShapeletBasis.h.
|
explicit |
Construct a MultiShapeletBasis with the given number of elements (i.e. free amplitudes).
void lsst::shapelet::MultiShapeletBasis::addComponent | ( | double | radius, |
int | order, | ||
ndarray::Array< double const, 2, 2 > const & | matrix | ||
) |
Add a new component (shapelet basis) to the MultiShapeletBasis.
Should usually only be called by MultiShapeletBasis::addComponent.
[in] | radius | Radius of the shapelet expansion defined by this component. |
[in] | order | Order of the shapelet expansion. |
[in] | matrix | Matrix whose elements [i,j] map MultiShapeletBasis elements j to shapelet terms i; must have dimensions [computeSize(order), basis.getSize()], where "basis" is the MultiShapeletBasis this component is attached to. Will be deep-copied by the constructor. |
Note that matrix elements follow the amplitude convention defined by ShapeletFunction; values are proportional to flux, not surface brightness.
|
inline |
Iterator over the components (distinct shapelet bases) of the MultiShapeletBasis.
Definition at line 110 of file MultiShapeletBasis.h.
|
inline |
Iterator over the components (distinct shapelet bases) of the MultiShapeletBasis.
Definition at line 111 of file MultiShapeletBasis.h.
|
inline |
Return the number of components (distinct shapelet bases) in the MultiShapeletBasis.
Definition at line 106 of file MultiShapeletBasis.h.
|
inline |
Return the number of elements (i.e. free amplitudes) in the MultiShapeletBasis.
Definition at line 103 of file MultiShapeletBasis.h.
MultiShapeletFunction lsst::shapelet::MultiShapeletBasis::makeFunction | ( | afw::geom::ellipses::Ellipse const & | ellipse, |
ndarray::Array< double const, 1, 1 > const & | coefficients | ||
) | const |
Create a MultiShapeletFunction from the basis.
[in] | ellipse | Shapelet basis ellipse that will define the MultiShapeletFunction (will be scaled by the radius of each component). |
[in] | coefficients | Coefficients of the basis elements. |
void lsst::shapelet::MultiShapeletBasis::merge | ( | MultiShapeletBasis const & | other | ) |
Combine the given basis with this (in place), by appending its elements.
void lsst::shapelet::MultiShapeletBasis::normalize | ( | ) |
Rescale all matrices so each element has unit flux.
void lsst::shapelet::MultiShapeletBasis::scale | ( | double | factor | ) |
Multiply the radius of all basis elements by the given factor.