lsst.jointcal
14.0-17-ge3cc87b+5
|
a virtual (interface) class for geometric transformations. More...
#include <Gtransfo.h>
Public Member Functions | |
virtual void | apply (const double xIn, const double yIn, double &xOut, double &yOut) const =0 |
void | apply (const Point &in, Point &out) const |
applies the tranfo to in and writes into out. Is indeed virtual. More... | |
Point | apply (const Point &in) const |
All these apply(..) shadow the virtual one in derived classes, unless one writes "using
Gtransfo::apply". More... | |
virtual void | dump (std::ostream &stream=std::cout) const =0 |
dumps the transfo coefficients to stream. More... | |
std::string | __str__ () |
virtual double | fit (const StarMatchList &starMatchList)=0 |
fits a transfo to a std::list of Point pairs (p1,p2, the Point fields in StarMatch). More... | |
void | transformStar (FatPoint &in) const |
allows to write MyTransfo(MyStar) More... | |
virtual double | getJacobian (const Point &point) const |
returns the local jacobian. More... | |
virtual std::unique_ptr< Gtransfo > | clone () const =0 |
returns a copy (allocated by new) of the transformation. More... | |
virtual std::unique_ptr< Gtransfo > | reduceCompo (const Gtransfo *right) const |
to be overloaded by derived classes if they can really "reduce" the composition (e.g. More... | |
virtual double | getJacobian (const double x, const double y) const |
returns the local jacobian. More... | |
virtual void | computeDerivative (const Point &where, GtransfoLin &derivative, const double step=0.01) const |
Computes the local Derivative of a transfo, w.r.t. More... | |
virtual GtransfoLin | linearApproximation (const Point &where, const double step=0.01) const |
linear (local) approximation. More... | |
virtual void | transformPosAndErrors (const FatPoint &in, FatPoint &out) const |
virtual void | transformErrors (const Point &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< Gtransfo > | inverseTransfo (const double precision, const Frame ®ion) const |
returns an inverse transfo. 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 double | paramRef (const int i) const |
virtual double & | paramRef (const int i) |
virtual void | paramDerivatives (const Point &where, double *dx, double *dy) const |
Derivative w.r.t parameters. More... | |
virtual std::unique_ptr< Gtransfo > | roughInverse (const Frame ®ion) const |
Rough inverse. More... | |
virtual int | getNpar () const |
returns the number of parameters (to compute chi2's) More... | |
void | write (const std::string &fileName) const |
virtual void | write (std::ostream &stream) const |
virtual | ~Gtransfo () |
a virtual (interface) class for geometric transformations.
We implement here One Gtransfo interface class, and actual derived classes. Composition in the usual (mathematical) sense is provided using gtransfoCompose(), and some classes (e.g. GtransfoLin) handle a * operator. Generic inversion by iteration exists, but it is at least 10 times slower than the corresponding "direct transformation". If a transfo has an analytical inverse, then providing inverseTransfo is obviously a very good idea. Before resorting to inverseTransfo, consider using StarMatchList::inverseTransfo(). GtransfoLin::invert() and TanPix2RaDec::invert() exist. The classes also provide derivation and linear approximation.
Definition at line 39 of file Gtransfo.h.
|
inlinevirtual |
Definition at line 136 of file Gtransfo.h.
|
inline |
Definition at line 58 of file Gtransfo.h.
|
pure virtual |
applies the tranfo to in and writes into out. Is indeed virtual.
Definition at line 45 of file Gtransfo.h.
All these apply(..) shadow the virtual one in derived classes, unless one writes "using Gtransfo::apply".
Definition at line 49 of file Gtransfo.h.
|
pure virtual |
returns a copy (allocated by new) of the transformation.
Implemented in lsst::jointcal::UserTransfo, lsst::jointcal::TanRaDec2Pix, lsst::jointcal::TanSipPix2RaDec, lsst::jointcal::TanPix2RaDec, lsst::jointcal::GtransfoComposition, lsst::jointcal::GtransfoLin, lsst::jointcal::GtransfoPoly, lsst::jointcal::GtransfoInverse, and lsst::jointcal::GtransfoIdentity.
|
virtual |
Computes the local Derivative of a transfo, w.r.t.
the Derivative is represented by a GtransfoLin, in which (hopefully), the offset terms are zero.
position.
Step is used for numerical derivation.
Derivative should transform a vector of offsets into a vector of offsets.
Reimplemented in lsst::jointcal::GtransfoLin, lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
Definition at line 75 of file Gtransfo.cc.
|
pure virtual |
dumps the transfo coefficients to stream.
Implemented in lsst::jointcal::UserTransfo, lsst::jointcal::TanRaDec2Pix, lsst::jointcal::TanSipPix2RaDec, lsst::jointcal::TanPix2RaDec, lsst::jointcal::GtransfoComposition, lsst::jointcal::GtransfoInverse, lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
|
pure virtual |
fits a transfo to a std::list of Point pairs (p1,p2, the Point fields in StarMatch).
After the fit this(p1) yields approximately p2. The returned value is the sum of squared residuals. If you want to fit a partial transfo (e.g. such that this(T1(p1)) = T2(p2), use StarMatchList::applyTransfo beforehand.
Implemented in lsst::jointcal::UserTransfo, lsst::jointcal::TanRaDec2Pix, lsst::jointcal::TanSipPix2RaDec, lsst::jointcal::TanPix2RaDec, lsst::jointcal::GtransfoLinRot, lsst::jointcal::GtransfoLinShift, lsst::jointcal::GtransfoComposition, lsst::jointcal::GtransfoInverse, lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
|
inlinevirtual |
returns the local jacobian.
Definition at line 75 of file Gtransfo.h.
|
virtual |
returns the local jacobian.
Definition at line 56 of file Gtransfo.cc.
|
inlinevirtual |
returns the number of parameters (to compute chi2's)
Reimplemented in lsst::jointcal::GtransfoLinScale, lsst::jointcal::GtransfoLinRot, lsst::jointcal::GtransfoLinShift, lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
Definition at line 130 of file Gtransfo.h.
void lsst::jointcal::Gtransfo::getParams | ( | double * | params | ) | const |
params should be at least Npar() long
Definition at line 169 of file Gtransfo.cc.
|
virtual |
returns an inverse transfo. Numerical if not overloaded.
precision and region refer to the "input" side of this, and hence to the output side of the returned Gtransfo.
Reimplemented in lsst::jointcal::TanRaDec2Pix, lsst::jointcal::TanSipPix2RaDec, lsst::jointcal::TanPix2RaDec, lsst::jointcal::GtransfoLin, and lsst::jointcal::GtransfoInverse.
Definition at line 251 of file Gtransfo.cc.
|
virtual |
linear (local) approximation.
Reimplemented in lsst::jointcal::GtransfoLin, and lsst::jointcal::GtransfoIdentity.
Definition at line 92 of file Gtransfo.cc.
void lsst::jointcal::Gtransfo::offsetParams | ( | Eigen::VectorXd const & | delta | ) |
Definition at line 174 of file Gtransfo.cc.
|
virtual |
Derivative w.r.t parameters.
Derivatives should be al least 2*NPar long. first Npar, for x, last Npar for y.
Reimplemented in lsst::jointcal::GtransfoPoly.
Definition at line 188 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly.
Definition at line 179 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly.
Definition at line 184 of file Gtransfo.cc.
|
virtual |
to be overloaded by derived classes if they can really "reduce" the composition (e.g.
composition of Polynomial can be reduced)
Reimplemented in lsst::jointcal::TanPix2RaDec, lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
Definition at line 52 of file Gtransfo.cc.
|
virtual |
Rough inverse.
Stored by the numerical inverter to guess starting point for the trials. Just here to enable overloading.
Reimplemented in lsst::jointcal::TanRaDec2Pix, lsst::jointcal::TanPix2RaDec, and lsst::jointcal::GtransfoInverse.
Definition at line 149 of file Gtransfo.cc.
|
virtual |
transform errors (represented as double[3] in order V(xx),V(yy),Cov(xy))
Definition at line 116 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::TanRaDec2Pix, and lsst::jointcal::GtransfoPoly.
Definition at line 99 of file Gtransfo.cc.
|
inline |
allows to write MyTransfo(MyStar)
Definition at line 72 of file Gtransfo.h.
void lsst::jointcal::Gtransfo::write | ( | const std::string & | fileName | ) | const |
Definition at line 198 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
Definition at line 208 of file Gtransfo.cc.