lsst.jointcal  16.0-3-g21cc1d5+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 
81  MinimizeResult minimize(std::string const &whatToFit, double const nSigmaCut = 0,
82  bool const doRankUpdate = true, bool const doLineSearch = false,
83  std::string const &dumpMatrixFile = "");
84 
88  Chi2Statistic computeChi2() const;
89 
99  void leastSquareDerivatives(TripletList &tripletList, Eigen::VectorXd &grad) const;
100 
109  virtual void offsetParams(Eigen::VectorXd const &delta) = 0;
110 
116  virtual void assignIndices(std::string const &whatToFit) = 0;
117 
126  virtual void saveChi2Contributions(std::string const &baseName) const;
127 
129  virtual void saveChi2MeasContributions(std::string const &baseName) const = 0;
130 
132  virtual void saveChi2RefContributions(std::string const &baseName) const = 0;
133 
134 protected:
137 
138  int _lastNTrip; // last triplet count, used to speed up allocation
139  unsigned int _nParTot;
140  unsigned _nMeasuredStars;
141 
142  // lsst.logging instance, to be created by subclass so that messages have consistent name while fitting.
143  LOG_LOGGER _log;
144 
161  unsigned findOutliers(double nSigmaCut, MeasuredStarList &msOutliers, FittedStarList &fsOutliers) const;
162 
167  void outliersContributions(MeasuredStarList &msOutliers, FittedStarList &fsOutliers,
168  TripletList &tripletList, Eigen::VectorXd &grad);
169 
171  void removeMeasOutliers(MeasuredStarList &outliers);
172 
174  void removeRefOutliers(FittedStarList &outliers);
175 
177  virtual void getIndicesOfMeasuredStar(MeasuredStar const &measuredStar,
178  std::vector<unsigned> &indices) const = 0;
179 
181  virtual void accumulateStatImageList(CcdImageList const &ccdImageList, Chi2Accumulator &accum) const = 0;
182 
184  virtual void accumulateStatRefStars(Chi2Accumulator &accum) const = 0;
185 
191  virtual void leastSquareDerivativesMeasurement(
192  CcdImage const &ccdImage, TripletList &tripletList, Eigen::VectorXd &grad,
193  MeasuredStarList const *measuredStarList = nullptr) const = 0;
194 
196  virtual void leastSquareDerivativesReference(FittedStarList const &fittedStarList,
197  TripletList &tripletList, Eigen::VectorXd &grad) const = 0;
198 
199 private:
210  double _lineSearch(Eigen::VectorXd const &delta);
211 };
212 } // namespace jointcal
213 } // namespace lsst
214 #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:135
Handler of an actual image from a single CCD.
Definition: CcdImage.h:41