lsst.jointcal  14.0-20-g39ceace+1
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 
62  MinimizeResult minimize(std::string const &whatToFit, double nSigmaCut = 0);
63 
67  Chi2Statistic computeChi2() const;
68 
78  void leastSquareDerivatives(TripletList &tripletList, Eigen::VectorXd &grad) const;
79 
88  virtual void offsetParams(Eigen::VectorXd const &delta) = 0;
89 
95  virtual void assignIndices(std::string const &whatToFit) = 0;
96 
105  virtual void saveChi2Contributions(std::string const &baseName) const;
106 
108  virtual void saveChi2MeasContributions(std::string const &baseName) const = 0;
109 
111  virtual void saveChi2RefContributions(std::string const &baseName) const = 0;
112 
113 protected:
116 
117  int _lastNTrip; // last triplet count, used to speed up allocation
118  unsigned int _nParTot;
119  unsigned _nMeasuredStars;
120 
121  // lsst.logging instance, to be created by subclass so that messages have consistent name while fitting.
122  LOG_LOGGER _log;
123 
140  unsigned findOutliers(double nSigmaCut, MeasuredStarList &msOutliers, FittedStarList &fsOutliers) const;
141 
146  void outliersContributions(MeasuredStarList &msOutliers, FittedStarList &fsOutliers,
147  TripletList &tripletList, Eigen::VectorXd &grad);
148 
150  void removeMeasOutliers(MeasuredStarList &outliers);
151 
153  void removeRefOutliers(FittedStarList &outliers);
154 
156  virtual void getIndicesOfMeasuredStar(MeasuredStar const &measuredStar,
157  std::vector<unsigned> &indices) const = 0;
158 
160  virtual void accumulateStatImageList(CcdImageList const &ccdImageList, Chi2Accumulator &accum) const = 0;
161 
163  virtual void accumulateStatRefStars(Chi2Accumulator &accum) const = 0;
164 
170  virtual void leastSquareDerivativesMeasurement(
171  CcdImage const &ccdImage, TripletList &tripletList, Eigen::VectorXd &grad,
172  MeasuredStarList const *measuredStarList = nullptr) const = 0;
173 
175  virtual void leastSquareDerivativesReference(FittedStarList const &fittedStarList,
176  TripletList &tripletList, Eigen::VectorXd &grad) const = 0;
177 };
178 } // namespace jointcal
179 } // namespace lsst
180 #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::AddImage.
Definition: MeasuredStar.h:111
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:18
std::shared_ptr< Associations > _associations
Definition: FitterBase.h:114
Handler of an actual image from a single CCD.
Definition: CcdImage.h:35