lsst.jointcal
14.0-26-gc4bc114+6
|
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 41 of file Gtransfo.h.
|
inlinevirtual |
Definition at line 138 of file Gtransfo.h.
|
inline |
Definition at line 60 of file Gtransfo.h.
|
pure virtual |
applies the tranfo to in and writes into out. Is indeed virtual.
Definition at line 47 of file Gtransfo.h.
All these apply(..) shadow the virtual one in derived classes, unless one writes "using Gtransfo::apply".
Definition at line 51 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::GtransfoSkyWcs, 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 76 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::GtransfoSkyWcs, 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::GtransfoSkyWcs, 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 77 of file Gtransfo.h.
|
virtual |
returns the local jacobian.
Definition at line 57 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 132 of file Gtransfo.h.
void lsst::jointcal::Gtransfo::getParams | ( | double * | params | ) | const |
params should be at least Npar() long
Definition at line 170 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 252 of file Gtransfo.cc.
|
virtual |
linear (local) approximation.
Reimplemented in lsst::jointcal::GtransfoLin, and lsst::jointcal::GtransfoIdentity.
Definition at line 93 of file Gtransfo.cc.
void lsst::jointcal::Gtransfo::offsetParams | ( | Eigen::VectorXd const & | delta | ) |
Definition at line 175 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 189 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly.
Definition at line 180 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly.
Definition at line 185 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 53 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 150 of file Gtransfo.cc.
|
virtual |
transform errors (represented as double[3] in order V(xx),V(yy),Cov(xy))
Definition at line 117 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::TanRaDec2Pix, and lsst::jointcal::GtransfoPoly.
Definition at line 100 of file Gtransfo.cc.
|
inline |
allows to write MyTransfo(MyStar)
Definition at line 74 of file Gtransfo.h.
void lsst::jointcal::Gtransfo::write | ( | const std::string & | fileName | ) | const |
Definition at line 199 of file Gtransfo.cc.
|
virtual |
Reimplemented in lsst::jointcal::GtransfoPoly, and lsst::jointcal::GtransfoIdentity.
Definition at line 209 of file Gtransfo.cc.