lsst.jointcal  15.0-17-g076ea75+3
FitterBase.h
Go to the documentation of this file.
1 // -*- LSST-C++ -*-
2 #ifndef LSST_JOINTCAL_FITTER_BASE_H
3 #define LSST_JOINTCAL_FITTER_BASE_H
4 
5 #include "lsst/log/Log.h"
8 #include "lsst/jointcal/Chi2.h"
12 
13 namespace lsst {
14 namespace jointcal {
15 
17 enum class MinimizeResult {
18  Converged, // fit has converged - no more outliers
19  Chi2Increased, // still some ouliers but chi2 increases
20  Failed // factorization failed
21 };
22 
29 class FitterBase {
30 public:
32  : _associations(associations), _whatToFit(""), _lastNTrip(0), _nParTot(0), _nMeasuredStars(0) {}
33 
35  FitterBase(FitterBase const &) = delete;
36  FitterBase(FitterBase &&) = delete;
37  FitterBase &operator=(FitterBase const &) = delete;
38  FitterBase &operator=(FitterBase &&) = delete;
39 
76  MinimizeResult minimize(std::string const &whatToFit, double const nSigmaCut = 0,
77  bool const doRankUpdate = true, std::string const &dumpMatrixFile = "");
78 
82  Chi2Statistic computeChi2() const;
83 
93  void leastSquareDerivatives(TripletList &tripletList, Eigen::VectorXd &grad) const;
94 
103  virtual void offsetParams(Eigen::VectorXd const &delta) = 0;
104 
110  virtual void assignIndices(std::string const &whatToFit) = 0;
111 
120  virtual void saveChi2Contributions(std::string const &baseName) const;
121 
123  virtual void saveChi2MeasContributions(std::string const &baseName) const = 0;
124 
126  virtual void saveChi2RefContributions(std::string const &baseName) const = 0;
127 
128 protected:
131 
132  int _lastNTrip; // last triplet count, used to speed up allocation
133  unsigned int _nParTot;
134  unsigned _nMeasuredStars;
135 
136  // lsst.logging instance, to be created by subclass so that messages have consistent name while fitting.
137  LOG_LOGGER _log;
138 
155  unsigned findOutliers(double nSigmaCut, MeasuredStarList &msOutliers, FittedStarList &fsOutliers) const;
156 
161  void outliersContributions(MeasuredStarList &msOutliers, FittedStarList &fsOutliers,
162  TripletList &tripletList, Eigen::VectorXd &grad);
163 
165  void removeMeasOutliers(MeasuredStarList &outliers);
166 
168  void removeRefOutliers(FittedStarList &outliers);
169 
171  virtual void getIndicesOfMeasuredStar(MeasuredStar const &measuredStar,
172  std::vector<unsigned> &indices) const = 0;
173 
175  virtual void accumulateStatImageList(CcdImageList const &ccdImageList, Chi2Accumulator &accum) const = 0;
176 
178  virtual void accumulateStatRefStars(Chi2Accumulator &accum) const = 0;
179 
185  virtual void leastSquareDerivativesMeasurement(
186  CcdImage const &ccdImage, TripletList &tripletList, Eigen::VectorXd &grad,
187  MeasuredStarList const *measuredStarList = nullptr) const = 0;
188 
190  virtual void leastSquareDerivativesReference(FittedStarList const &fittedStarList,
191  TripletList &tripletList, Eigen::VectorXd &grad) const = 0;
192 };
193 } // namespace jointcal
194 } // namespace lsst
195 #endif // LSST_JOINTCAL_FITTER_BASE_H
Simple structure to accumulate chi2 and ndof.
Definition: Chi2.h:29
Base class for fitters.
Definition: FitterBase.h:29
Base class for Chi2Statistic and Chi2List, to allow addEntry inside Fitter for either class...
Definition: Chi2.h:21
FitResults minimize(lsst::afw::math::Function1< ReturnT > const &function, std::vector< double > const &initialParameterList, std::vector< double > const &stepSizeList, std::vector< double > const &measurementList, std::vector< double > const &varianceList, std::vector< double > const &xPositionList, double errorDef)
A list of MeasuredStar. They are usually filled in Associations::createCcdImage.
Definition: MeasuredStar.h:113
MinimizeResult
Return value of minimize()
Definition: FitterBase.h:17
FitterBase(std::shared_ptr< Associations > associations)
Definition: FitterBase.h:31
STL class.
Class for a simple mapping implementing a generic Gtransfo.
double computeChi2(const StarMatchList &L, const Gtransfo &gtransfo)
the actual chi2
Definition: StarMatch.cc:219
A list of FittedStar s. Such a list is typically constructed by Associations.
Definition: FittedStar.h:121
objects measured on actual images.
Definition: MeasuredStar.h:19
std::shared_ptr< Associations > _associations
Definition: FitterBase.h:129
Handler of an actual image from a single CCD.
Definition: CcdImage.h:35