Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
MnStrategy.h
Go to the documentation of this file.
1 // @(#)root/minuit2:$Id$
2 // Authors: M. Winkler, F. James, L. Moneta, A. Zsenei 2003-2005
3 
4 /**********************************************************************
5  * *
6  * Copyright (c) 2005 LCG ROOT Math team, CERN/PH-SFT *
7  * *
8  **********************************************************************/
9 
10 #ifndef ROOT_Minuit2_MnStrategy
11 #define ROOT_Minuit2_MnStrategy
12 
13 namespace ROOT {
14 
15  namespace Minuit2 {
16 
17 //_________________________________________________________________________
18 /**
19  API class for defining three levels of strategies: low (0), medium (1),
20  high (>=2);
21  acts on: Migrad (behavioural),
22  Minos (lowers strategy by 1 for Minos-own minimization),
23  Hesse (iterations),
24  Numerical2PDerivative (iterations)
25  */
26 
27 class MnStrategy {
28 
29 public:
30 
31  //default strategy
32  MnStrategy();
33 
34  //user defined strategy (0, 1, >=2)
35  explicit MnStrategy(unsigned int);
36 
37  ~MnStrategy() {}
38 
39  unsigned int Strategy() const {return fStrategy;}
40 
41  unsigned int GradientNCycles() const {return fGradNCyc;}
42  double GradientStepTolerance() const {return fGradTlrStp;}
43  double GradientTolerance() const {return fGradTlr;}
44 
45  unsigned int HessianNCycles() const {return fHessNCyc;}
46  double HessianStepTolerance() const {return fHessTlrStp;}
47  double HessianG2Tolerance() const {return fHessTlrG2;}
48  unsigned int HessianGradientNCycles() const {return fHessGradNCyc;}
49 
50  int StorageLevel() const { return fStoreLevel; }
51 
52  bool IsLow() const {return fStrategy == 0;}
53  bool IsMedium() const {return fStrategy == 1;}
54  bool IsHigh() const {return fStrategy >= 2;}
55 
56  void SetLowStrategy();
57  void SetMediumStrategy();
58  void SetHighStrategy();
59 
60  void SetGradientNCycles(unsigned int n) {fGradNCyc = n;}
61  void SetGradientStepTolerance(double stp) {fGradTlrStp = stp;}
62  void SetGradientTolerance(double toler) {fGradTlr = toler;}
63 
64  void SetHessianNCycles(unsigned int n) {fHessNCyc = n;}
65  void SetHessianStepTolerance(double stp) {fHessTlrStp = stp;}
66  void SetHessianG2Tolerance(double toler) {fHessTlrG2 = toler;}
67  void SetHessianGradientNCycles(unsigned int n) {fHessGradNCyc = n;}
68 
69  // set storage level of iteration quantities
70  // 0 = store only last iterations 1 = full storage (default)
71  void SetStorageLevel(unsigned int level) { fStoreLevel = level; }
72 private:
73 
74  unsigned int fStrategy;
75 
76  unsigned int fGradNCyc;
77  double fGradTlrStp;
78  double fGradTlr;
79  unsigned int fHessNCyc;
80  double fHessTlrStp;
81  double fHessTlrG2;
82  unsigned int fHessGradNCyc;
83  int fStoreLevel;
84 };
85 
86  } // namespace Minuit2
87 
88 } // namespace ROOT
89 
90 #endif // ROOT_Minuit2_MnStrategy