LSST Applications
21.0.0-172-gfb10e10a+18fedfabac,22.0.0+297cba6710,22.0.0+80564b0ff1,22.0.0+8d77f4f51a,22.0.0+a28f4c53b1,22.0.0+dcf3732eb2,22.0.1-1-g7d6de66+2a20fdde0d,22.0.1-1-g8e32f31+297cba6710,22.0.1-1-geca5380+7fa3b7d9b6,22.0.1-12-g44dc1dc+2a20fdde0d,22.0.1-15-g6a90155+515f58c32b,22.0.1-16-g9282f48+790f5f2caa,22.0.1-2-g92698f7+dcf3732eb2,22.0.1-2-ga9b0f51+7fa3b7d9b6,22.0.1-2-gd1925c9+bf4f0e694f,22.0.1-24-g1ad7a390+a9625a72a8,22.0.1-25-g5bf6245+3ad8ecd50b,22.0.1-25-gb120d7b+8b5510f75f,22.0.1-27-g97737f7+2a20fdde0d,22.0.1-32-gf62ce7b1+aa4237961e,22.0.1-4-g0b3f228+2a20fdde0d,22.0.1-4-g243d05b+871c1b8305,22.0.1-4-g3a563be+32dcf1063f,22.0.1-4-g44f2e3d+9e4ab0f4fa,22.0.1-42-gca6935d93+ba5e5ca3eb,22.0.1-5-g15c806e+85460ae5f3,22.0.1-5-g58711c4+611d128589,22.0.1-5-g75bb458+99c117b92f,22.0.1-6-g1c63a23+7fa3b7d9b6,22.0.1-6-g50866e6+84ff5a128b,22.0.1-6-g8d3140d+720564cf76,22.0.1-6-gd805d02+cc5644f571,22.0.1-8-ge5750ce+85460ae5f3,master-g6e05de7fdc+babf819c66,master-g99da0e417a+8d77f4f51a,w.2021.48
LSST Data Management Base Package
|
Polynomial transformation class. More...
#include <AstrometryTransform.h>
Public Member Functions | |
AstrometryTransformPolynomial (std::size_t order=1) | |
Default transform : identity for all orders (>=1 ). More... | |
AstrometryTransformPolynomial (const AstrometryTransform *transform, const Frame &frame, std::size_t order, std::size_t nPoint=1000) | |
Constructs a "polynomial image" from an existing transform, over a specified domain. More... | |
AstrometryTransformPolynomial (std::shared_ptr< afw::geom::TransformPoint2ToPoint2 > transform, jointcal::Frame const &domain, std::size_t order, std::size_t nSteps=50) | |
Constructs a polynomial approximation to an afw::geom::TransformPoint2ToPoint2. More... | |
void | setOrder (std::size_t order) |
Sets the polynomial order (the highest sum of exponents of the largest monomial). More... | |
std::size_t | getOrder () const |
Returns the polynomial order. More... | |
void | apply (const double xIn, const double yIn, double &xOut, double &yOut) const override |
void | computeDerivative (Point const &where, AstrometryTransformLinear &derivative, const double step=0.01) const override |
specialised analytic routine More... | |
virtual void | transformPosAndErrors (const FatPoint &in, FatPoint &out) const override |
a mix of apply and Derivative More... | |
std::size_t | getNpar () const override |
total number of parameters More... | |
void | print (std::ostream &out) const override |
print out of coefficients in a readable form. More... | |
double | fit (StarMatchList const &starMatchList) override |
guess what More... | |
AstrometryTransformPolynomial | operator* (AstrometryTransformPolynomial const &right) const |
Composition (internal stuff in quadruple precision) More... | |
AstrometryTransformPolynomial | operator+ (AstrometryTransformPolynomial const &right) const |
Addition. More... | |
AstrometryTransformPolynomial | operator- (AstrometryTransformPolynomial const &right) const |
Subtraction. More... | |
std::unique_ptr< AstrometryTransform > | composeAndReduce (AstrometryTransformPolynomial const &right) const |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced. More... | |
std::unique_ptr< AstrometryTransform > | clone () const override |
returns a copy (allocated by new) of the transformation. More... | |
double | coeffOrZero (std::size_t powX, std::size_t powY, std::size_t whichCoord) const |
read access, zero if beyond order More... | |
double | determinant () const |
double | paramRef (Eigen::Index const i) const override |
double & | paramRef (Eigen::Index const i) override |
void | paramDerivatives (Point const &where, double *dx, double *dy) const override |
Derivative w.r.t parameters. More... | |
std::shared_ptr< ast::Mapping > | toAstMap (jointcal::Frame const &domain) const override |
Create an equivalent AST mapping for this transformation, including an analytic inverse if possible. More... | |
void | write (std::ostream &s) const override |
void | read (std::istream &s) |
virtual void | apply (const double xIn, const double yIn, double &xOut, double &yOut) const=0 |
void | apply (Point const &in, Point &out) const |
applies the tranfo to in and writes into out. Is indeed virtual. More... | |
Point | apply (Point const &in) const |
All these apply(..) shadow the virtual one in derived classes, unless one writes "using
AstrometryTransform::apply". More... | |
Frame | apply (Frame const &inputframe, bool inscribed) const |
Transform a bounding box, taking either the inscribed or circumscribed box. More... | |
virtual std::unique_ptr< AstrometryTransform > | composeAndReduce (AstrometryTransform const &right) const |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced. More... | |
void | apply (Point const &in, Point &out) const |
applies the tranfo to in and writes into out. Is indeed virtual. More... | |
Point | apply (Point const &in) const |
All these apply(..) shadow the virtual one in derived classes, unless one writes "using
AstrometryTransform::apply". More... | |
Frame | apply (Frame const &inputframe, bool inscribed) const |
Transform a bounding box, taking either the inscribed or circumscribed box. More... | |
std::string | __str__ () |
void | transformStar (FatPoint &in) const |
virtual double | getJacobian (Point const &point) const |
returns the local jacobian. More... | |
virtual double | getJacobian (const double x, const double y) const |
returns the local jacobian. More... | |
virtual std::unique_ptr< AstrometryTransform > | composeAndReduce (AstrometryTransform const &right) const |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced. More... | |
virtual AstrometryTransformLinear | linearApproximation (Point const &where, const double step=0.01) const |
linear (local) approximation. More... | |
virtual void | transformErrors (Point const &where, const double *vIn, double *vOut) const |
transform errors (represented as double[3] in order V(xx),V(yy),Cov(xy)) More... | |
virtual std::unique_ptr< AstrometryTransform > | inverseTransform (const double precision, const Frame ®ion) const |
returns an inverse transform. Numerical if not overloaded. More... | |
void | getParams (double *params) const |
params should be at least Npar() long More... | |
void | offsetParams (Eigen::VectorXd const &delta) |
virtual std::unique_ptr< AstrometryTransform > | roughInverse (const Frame ®ion) const |
Rough inverse. More... | |
void | write (const std::string &fileName) const |
double | getCoefficient (std::size_t powX, std::size_t powY, std::size_t whichCoord) const |
Get the coefficient of a given power in x and y, for either the x or y coordinate. More... | |
double & | getCoefficient (std::size_t powX, std::size_t powY, std::size_t whichCoord) |
Get the coefficient of a given power in x and y, for either the x or y coordinate. More... | |
Polynomial transformation class.
Definition at line 280 of file AstrometryTransform.h.
lsst::jointcal::AstrometryTransformPolynomial::AstrometryTransformPolynomial | ( | std::size_t | order = 1 | ) |
Default transform : identity for all orders (>=1 ).
Default transform : identity for all orders (>=1 )
order | The highest total power (x+y) of monomials of this polynomial. |
Definition at line 470 of file AstrometryTransform.cc.
lsst::jointcal::AstrometryTransformPolynomial::AstrometryTransformPolynomial | ( | const AstrometryTransform * | transform, |
const Frame & | frame, | ||
std::size_t | order, | ||
std::size_t | nPoint = 1000 |
||
) |
Constructs a "polynomial image" from an existing transform, over a specified domain.
Definition at line 483 of file AstrometryTransform.cc.
lsst::jointcal::AstrometryTransformPolynomial::AstrometryTransformPolynomial | ( | std::shared_ptr< afw::geom::TransformPoint2ToPoint2 > | transform, |
jointcal::Frame const & | domain, | ||
std::size_t | order, | ||
std::size_t | nSteps = 50 |
||
) |
Constructs a polynomial approximation to an afw::geom::TransformPoint2ToPoint2.
[in] | transform | The transform to be approximated. |
[in] | domain | The valid domain of the transform. |
[in] | order | The polynomial order to use when approximating. |
[in] | nSteps | The number of sample points per axis (nSteps^2 total points). |
Definition at line 505 of file AstrometryTransform.cc.
|
inlineinherited |
Definition at line 94 of file AstrometryTransform.h.
|
overridevirtual |
Implements lsst::jointcal::AstrometryTransform.
Definition at line 572 of file AstrometryTransform.cc.
virtual void lsst::jointcal::AstrometryTransform::apply |
|
inherited |
Transform a bounding box, taking either the inscribed or circumscribed box.
[in] | inputframe | The frame to be transformed. |
[in] | inscribed | Return the inscribed (true) or circumscribed (false) box. |
Definition at line 76 of file AstrometryTransform.cc.
Frame lsst::jointcal::AstrometryTransform::apply |
Transform a bounding box, taking either the inscribed or circumscribed box.
[in] | inputframe | The frame to be transformed. |
[in] | inscribed | Return the inscribed (true) or circumscribed (false) box. |
Definition at line 89 of file AstrometryTransform.cc.
All these apply(..) shadow the virtual one in derived classes, unless one writes "using AstrometryTransform::apply".
Definition at line 75 of file AstrometryTransform.h.
|
inline |
All these apply(..) shadow the virtual one in derived classes, unless one writes "using AstrometryTransform::apply".
Definition at line 75 of file AstrometryTransform.h.
|
inlineinherited |
applies the tranfo to in and writes into out. Is indeed virtual.
Definition at line 71 of file AstrometryTransform.h.
|
inline |
applies the tranfo to in and writes into out. Is indeed virtual.
Definition at line 71 of file AstrometryTransform.h.
|
inlineoverridevirtual |
returns a copy (allocated by new) of the transformation.
Implements lsst::jointcal::AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformLinear.
Definition at line 344 of file AstrometryTransform.h.
double lsst::jointcal::AstrometryTransformPolynomial::coeffOrZero | ( | std::size_t | powX, |
std::size_t | powY, | ||
std::size_t | whichCoord | ||
) | const |
read access, zero if beyond order
Definition at line 755 of file AstrometryTransform.cc.
|
virtualinherited |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced.
"Reduced" in this context means that they are capable of being merged into a single transform, for example, for two polynomials:
\[ f(x) = 1 + x^2, g(x) = -1 + 3x \]
we would have h = f.composeAndReduce(g) == 2 - 6x + 9x^2
.
To be overloaded by derived classes if they can properly reduce the composition.
right | The transform to apply first. |
Reimplemented in lsst::jointcal::AstrometryTransformIdentity.
Definition at line 94 of file AstrometryTransform.cc.
std::unique_ptr< AstrometryTransform > lsst::jointcal::AstrometryTransform::composeAndReduce |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced.
"Reduced" in this context means that they are capable of being merged into a single transform, for example, for two polynomials:
\[ f(x) = 1 + x^2, g(x) = -1 + 3x \]
we would have h = f.composeAndReduce(g) == 2 - 6x + 9x^2
.
To be overloaded by derived classes if they can properly reduce the composition.
right | The transform to apply first. |
Definition at line 131 of file AstrometryTransform.cc.
std::unique_ptr< AstrometryTransform > lsst::jointcal::AstrometryTransformPolynomial::composeAndReduce | ( | AstrometryTransformPolynomial const & | right | ) | const |
Return a reduced composition of newTransform = this(right()), or nullptr if it cannot be reduced.
"Reduced" in this context means that they are capable of being merged into a single transform, for example, for two polynomials:
\[ f(x) = 1 + x^2, g(x) = -1 + 3x \]
we would have h = f.composeAndReduce(g) == 2 - 6x + 9x^2
.
To be overloaded by derived classes if they can properly reduce the composition.
right | The transform to apply first. |
Definition at line 945 of file AstrometryTransform.cc.
|
overridevirtual |
specialised analytic routine
Reimplemented from lsst::jointcal::AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformLinear.
Definition at line 596 of file AstrometryTransform.cc.
double lsst::jointcal::AstrometryTransformPolynomial::determinant | ( | ) | const |
Definition at line 825 of file AstrometryTransform.cc.
|
overridevirtual |
guess what
Implements lsst::jointcal::AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformLinearRot, and lsst::jointcal::AstrometryTransformLinearShift.
Definition at line 927 of file AstrometryTransform.cc.
double & lsst::jointcal::AstrometryTransformPolynomial::getCoefficient | ( | std::size_t | powX, |
std::size_t | powY, | ||
std::size_t | whichCoord | ||
) |
Get the coefficient of a given power in x and y, for either the x or y coordinate.
Definition at line 749 of file AstrometryTransform.cc.
double lsst::jointcal::AstrometryTransformPolynomial::getCoefficient | ( | std::size_t | powX, |
std::size_t | powY, | ||
std::size_t | whichCoord | ||
) | const |
Get the coefficient of a given power in x and y, for either the x or y coordinate.
Definition at line 740 of file AstrometryTransform.cc.
|
virtualinherited |
|
inlinevirtualinherited |
returns the local jacobian.
Definition at line 110 of file AstrometryTransform.h.
|
inlineoverridevirtual |
total number of parameters
Reimplemented from lsst::jointcal::AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformLinearScale, lsst::jointcal::AstrometryTransformLinearRot, and lsst::jointcal::AstrometryTransformLinearShift.
Definition at line 321 of file AstrometryTransform.h.
|
inline |
Returns the polynomial order.
Definition at line 307 of file AstrometryTransform.h.
|
inherited |
params should be at least Npar() long
Definition at line 216 of file AstrometryTransform.cc.
|
virtualinherited |
returns an inverse transform. Numerical if not overloaded.
precision and region refer to the "input" side of this, and hence to the output side of the returned AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformInverse, lsst::jointcal::AstrometryTransformLinear, lsst::jointcal::TanRaDecToPixel, lsst::jointcal::TanSipPixelToRaDec, and lsst::jointcal::TanPixelToRaDec.
Definition at line 303 of file AstrometryTransform.cc.
|
virtualinherited |
linear (local) approximation.
Reimplemented in lsst::jointcal::AstrometryTransformLinear, and lsst::jointcal::AstrometryTransformIdentity.
Definition at line 136 of file AstrometryTransform.cc.
|
inherited |
Definition at line 221 of file AstrometryTransform.cc.
AstrometryTransformPolynomial lsst::jointcal::AstrometryTransformPolynomial::operator* | ( | AstrometryTransformPolynomial const & | right | ) | const |
Composition (internal stuff in quadruple precision)
Definition at line 1053 of file AstrometryTransform.cc.
AstrometryTransformPolynomial lsst::jointcal::AstrometryTransformPolynomial::operator+ | ( | AstrometryTransformPolynomial const & | right | ) | const |
AstrometryTransformPolynomial lsst::jointcal::AstrometryTransformPolynomial::operator- | ( | AstrometryTransformPolynomial const & | right | ) | const |
Subtraction.
Definition at line 1089 of file AstrometryTransform.cc.
|
overridevirtual |
Derivative w.r.t parameters.
Derivatives should be al least 2*NPar long. first Npar, for x, last Npar for y.
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 775 of file AstrometryTransform.cc.
|
overridevirtual |
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 765 of file AstrometryTransform.cc.
|
overridevirtual |
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 770 of file AstrometryTransform.cc.
|
overridevirtual |
print out of coefficients in a readable form.
Implements lsst::jointcal::AstrometryTransform.
Reimplemented in lsst::jointcal::AstrometryTransformLinear.
Definition at line 795 of file AstrometryTransform.cc.
void lsst::jointcal::AstrometryTransformPolynomial::read | ( | std::istream & | s | ) |
Definition at line 1115 of file AstrometryTransform.cc.
|
virtualinherited |
Rough inverse.
Stored by the numerical inverter to guess starting point for the trials. Just here to enable overloading.
Reimplemented in lsst::jointcal::TanRaDecToPixel, lsst::jointcal::TanPixelToRaDec, and lsst::jointcal::AstrometryTransformInverse.
Definition at line 195 of file AstrometryTransform.cc.
void lsst::jointcal::AstrometryTransformPolynomial::setOrder | ( | std::size_t | order | ) |
Sets the polynomial order (the highest sum of exponents of the largest monomial).
Definition at line 551 of file AstrometryTransform.cc.
|
overridevirtual |
Create an equivalent AST mapping for this transformation, including an analytic inverse if possible.
domain | The domain of the transform, to help find an inverse. |
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 1100 of file AstrometryTransform.cc.
|
virtualinherited |
transform errors (represented as double[3] in order V(xx),V(yy),Cov(xy))
Definition at line 162 of file AstrometryTransform.cc.
|
overridevirtual |
a mix of apply and Derivative
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 656 of file AstrometryTransform.cc.
|
inlineinherited |
Definition at line 107 of file AstrometryTransform.h.
|
inherited |
Definition at line 246 of file AstrometryTransform.cc.
|
overridevirtual |
Reimplemented from lsst::jointcal::AstrometryTransform.
Definition at line 1105 of file AstrometryTransform.cc.